Gerar e diagnosticar arquivos dump do AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, descrevemos como gerar arquivos 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 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. Analisar o arquivo dump ajuda você ou o Atendimento ao cliente do Google Cloud a analisar problemas com a instalação do AlloyDB Omni , como impasses que bloqueiam novas conexões, consultas lentas, vácuo lento, uso alto 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 uma barra, ele será usado como o diretório de um soquete de domínio do 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 aprender mais sobre os argumentos de 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 analisá-lo, abra-o 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 de 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 e resolver um problema com o AlloyDB Omni, crie um caso de suporte e anexe o arquivo a ele. Você precisa ter uma Google Cloud conta 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.