Gerar e diagnosticar arquivos de despejo do AlloyDB Omni

Esta página descreve como gerar arquivos de dump do sistema do AlloyDB Omni e analisar as causas de problemas inesperados.

Antes de começar

Extraia o utilitário alloydb-sysdump incluído na imagem do Docker do AlloyDB Omni que você instalou:

Docker 

  docker run --rm --entrypoint /bin/bash $IMAGE -c "cat /usr/lib/postgresql/15/bin/alloydb-sysdump" > /tmp/alloydb-sysdump
  chmod +x /tmp/alloydb-sysdump

Podman 

  podman run --rm --entrypoint /bin/bash $IMAGE -c "cat /usr/lib/postgresql/15/bin/alloydb-sysdump" > /tmp/alloydb-sysdump
  chmod +x /tmp/alloydb-sysdump

Gerar um arquivo dump do AlloyDB Omni

É possível gerar manualmente um arquivo dump do AlloyDB Omni a qualquer momento. O exame do arquivo dump ajuda você ou o suporte ao cliente do Google Cloud a analisar problemas com a instalação do AlloyDB Omni, como deadlocks que bloqueiam novas conexões, consultas lentas, vácuo lento, uso intenso de memória, CPU ou armazenamento.

Para gerar um arquivo dump, execute o seguinte comando:

   sudo /tmp/alloydb-sysdump -D=INSTALL_PATH -U=USERNAME -p=PORT -H=HOSTNAME -c=CONTAINER_NAME

Substitua:

  • INSTALL_PATH: o caminho para o diretório de instalação do AlloyDB Omni acessível no sistema de arquivos do host.
  • USERNAME: o nome do usuário que se conecta ao banco de dados.
  • PORT: a porta TCP em que o AlloyDB Omni aceita conexões. O valor padrão é 5432.
  • HOSTNAME: o nome do host da máquina em que o AlloyDB Omni é executado. Se o valor começar com um caractere de barra, ele será usado como o diretório de um socket de domínio Unix. O valor padrão é localhost.

  • CONTAINER_NAME: o nome do contêiner em que o AlloyDB Omni é executado.

    A resposta ao comando mostra o local do arquivo dump do sistema.

    Para saber mais sobre os argumentos do comando, execute:

     /tmp/alloydb-sysdump --help

Analisar um arquivo dump do AlloyDB Omni

Um arquivo dump do AlloyDB Omni é um arquivo de texto comum que resume vários aspectos do estado do sistema. Para conferir, abra o arquivo em um editor de texto, no programa less ou em qualquer outro programa para visualizar arquivos de texto.

O AlloyDB Omni salva o arquivo no diretório de dados e o nomeia como alloydb_system_dump_ seguido por um carimbo de data/hora. Por exemplo, alloydb_system_dump_20240614_062953PM.

Criar um caso de suporte para receber ajuda

Se você precisar de ajuda para interpretar um arquivo dump do sistema para resolver um problema com o AlloyDB Omni, crie um caso de suporte e anexe o arquivo a ele. Você precisa ter uma conta do Google Cloud para criar um caso de suporte.

A equipe do AlloyDB responde ao caso com base na prioridade dele e no respectivo serviço de suporte no momento da criação.