O pg_healthcheck é uma ferramenta de linha de comando que retorna um relatório preliminar com observações e recomendações de melhorias sobre a instância Postgres e o banco de dados.

A ferramenta é um executável de linha de comando compatível com sistemas operacionais Linux ou Windows. Ela recebe como parâmetro a string de conexão do banco de dados a ser conectado, as informações de quantidade de CPU, memória e disco e um parâmetro da ação que você quer executar.

Abaixo segue a saída da ajuda da ferramenta:

A PostgreSQL Health Check Advisor

Usage: pg_healthcheck [OPTIONS] <COMMAND>

Commands:

 check          Executa todas as verificações

 check-so        Executa a verificação apenas para do Sistema Operacional

 check-instance  Executa a verificação apenas para a Instancia

 check-db        Executa a verificação apenas para o Banco de Dados

 help            Print this message or the help of the given subcommand(s)

Options:

     –conninfo <CONNINFO>      String de conexão para o PostgreSQL [env: PGCONNINFO=]

 -n, –num-cpus <NUM_CPUS>      Total de CPUs no servidor

 -m, –memory <MEMORY>          Total de memória no servidor (em bytes)

 -d, –disk-space <DISK_SPACE>  Tamanho do volume onde se encontra o PGDATA (em bytes)

 -h, –help                    Print help

 -V, –version                  Print version

Os dados coletados não são enviados para qualquer lugar. Todo processamento é feito pela ferramenta e as observações são apresentadas em tela.

Você pode redirecionar a saída para um arquivo se você quiser, entretanto a ferramenta não interage com sistema de arquivos ou com qualquer API externa, ela apenas comunica remotamente com o serviço Postgres que você informou em –conninfo ou na variável PGCONNINFO.

O pg_healthcheck pode ser executado a partir de qualquer estação de trabalho que tenha acesso ao serviço Postgres que você deseja obter uma avaliação preliminar.

Não é necessário instalá-lo ou configurá-lo no seu servidor. Isto também possibilita que você execute o pg_healthcheck a partir de uma máquina virtual, docker ou até mesmo em sua ferramenta de CI/CD.

As recomendações apresentadas pela ferramenta são sugestões preliminares, baseadas em na nossa experiência diária em avaliações de saúde de ambientes Postgres bem como na própria documentação do PostgreSQL. A escolha por aplicar ou não as recomendações é inteiramente do usuário.

Caso você precise de ajuda para aplicar as recomendações, pode entrar em contato com nosso time de especialistas para uma consulta técnica.

Cada recomendação tem um efeito sobre sua instância de banco de dados e é de sua responsabilidade validar cada uma delas. Há mudanças que exigem reinicialização do serviço do PostgreSQL, já outras precisam apenas recarregar as configurações.

Na dúvida, recorra à documentação em busca do que significa cada recomendação e planeje as mudanças de acordo com o seu ambiente evitando indisponibilidade indesejada.

Recomendamos sempre planejar, testar e validar as mudanças previamente em ambientes não críticos, como ambientes de Teste ou Homologação, antes de aplicar em Produção.

Caso você precise de ajuda para aplicar as recomendações, pode entrar em contato com nosso time de especialistas para uma consulta técnica.

Isso indica que existem ações que devem ser tomadas no curto prazo e que podem beneficiar seu banco de dados ou ajudar a prevenir problemas futuros.

Você poderá entrar em contato com nossa equipe de especialistas para marcar um momento onde podemos te ajudar a implementar todas as recomendações que precisa. É só nos chamar! Ficaremos felizes em atender você.

Existe uma escala em ordem crescente de Petabytes, Terabytes, Gigabytes, Megabytes, Kilobytes e Bytes. Para cada transformação, você irá multiplicar o valor de 1024, sempre da esquerda para a direita.

Ex. Para transformar 10 GB (Gigabytes) em Bytes você realiza o seguinte cálculo:

10 * 1024 * 1024 * 1024 = 10737418240

Caso algum parâmetro tenha sido ajustado de forma que o PostgreSQL não consiga iniciar, é sempre recomendado fazer uma cópia do arquivo de configuração anterior para nessa situação, voltar o arquivo anterior, iniciar o banco de dados novamente e em seguida entender o que pode ter dado errado.

Não, a ferramenta pode ser executada sem qualquer preparação prévia, desde que de onde você irá executar, seja possível estabelecer uma conexão com o banco de dados. Algumas extensões podem aumentar a cobertura de análise da ferramenta como as extensões pgstattuple e pg_stat_statements.

1. Faça o seu cadastro para acessar a área de download
2. Baixe o binário para seu sistema no link disponibilizado e salve-o em um computador com acesso ao seu banco de dados
3. Execute o binário com a opção –help para visualizar as opções
4. Você não precisa que o binário esteja no seu servidor apenas que ele tenha acesso ao serviço do Postgres que você deseja realizar o diagnóstico preliminar
5. Aconselhamos que você utilize um usuário somente leitura
6. O pg_healthcheck emitirá um relatório preliminar sobre a saúde da sua instância de banco de dados Postgres
7. O pg_healthcheck não realizará qualquer alteração, apenas vai apresentar sugestões, as quais devem ser avaliadas, testadas e homologadas antes de qualquer mudança em ambiente crítico.