Gerar e diagnosticar o AlloyDB Omni usando arquivos dump do RPM

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

O utilitário alloydb-sysdump está incluído no pacote do AlloyDB Omni. O utilitário está disponível em /usr/lib/postgresql/PG_VERSION/bin/alloydb-sysdump, em que PG_VERSION é a versão principal do PostgreSQL, por exemplo, 18.

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 /usr/lib/postgresql/PG_VERSION/bin/alloydb-sysdump -r -D=DATA_DIR -s=SERVICE_NAME -U=USERNAME -p=PORT -H=HOSTNAME

Substitua:

  • PG_VERSION: a versão principal do PostgreSQL da sua instalação do AlloyDB Omni. Por exemplo, 18.
  • DATA_DIR: o caminho para o diretório de dados do AlloyDB Omni. Por exemplo, /var/alloydb/main/data.
  • SERVICE_NAME: o nome do serviço systemd do AlloyDB Omni. O valor padrão é alloydbomni18.
  • USERNAME: o nome do usuário que se conecta ao banco de dados. O valor padrão é alloydbadmin.
  • 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.

    O exemplo de comando a seguir gera um arquivo dump para uma instalação do AlloyDB Omni versão 18 usando valores padrão:

    sudo /usr/lib/postgresql/18/bin/alloydb-sysdump -r -D=/var/alloydb/main/data -s=alloydbomni18 -U=alloydbadmin -p=5432 -H=localhost

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

    Para aprender mais sobre os argumentos de comando, execute:

    /usr/lib/postgresql/PG_VERSION/bin/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.