Colete informações de diagnóstico sobre o desempenho da carga de trabalho SAP

Este guia mostra como coletar informações de diagnóstico de desempenho das cargas de trabalho SAP usando o Agente para SAP do Google Cloud, versão 3.4 ou mais recente.

Quando você entrar em contato com o Cloud Customer Care para receber ajuda com problemas de desempenho com sua carga de trabalho SAP, será necessário compartilhar informações de diagnóstico pertinentes sobre sua carga de trabalho. Usando a ferramenta de diagnóstico de desempenho integrada do agente, você pode automatizar a coleta das informações de diagnóstico necessárias ,o que, por sua vez, ajuda a acelerar a solução de problemas e a resolução.

Para informações sobre os diagnósticos de desempenho que o agente pode executar para suas cargas de trabalho SAP, consulte Diagnóstico de desempenho da carga de trabalho.

Antes de começar

Verifique se você está usando a versão 3.4 ou mais recente do agente para SAP do Google Cloud.

Para saber mais sobre como verificar e atualizar o agente, consulte Atualizar o agente para SAP do Google Cloud.

Coletar informações do diagnóstico de desempenho

Para coletar informações do diagnóstico de desempenho para sua carga de trabalho SAP, invoque a ferramenta do agente usando o comando performancediagnostics:

sudo /usr/bin/google_cloud_sap_agent performancediagnostics \
    --type="COMMA_SEPARATED_DIAGNOSTIC_TYPES" \
    --test-bucket=STORAGE_BUCKET_NAME \
    --backint-config-file=BACKINT_CONFIG_FILE_PATH \
    --output-file-name=OUTPUT_FILE_NAME \
    --output-file-path=OUTPUT_FILE_PATH

Substitua:

COMMA_SEPARATED_DIAGNOSTIC_TYPES: os tipos de diagnóstico. que você quer executar.
STORAGE_BUCKET_NAME: o nome do Cloud Storage que a ferramenta precisa usar para executar o diagnóstico backup.
BACKINT_CONFIG_FILE_PATH: o caminho para o Arquivo de configuração do Backintnecessário.
OUTPUT_FILE_NAME: o nome do arquivo ZIP de saída; que contém as informações de diagnóstico sobre sua carga de trabalho SAP
OUTPUT_FILE_PATH: o caminho para o diretório em que você quer que a ferramenta de diagnóstico de desempenho salve o arquivo ZIP de saída. O caminho especificado será criado, se ainda não existir.

Para informações sobre os parâmetros aceitos por esse comando, consulte Parâmetros aceitos.

Parâmetros aceitos

A tabela a seguir descreve os parâmetros que você pode usar com o comando performancediagnostics:

Parâmetro	Descrição
`type`	`STRING` Especifica uma lista separada por vírgulas de tipos de diagnóstico que você quer executar. Estes são os tipos de diagnóstico compatíveis: `backup`: executa o diagnóstico automático do recurso do Backint e o diagnóstico `gsutil perfdiag` para cargas de trabalho do SAP HANA. `IO`: executa o diagnóstico de entrada/saída, que é realizado usando o testador flexível de E/S (FIO, na sigla em inglês). Realiza testes de estresse nos recursos de E/S dos sistemas de armazenamento das cargas de trabalho. Também executa simulações de carga de trabalho para avaliar o desempenho da infraestrutura da carga de trabalho, como discos e sistema de arquivos de rede. `all`: executa todos os diagnósticos padrão e sob demanda aceitos pela ferramenta. Se você estiver executando o diagnóstico `IO` ou `all`, é preciso garantir que a ferramenta FIO esteja instalada na instância de computação. Você pode instalar essa ferramenta executando `sudo yum install fio` no RHEL e `sudo zypper install fio` no SLES. Para mais informações sobre os diagnósticos aceitos, consulte Diagnóstico da carga de trabalho diagnóstico.
`backint-config-file`	`String` Se você quiser executar o diagnóstico `backup`, especifique o caminho para o arquivo de configuração do Backint. Por exemplo: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS.json`. Para executar o diagnóstico `backup`, é necessário especificar pelo menos um dos seguintes parâmetros: `backint-config-file` ou `test-bucket`: Se você usa arquivos de configuração separados para backups de dados, registros ou catálogo, especifique o caminho correspondente ao tipo de backup para o qual você quer coletar informações de diagnóstico.
`test-bucket`	`String` Se você quiser executar o diagnóstico `backup`, especifique o nome do bucket do Cloud Storage que a ferramenta precisa usar para testar o upload e o download de arquivos no e a partir do Cloud Storage. Por exemplo, `mybucket`. Confira se o bucket usado para testes não tem uma política de retenção definida. Para executar o diagnóstico `backup`, é necessário especificar pelo menos um dos parâmetros a seguir: `backint-config-file` ou `test-bucket`. Se você especificar valores para ambos os parâmetros, a ferramenta usará o bucket especificado para `test-bucket`.
`output-bucket`	`String` Opcional. Especifique o nome do bucket do Cloud Storage em que você quer fazer upload da saída da ferramenta de diagnóstico de desempenho. Por exemplo: `mytestbucket`. A ferramenta cria uma pasta chamada "performancediagnostics" neste bucket para armazenar os arquivos de saída. Se você não especificar esse parâmetro, a ferramenta salvará a saída no diretório determinado pela especificação do parâmetro `output-file-path`. Para permitir que a ferramenta faça upload da saída no Cloud Storage, a conta de serviço usada pelo agente precisa receber a função do IAM de Usuário do objeto de armazenamento (`roles/storage.objectUser`). Se você estiver usando o recurso Backint do agente, a conta de serviço terá a permissões subjacentes.
`output-file-name`	`String` Opcional. Especifique o nome do arquivo ZIP de saída que a ferramenta de diagnóstico de desempenho cria. Por padrão, o arquivo ZIP é nomeado `performance-diagnostics-TIMESTAMP`, em que `TIMESTAMP` é a data e a hora em que a ferramenta cria o arquivo ZIP.
`output-file-path`	`String` Opcional. Especifique o caminho para o diretório em que você quer que a ferramenta de diagnóstico de desempenho salve o arquivo ZIP de saída. O caminho especificado será criado, se ainda não existir. Por padrão, o arquivo ZIP é salvo no diretório `/tmp`.
`hyper-threading`	`String` Opcional. Especifique para definir as configurações de hiperthreading para os tipos de máquina bare metal do Compute Engine, como X4. O valor padrão é `on`. Os valores aceitos são `on` e `off`.
`log-level`	`String` Opcional. Define o nível de geração de registros do agente durante a execução do diagnóstico de desempenho. O valor padrão é `info`. Os valores aceitos são `debug`, `info`, `warn` e `error`. Operações realizadas pela ferramenta para coletar informações de diagnóstico são capturadas no seguinte arquivo: `/var/log/google-cloud-sap-agent/performancediagnostics.log`:

Ver registros

Ao executar o comando performancediagnostics, as operações realizadas são registradas no seguinte arquivo: /var/log/google-cloud-sap-agent/performancediagnostics.log.

A seguir

Depois de gerar a saída da ferramenta de diagnóstico de desempenho, você precisará enviá-la ao Customer Care. Isso ajuda o Customer Care a acelerar a solução do problema de desempenho com cargas de trabalho SAP.