Configuration des paramètres globaux d'accès aux données
Pour définir les protocoles d'accès CORBA, vous devez utiliser la CMC de votre installation de la plateforme de BI. Les protocoles définissent des valeurs que le serveur de connexion utilise pour traiter les requêtes émanant de clients CORBA ou de clients HTTP.
Pour en savoir plus sur la CMC, voir le Guide d'administration de la plateforme SAP BusinessObjects
Business Intelligence.
9.10 Activation des journaux et des traces des pilotes et du serveur de connexion
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.10.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;
154 2013-06-29
Configuration des paramètres globaux d'accès aux données 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
.
Tableau 9-14 : Niveau de journalisation SAP
Gravité
INFO
Valeurs de configuration
log_info ou log_information log_warn ou log_warning
AVERTISSEMENT
ERROR log_error
FATAL
AUCUNE 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
155 2013-06-29
Configuration des paramètres globaux d'accès aux données
Gravité
INFO
ERROR
AUCUNE
Valeurs de configuration
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é 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.
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 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.
156 2013-06-29
Configuration des paramètres globaux d'accès aux données
Option
scope_only size
Valeurs
true false ou
Description
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.
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 le 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";
157 2013-06-29
