● 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 log_info ou log_information
AVERTISSEMENT
ERROR
FATAL
NONE log_warn ou log_warning 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. La gravité du journal par défaut est ERROR.
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
157
Table 10 : Niveau de traçage SAP
Gravité
DEBUG
PATH
INFO
ERROR
NONE
Valeurs de configuration trace_debug trace_path trace_info ou trace_information 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 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.
keep_num log_dir 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.
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.
log_level scope_only 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.
true ou false
Spécifie si seuls les messages avec périmètres appa raissent dans les fichiers journaux. La valeur par dé faut est false.
158
©
2014 SAP AG 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
Option size
Valeurs Description
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 log_error log_warn trace_info trace_path high log_info 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";
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
159
