Configuration des paramètres globaux d'accès aux données
SAP fait la distinction entre deux types de messages :
• Un message de trace analyse le système en détail du point de vue d'un développeur en tant que procédure exceptionnelle.
• Un message de journal est un enregistrement permanent des événements et du statut d'un système.
Les messages de journaux et de traces sont respectivement destinés aux administrateurs et aux développeurs. Vous pouvez activer des journaux et des traces pour toutes les connectivités prises en charge par la couche d'accès aux données (exemple : ODBC, JDBC, Javabean, OLE DB, OCI et JCo).
Le processus de journalisation et de suivi du serveur de connexion s'appuie sur le service de journalisation et de suivi du journal de suivi SAP BusinessObjects. Il permet de journaliser et de suivre les processus suivants :
Historiques
Traces
• Démarrage et arrêt des instances du serveur de connexion
• Initialisation de la connexion unique
• Chargement du pilote
• Configuration et initialisation du serveur de connexion
• Création et exécution des travaux et du dictionnaire
• Chargement et activité du pilote
• Démarrage et arrêt des instances du serveur de connexion
• Initialisation et activité des services des instances du serveur de connexion
• Initialisation de la connexion unique
9.9.1 A propos du fichier de configuration
_trace.ini
Les niveaux de journalisation et de suivi sont définis dans le fichier de configuration _trace.ini. Par exemple, vous pouvez définir les informations suivantes dans le fichier BO_trace.ini : sap_log_level = log_info; sap_trace_level = trace_debug; if
(process == "cms")
{ log_level = error; // but only log errors for the CMS
}
Contenu du fichier
Dans l'exemple ci-dessus, les balises définies sont les suivantes :
• sap_log_level
, qui définit le niveau de journalisation
• sap_trace_level
, qui définit le niveau de suivi
• Une partie de code pour spécifier le niveau de journalisation ou de suivi d'un processus. Il s'agit d'un code C ou Java qui peut contenir des expressions, des instructions simples et des instructions if-else.
162 2013-11-22
Configuration des paramètres globaux d'accès aux données
163
Les tableaux suivants décrivent les valeurs de configuration acceptées par les balises sap_log_level et sap_trace_level.
Tableau 9-14 : Niveau de journalisation SAP
Gravité
INFO
Valeurs de configuration
log_info ou log_information
AVERTISSEMENT log_warn ou log_warning
ERROR
FATAL
AUCUNE log_error log_fatal log_none
Tous les messages du niveau de gravité défini et de niveau supérieur apparaissent dans le fichier journal. Par exemple, si vous définissez la gravité du journal sur WARNING, tous les messages possédant un niveau de type WARNING, ERROR et FATAL sont journalisés. Le niveau de gravité par défaut est ERROR.
Tableau 9-15 : Niveau de traçage SAP
Gravité Valeurs de configuration
DEBUG trace_debug
PATH trace_path trace_info ou trace_information INFO
ERROR trace_error
AUCUNE trace_none
Tous les messages du niveau de gravité défini et de niveau supérieur apparaissent dans le fichier journal. Par exemple, si vous définissez la gravité du traçage sur INFO, tous les messages de niveau
INFO et ERROR sont journalisés. Le niveau de gravité de traçage par défaut est ERROR.
2013-11-22
Configuration des paramètres globaux d'accès aux données
164
Options de configuration
Il est également possible d'ajouter les options suivantes au fichier :
Option Valeurs Description
always_close true ou false
Ferme le fichier journal après chaque écriture.
La valeur par défaut est false.
append keep_num log_dir log_level scope_only size true false ou une chaîne
Ajoute les informations du journal aux fichiers journaux existants. Modifie le modèle d'attribution de nom pour exclure le PID et l'horodatage, et utilise à la place un nombre de fichiers journaux variable. La valeur par défaut est false.
un nombre entier
Spécifie le nombre de fichiers journaux à conserver. La valeur par défaut est 0. Un nombre entier négatif signifie que tous les fichiers journaux sont conservés.
Spécifie le répertoire du fichier journal. La valeur par défaut est la valeur de la variable d'environnement BO_TRACE_LOGDIR. Un tiret (-) signifie que les informations du journal sont dirigées vers stdout
.
none
, low, me dium ou high
Définit un raccourci pour spécifier les valeurs sap_log_level et sap_trace_level. Reportez-vous au tableau suivant.
true false ou
Spécifie si seuls les messages avec périmètres apparaissent dans les fichiers journaux. La valeur par défaut est false.
Remarque :
Un périmètre marque l'entrée et la sortie d'un bloc de code.
un nombre en
Ko
Taille maximale d'un fichier journal. La valeur par défaut est 10000.
Valeurs d'option log_level
Le tableau suivant fournit l'ensemble des valeurs sap_log_level et sap_trace_level lorsque la valeur log_level correspondante est définie dans le fichier de configuration.
2013-11-22
