Informações de diagnóstico do agente do Google Cloud para SAP

Para problemas relacionados à versão 3.8 (mais recente) do agente doGoogle Cloudpara SAP, forneça as seguintes informações de diagnóstico ao Cloud Customer Care assim que possível:

• Uma descrição completa e detalhada do problema.
• O pacote de suporte do agente
• Os dados mais recentes coletados pelo agente.
• O arquivo de configuração do agente.
• O arquivo de registro do agente.

Descrição detalhada do problema

Forneça uma descrição completa e detalhada do problema, incluindo a versão do agente e a data e hora em que o problema ocorreu.

Para acessar a versão do agente, siga estas etapas:

Pacote de suporte

O pacote de suporte é uma coleção de informações do agente para SAP do Google Cloud, que ajuda o atendimento ao cliente a oferecer suporte para a solução de problemas. Esse recurso está disponível para a versão 2.1 ou mais recente do Agente para SAP do Google Cloud.

Na versão 3.4 do agente, é possível fazer upload da saída do comando supportbundle usando a opção result-bucket. Para isso, verifique se a conta de serviço usada pelo agente tem a seguinte permissão do IAM: storage.objects.create.

O que o pacote de suporte contém

• Os arquivos de registro e configuração do agente.

  A partir da versão 3.0 do agente, isso inclui os registros e arquivos de configuração relacionados aos recursos Backint e snapshot do disco do agente.

• Traces e arquivos de topologia do SAP HANA para o nome do host e o SID fornecidos.

• Agente do Backint do Cloud Storage para arquivos de configuração e registros do SAP HANA.

• Para um cluster de alta disponibilidade (HA) no RHEL, quando você especifica pacemaker-diagnosis="true", a saída do sosreport é salva no seguinte diretório: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Se a execução do comando sosreport falhar, a saída de crm_report será salva no diretório especificado.

• Para um cluster de alta disponibilidade no SUSE, quando você especifica pacemaker-diagnosis=true, a saída dos utilitários hb_report e supportconfig é salva no seguinte diretório: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Se a execução desses utilitários falhar, a saída de hb_report e crm_report será salva no diretório especificado.

• O arquivo /var/log/messages, que ajuda a fornecer informações úteis sobre as operações do sistema Linux.

• A partir da versão 3.8 do agente, o arquivo sapdiscovery.json é incluído por padrão. O arquivo contém informações sobre os produtos SAP e componentes relacionados que estão sendo executados na instância de computação. Essas informações fornecem ao atendimento ao cliente um melhor contexto sobre a função e a configuração do sistema SAP.

  Para permitir que o agente colete essas informações, você precisa atender aos seguintes requisitos:

  • Especifique "log_to_cloud": true no arquivo de configuração do agente.
  • Conceda a permissão logging.logEntries.list do IAM à conta de serviço usada pelo agente.

• A partir da versão 3.8 do agente, quando você especifica a opção metrics, o pacote inclui informações sobre as ocorrências de eventos SAP predefinidos e as mudanças nos valores de métrica de monitoramento de processos e métrica de monitoramento do SAP HANA por um período específico.

  • Para permitir que o agente colete informações sobre as ocorrências de eventos SAP predefinidos nos registros do Cloud Logging, é necessário atender aos seguintes requisitos:
    • Especifique "log_to_cloud": true no arquivo de configuração do agente.
    • Conceda a permissão logging.logEntries.list do IAM à conta de serviço usada pelo agente.
  • Para permitir que o agente colete informações sobre mudanças nos valores de métricas do Cloud Monitoring, é necessário atender aos seguintes requisitos:
    • Especifique "send_metrics_to_monitoring": true no arquivo de configuração do agente.
    • Conceda as seguintes permissões do IAM à conta de serviço que o agente usa: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list e monitoring.timeSeries.list.
  • O período em que o agente filtra os registros do Cloud Logging e as entradas do Cloud Monitoring é determinado pelo comportamento das seguintes opções:
    • timestamp: o carimbo de data/hora, no formato YYYY-MM-DD HH:MM:SS, em que você quer coletar informações sobre ocorrências dos tipos de evento predefinidos do SAP e mudanças nos valores das métricas. O valor padrão é o tempo em que você executa o comando supportbundle.
    • before-duration: o número de segundos antes de timestamp em que o agente procura as ocorrências de eventos predefinidos do SAP e mudanças nos valores das métricas. O valor padrão é de 3.600 segundos.
    • after-duration: o número de segundos após timestamp em que o agente procura as ocorrências de eventos predefinidos do SAP e as mudanças nos valores das métricas. O valor padrão é de 1.800 segundos.

  • As informações coletadas são organizadas em pastas que contêm arquivos JSON para cada tipo de evento da SAP que ocorreu e cada métrica que mudou o valor. Confira abaixo um exemplo de como a saída aparece:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Gerar pacote de suporte

Para gerar o pacote de suporte para uma instância do agente em execução no Linux, execute o seguinte comando na sua instância de computação:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Substitua:

• SID: o ID do sistema SAP.
• INSTANCE_NUMBERS: os números de instância do SAP para os quais você quer gerar o pacote de suporte.

  Para especificar vários números de instância, separe-os usando um espaço. Por exemplo, 00 11 22. Quando você especifica dois ou mais números de instância do SAP, o comando gera um pacote de suporte combinado para as instâncias especificadas.

• HOST_NAME: o nome do host em que você executa o comando.
• BOOLEAN_VALUE: o valor true ou false, que determina se o diagnóstico relacionado ao marcapasso é realizado ou não. O valor padrão é false.
• BUCKET_NAME: o nome do bucket do Cloud Storage em que você quer fazer upload da saída do comando supportbundle.
• TIMESTAMP: o carimbo de data/hora, no formato YYYY-MM-DD HH:MM:SS, em que você quer coletar informações sobre ocorrências de tipos de eventos predefinidos do SAP e mudanças nos valores de métricas. O valor padrão é o tempo em que você executa o comando supportbundle.
• BEFORE_DURATION: o número de segundos antes do valor da opção timestamp em que o agente procura as ocorrências de eventos SAP predefinidos e mudanças nos valores de métricas. O valor padrão é de 3.600 segundos.
• AFTER_DURATION: o número de segundos após o valor da opção timestamp durante o qual o agente procura as ocorrências de eventos predefinidos do SAP e mudanças nos valores de métricas. O valor padrão é 1.800 segundos.

Dados mais recentes coletados pelo agente

Forneça os dados mais recentes coletados pelo agente. Salve os dados mais recentes coletados pelo agente em um arquivo e anexe-o ao caso de suporte.

Para ver os dados mais recentes coletados pelo agente, siga estas etapas:

Arquivo de configuração

Depois de remover as credenciais, como nome de usuário e senha do banco de dados do SAP HANA, forneça o arquivo de configuração para o agente do Google Cloudpara SAP.

Para encontrar o arquivo de configuração do agente, acesse o seguinte caminho:

/etc/google-cloud-sap-agent/configuration.json

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

Arquivo de registros

Forneça o arquivo de registro do agente do Google Cloudpara SAP.

Para encontrar o arquivo de registro do agente, acesse o seguinte caminho:

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log