Collecte des traces pour les Data Gate procédures stockées sur Db2 for z/OS

Pour les procédures Data Gate stockées sur Db2 for z/OS, le traçage de niveau ERROR est activé par défaut. Cela signifie que le traçage de niveau ERREUR est également activé pour les Data Gate procédures stockées. Il peut arriver que vous souhaitiez capturer des informations de trace plus ou moins détaillées concernant des événements spécifiques. Suivez les étapes indiquées ici pour modifier le niveau de trace et collecter les informations de trace des procédures stockées selon vos besoins.

Procédure

Identifiez l'identifiant Data Gate d'instance et attribuez la valeur à la variable DG_INSTANCE_ID en exécutant la oc get dginstance commande. Par exemple :
```
oc get dginstance -n ${PROJECT_CPD_INST_OPERANDS}
NAME                 VERSION   BUILD      STATUS      RECONCILED   AGE
dg1699914520773847   5.0.0     5.0.0.82   Completed   5.0.0        6h58m
```
Dans cet exemple, l'ID d'instance est dg1699914520773847. Définissez la variable DG_INSTANCE_ID sur cet ID d'instance.

Identifiez le pod Data Gate d'instance et attribuez la valeur à la variable DG_POD en exécutant la commande oc get pod suivante :

DG_POD=$(oc get pod -n ${PROJECT_CPD_INST_OPERANDS} -l icpdsupport/app=dg-instance-server,\
icpdsupport/serviceInstanceId=`echo ${DG_INSTANCE_ID} | sed 's/^dg//'` -o jsonpath='{.items[0].metadata.name}')

Accédez au conteneur data-gate-api du Data Gate pod sur Cloud Pak for Data:

oc exec -it ${DG_POD} -n ${PROJECT_CPD_INST_OPERANDS} -c data-gate-api -- bash

Vérifiez le /head/clone-api/sp-trace-profile.properties fichier pour un profil de trace existant.
Dans l'exemple suivant, le nom du profil de trace est SPDEBUG. Comme vous pouvez le constater, le profil a été configuré de manière à collecter des informations de trace supplémentaires. Pour être plus précis, le suivi du niveau d'information est activé pour les composants DRDA, SERVICES, PROFILING, CONVERTER et NETWORK. Le traçage au niveau débogage est activé pour la base de Db2 données de communication (COMMUNICATION) et les procédures stockées (PROCEDURE).
```
SPDEBUG=\
<?xml version\="1.0" encoding\="UTF-8"?>\r\n\
<dwa\:spTraceConfigType xmlns\:dwa\="http\://www.ibm.com/xmlns/prod/dwa/2011" traceFileSizeInMB\="300">\r\n\
  <component level\="INFO" name\="DRDA"/>\r\n\
  <component level\="INFO" name\="SERVICES"/>\r\n\
  <component level\="INFO" name\="PROFILING"/>\r\n\
  <component level\="INFO" name\="CONVERTER"/>\r\n\
  <component level\="INFO" name\="NETWORK"/>\r\n\
  <component level\="DEBUG" name\="COMMUNICATION"/>\r\n\
  <component level\="DEBUG" name\="PROCEDURE"/>\r\n\
</dwa\:spTraceConfigType>\r\n
```
Si les niveaux de trace dans le profil ne répondent pas à vos besoins, vous pouvez modifier le profil existant ou spécifier un autre profil qui inclut les paramètres requis. Contactez IBM le service d'assistance et demandez les niveaux de trace les plus adaptés à votre situation spécifique.
Notez le traceFileSizeInMB paramètre. Il spécifie la taille maximale d'un fichier de trace unique en Mo. Lorsque cette limite est atteinte, les informations les plus anciennes du fichier sont remplacées par les informations les plus récentes. Autrement dit, le traçage ne s'arrête pas lorsque la limite est atteinte. Procédez comme suit :
1. Ouvrez le fichier /head/clone-api/application-prod.properties pour le modifier.
2. Vérifiez la valeur de db2z.stored.procedure.trace.profile.name. La valeur doit être égale au profil de trace de procédure stockée sélectionné dans le sp-trace-profile.properties fichier (SPDEBUG dans l'exemple précédent).
```
db2z.stored.procedure.trace.profile.name=SPDEBUG
```
3. Enregistrez vos modifications.
  Les modifications sont automatiquement prises en compte. Ils deviennent actifs après quelques secondes. Aucune action de votre part n'est requise.
Si vous avez modifié le niveau de trace afin de capturer des informations sur un problème actuel, reproduisez le problème afin que les informations associées soient écrites dans le fichier de trace.
Pour vérifier les informations de trace ou les fournir au IBM support technique, accédez au fichier de trace.
Le fichier de trace est stocké dans le /head/clone-api/log/DGSPTrace dossier du conteneur data-gate-api. Vous pouvez le copier directement à partir de là ou suivre les étapes décrites dans la section Collecte d'informations de diagnostic. Au fur et à mesure que vous effectuez les étapes :
1. Veillez à cocher la Data Gate case.
2. En fonction du service de base de données cible, sélectionnez Db2 également ou Db2 Warehouse si le problème semble être lié à la base de données cible.
3. Si vous exécutez plusieurs Data Gate instances dans le même système et que vous souhaitez fournir les informations de trace au IBM support technique, indiquez également l'ID de l'instance. Vous pouvez également inclure un lien Web vers le Data Gate tableau de bord de l'instance, car ce lien contient l'ID de l'instance.
  Remarque : les fichiers de trace de procédure stockée les plus anciens sont supprimés lorsque le nombre maximal autorisé de fichiers de trace de procédure stockée est sur le point d'être dépassé. De même, les entrées plus anciennes dans les fichiers de trace sont écrasées lorsque la taille maximale de tous les fichiers de trace des procédures stockées est atteinte. Veillez donc à accéder aux fichiers de trace peu après que les informations relatives à l'événement concerné aient été écrites dans ces fichiers.