Journalisation et traçage avec pureQuery Runtime

Utilisée avec des applications CLI ou .NET, l'optimisation client pureQuery offre des mécanismes permettant d'effectuer la consignation des enregistrements et le traçage des fichiers avec des niveaux de gravité configurables.

Avant de commencer

Pour d'utiliser les fonctions pureQuery, vous devez activer pureQuery Runtime pour IBM® Data Server CLI Driver version 9.7 Fix pack 3 ou version ultérieure, avec IBM Optim pureQuery Runtime 2.1 ou version ultérieure.

Pourquoi et quand exécuter cette tâche

L'optimisation client pureQuery fournit des fonctionnalités de consignation et de traçage avec une gravité configurable. La consignation et le traçage peuvent fournir les informations nécessaires sur chaque niveau afin de prendre en charge la détermination des incidents lors de l'exécution. La tâche explique comment définir les propriétés d'exécution des fonctionnalités de traçage et de consignation de pureQuery Runtime.

Vous pouvez définir les deux mots-clés suivants dans le fichier de configuration db2cli.ini ou dsdriver.cfg :
traceFile
Définit le fichier dans lequel les informations de consignation sont écrites. Vous pouvez utiliser un chemin d'accès absolu ou un chemin d'accès relatif vers le répertoire dans lequel s'exécutent les applications CLI ou .NET. Si le fichier existe, de nouveaux messages de journal sont ajoutés au contenu existant du fichier.
traceLevel
Spécifie le niveau de détail à écrire dans le fichier journal. Les niveaux sont les suivants, du moins détaillé au plus détaillé :
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL
Le niveau par défaut est OFF.
Les mots-clés peuvent être spécifiés en tant que propriété de connexion d'application, dans le fichier db2cli.ini ou dans un fichier dsdriver.cfg. Si un mot-clé est spécifié dans plusieurs endroits, l'ordre de priorité du plus haut au plus bas est le suivant :
  • Propriété de connexion d'application
  • Fichier db2cli.ini
  • Fichier dsdriver.cfg

Exemple

Les lignes suivantes définissent traceFile par /user/CLIOPTtraces.log et traceLevel par INFO dans le fichier db2cli.ini :

traceFile=/user/CLIOPTtraces.log
traceLevel=INFO
Si vous utilisez un fichier db2dsdriver.cfg, une autre solution consiste à définir les mots-clés en tant qu'attributs dans les éléments des paramètres :
<parameter name="traceFile" value="/user/CLIOPTtraces.log" />
<parameter name="traceLevel" value="INFO" />

Commentaires