Traces
● 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.
Les tableaux suivants décrivent les valeurs de configuration acceptées par les balises sap_log_level et sap_trace_level.
Table 9 : Niveau de journalisation SAP
Gravité Valeurs de configuration
INFO
AVERTISSEMENT log_info ou log_information log_warn ou log_warning log_error ERROR
FATAL
NONE log_fatal log_none
162
©
2014 SAP SE ou société affiliée SAP. Tous droits réservés.
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
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. La gravité du journal par défaut est ERROR.
Table 10 : Niveau de traçage SAP
Gravité Valeurs de configuration
DEBUG trace_debug
PATH
INFO trace_path trace_info ou trace_information
ERROR
NONE trace_error 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é de traçage sur INFO, tous les messages possédant un niveau de type INFO et ERROR sont journalisés. La gravité de traçage par défaut est ERROR.
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 va leur par défaut est false.
append keep_num true ou false
Ajoute les informations du journal aux fichiers jour naux 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 signi fie que tous les fichiers journaux sont conservés.
log_dir log_level une chaîne 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 infor mations du journal sont dirigées vers stdout.
none, low, medium ou high
Définit un raccourci pour spécifier les valeurs sap_log_level et sap_trace_level. Reportezvous au tableau suivant.
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
©
2014 SAP SE ou société affiliée SAP. Tous droits réservés.
163
Option scope_only size
Valeurs true ou false
Description
Spécifie si seuls les messages avec périmètres appa raissent 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.
Valeur log_level Valeur sap_log_level Valeur sap_trace_level aucun log_error trace_error low medium high log_error log_warn log_info trace_info trace_path trace_debug
Erreurs d'analyse
Les erreurs et avertissements qui peuvent survenir lors de l'analyse du fichier _trace.ini sont journalisés dans un fichier ERR, situé dans le même répertoire que le fichier INI. Le nom du fichier d'erreurs porte le nom du fichier
INI.
Si le même fichier INI est partagé par plusieurs processus, il est impossible de déterminer quel processus génère l'erreur. Pour générer des noms de fichier d'erreur plus explicites, ajoutez les lignes suivantes en haut du fichier
_trace.ini : error_file = config_file + "_" + process + ".err"; output_file = config_file + "_" + process + ".out";
164
©
2014 SAP SE ou société affiliée SAP. Tous droits réservés.
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
