Plug-in PostgreSQL

O PostgreSQL é um sistema de gerenciamento de banco de dados relacional por objetos disponível em várias plataformas, incluindo Linux, FreeBSD, Solaris, Microsoft Windows e macOS. Para mais informações, acesse postgresql.org (em inglês).

Descoberta

Mesmo que o plug-in PostgreSQL não esteja configurado, o Stackdriver Monitoring descobrirá serviços dele em execução no projeto do Google Cloud ao fazer o seguinte:

  • Pesquisas com o termo postgresql em nomes de instâncias
  • Verificação de portas abertas para 5432 usando regras de firewall

Os serviços descobertos são exibidos no menu Resources da página "Serviços do PostgreSQL". Depois que você instala o agente de monitoramento e configura o plug-in PostgreSQL nas instâncias, o Monitoring preenche a página "Serviços do PostgreSQL" com o inventário e as métricas.

Como configurar o Monitoring para monitorar o PostgreSQL

Depois que você instalar o agente do Monitoring, use as instruções a seguir para configurar o plug-in PostgreSQL nas instâncias.

Pré-requisitos

Para a coleta do PostgreSQL, crie um usuário/papel com privilégios mínimos que possam se conectar ao banco de dados usando a autenticação password ou md5. Esse usuário e essa senha são mencionados como STATS_USER e STATS_PASS no arquivo de configuração a seguir. Algumas instalações definem controles de acesso para a autenticação ident por padrão. Você precisa editar seu arquivo pg_hba.conf para ativar o acesso ao papel de agente. Supondo que você nomeou o papel como stackdriver-agent, talvez seja necessário adicionar uma destas linhas ao seu arquivo pg_hba.conf e reiniciar o PostgreSQL:

  • Para conexão por meio de soquetes de domínio unix:

    local all stackdriver-agent md5

  • Para conexão por meio de TCP/IP para localhost:

    host all stackdriver-agent 127.0.0.1/32 md5

Ativar o plug-in de monitoramento do PostgreSQL

O PostgreSQL é configurado de acordo com cada banco de dados no sistema. No momento, nenhuma configuração de drop-in está disponível. O arquivo de configuração a seguir mostra como configurar um banco de dados, denominado DATABASE_NAME. Você precisaria usar essa configuração como um modelo para seus bancos de dados.

Na instância de VM, faça o download do postgresql.conf a partir do repositório de configuração do GitHub (links em inglês) e coloque-o no diretório /opt/stackdriver/collectd/etc/collectd.d/:

(cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/postgresql.conf)

Com acesso root, edite o arquivo de configuração transferido por download e adicione informações sobre seus bancos de dados. Os comentários in-line indicam onde você precisa adicionar a configuração dos bancos de dados extra. Substitua o nome do banco de dados onde houver DATABASE_NAME.

Depois de editar o arquivo de configuração, reinicie o agente de monitoramento executando o seguinte comando:

sudo service stackdriver-agent restart

Para mais informações sobre o plug-in collectd postgresql, consulte Plugin:PostgreSQL (em inglês).

O que é monitorado?

A lista completa de métricas que o plug-in PostreSQL monitora está em Métricas do agente: postgresql.