Coleta de rastreamentos para procedimentos Data Gate armazenados em Db2 for z/OS

Para procedimentos Data Gate armazenados no Db2 for z/OS, o rastreamento de nível ERROR é ativado por padrão. Isso significa que o rastreamento de nível ERROR também está habilitado para os procedimentos Data Gate armazenados. Pode haver situações em que você deseje capturar informações de rastreamento mais ou menos extensas sobre eventos específicos. Siga as etapas aqui para alterar o nível de rastreamento e coletar informações de rastreamento de procedimentos armazenados, conforme necessário.

Procedimento

Identifique o Data Gate identificador da instância e atribua o valor à variável DG_INSTANCE_ID emitindo o oc get dginstance comando. Por exemplo:
```
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
```
Neste exemplo, o ID da instância é dg1699914520773847. Defina a variável DG_INSTANCE_ID para este ID de instância.

Identifique o pod Data Gate da instância e atribua o valor à variável DG_POD executando o seguinte oc get pod comando:

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}')

Vá para o contêiner data-gate-api do Data Gate pod em Cloud Pak for Data:

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

Verifique o /head/clone-api/sp-trace-profile.properties arquivo para um perfil de rastreamento existente.
No exemplo a seguir, o nome do perfil de rastreamento é SPDEBUG. Como você pode ver, o perfil foi configurado para que informações de rastreamento adicionais sejam coletadas. Para ser mais preciso, o rastreamento do nível de informação está ativado para os componentes DRDA, SERVIÇOS, PERFILAGEM, CONVERSOR e REDE. O rastreamento do nível de depuração está habilitado para o banco de Db2 dados de comunicações (COMMUNICATION) e os procedimentos armazenados (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
```
Se os níveis de rastreamento no perfil não atenderem aos seus requisitos, você pode modificar o perfil existente ou especificar um perfil diferente que inclua as configurações necessárias. Entre em contato com IBM o suporte e solicite os níveis de rastreamento mais adequados para sua situação específica.
Observe o traceFileSizeInMB parâmetro. Especifica o tamanho máximo de um único arquivo de rastreamento em MB. Quando esse limite é atingido, as informações mais antigas do arquivo são substituídas pelas mais recentes. Ou seja, o traçado não para quando o limite é atingido. Conclua as seguintes etapas:
1. Abra o arquivo /head/clone-api/application-prod.properties para editá-lo.
2. Verifique o valor de db2z.stored.procedure.trace.profile.name. O valor deve ser igual ao perfil de rastreamento do procedimento armazenado selecionado no sp-trace-profile.properties arquivo (SPDEBUG no exemplo anterior).
```
db2z.stored.procedure.trace.profile.name=SPDEBUG
```
3. Salve as mudanças.
  As alterações são captadas automaticamente. Eles ficam ativos após alguns segundos. Não é necessária nenhuma ação da sua parte.
Se você alterou o nível de rastreamento para capturar informações sobre um problema atual, reproduza o problema para que as informações relacionadas sejam gravadas no arquivo de rastreamento.
Para verificar as informações de rastreamento ou fornecê-las ao IBM suporte, acesse o arquivo de rastreamento.
O arquivo de rastreamento é armazenado na /head/clone-api/log/DGSPTrace pasta do contêiner data-gate-api. Você pode copiá-lo diretamente de lá ou seguir as etapas em Coleta de informações de diagnóstico. À medida que você conclui as etapas:
1. Certifique-se de marcar a Data Gate caixa de seleção.
2. Dependendo do serviço de banco de dados de destino, selecione também Db2 ou Db2 Warehouse se o problema parecer estar relacionado ao banco de dados de destino.
3. Se você estiver executando mais de uma Data Gate instância no mesmo sistema e quiser fornecer as informações de rastreamento para IBM suporte, especifique também o ID da instância. Você também pode incluir um link da web para o Data Gate painel da instância, pois esse link contém o ID da instância.
  Observação: os arquivos de rastreamento de procedimentos armazenados mais antigos são excluídos quando o número máximo permitido de arquivos de rastreamento de procedimentos armazenados está prestes a ser excedido. Da mesma forma, as entradas mais antigas nos arquivos de rastreamento são substituídas quando o tamanho máximo de todos os arquivos de rastreamento de procedimentos armazenados é atingido. Portanto, certifique-se de acessar os arquivos de rastreamento logo após as informações relevantes do evento terem sido gravadas nesses arquivos.