Configurando o monitoramento do PostgreSQL

Configure o Monitoring Agent for PostgreSQL para que o agente possa coletar dados do banco de dados PostgreSQL que está sendo monitorado.

Antes de Iniciar

Você deve instalar o driver JDBC do PostgreSQL antes de instalar esse agente. O caminho para esse driver é necessário no momento da configuração do agente.

O driver JDBC tipo 4 é a nova versão e, portanto, a preferencial. O usuário pode instalar a versão 4 do subtipo JDBC de acordo com a versão JDK que o agente usa. Para o mapeamento da versão do JDBC para a versão do JDK, obtenha informações adicionais em https://jdbc.postgresql.org/download.html.

Alguns dos atributos coletados pelo agente dependem da extensão pg_stat_statements. Para incluir pg_stat_statements, primeiramente instale o pacote postgresql-contrib. Deve-se modificar o arquivo de configuração postgresql.conf para que o servidor PostgreSQL carregue a extensão pg_stat_statements.

Abra o arquivo postgresql.conf em um editor de texto e atualize a linha shared_preload_libraries:
```
shared_preload_libraries = 'pg_stat_statements'
pg_stat_statements.track_utility = false
```
Essas mudanças são necessárias para monitorar as instruções SQL, exceto os comandos do utilitário.
Nota: O status de pg_stat_statements.track_utility é configurado ou modificado somente por um superusuário.
Reinicie o servidor PostgreSQL depois de atualizar e salvar o postgresql.conf.
Execute o comando SQL a seguir usando psql, que deve ser conectado ao mesmo banco de dados que seria fornecido posteriormente na configuração do agente para conectividade JDBC:
```
create extension pg_stat_statements; 
select pg_stat_statements_reset();
```
Nota: O comando create extension e a função pg_stat_statements_reset() são executados somente por um superusuário.
A visualização pg_stat_statements precisa ser ativada para o banco de dados específico, para obter mais detalhes, consulte https://www.postgresql.org/docs/9.6/static/pgstatstatements.html.

O arquivo pg_hba.conf é o arquivo de banco de dados PostgreSQL que contém configurações de autenticação. Quando o valor de parâmetro auth-method for configurado como ident no arquivo pg_hba.conf, o Agente PostgreSQL não poderá se conectar ao banco de dados PostgreSQL. Assegure que as configurações de autenticação para o parâmetro auth-method estejam corretas. Por exemplo, é possível configurar esses valores para o parâmetro auth-method: md5, trust ou password.

Revise os pré-requisitos de hardware e de software. Para obter informações atualizadas sobre requisitos do sistema, consulte o Software Product Compatibility Reports (SPCR) para o Agente PostgreSQL.

Sobre Esta Tarefa

O Agente PostgreSQL é um agente de múltiplas instâncias; você deve criar a primeira instância e iniciar o agente manualmente. O nome do sistema gerenciado inclui o nome da instância especificada, por exemplo instance_name:host_name:pc, em que pc é o código de produto de dois caracteres. O nome do sistema gerenciado é limitado a 32 caracteres. O nome da instância que você especifica é limitado a 28 caracteres, menos o comprimento do nome do host. Por exemplo, se você especificar PostgreSQL2 como o seu nome da instância, o nome do sistema gerenciado será PostgreSQL2:hostname:PN.

Importante: Se você especificar um nome de instância longo, o nome do sistema gerenciado será truncado e o código do agente não será exibido completamente.

Muitas vezes, a versão do produto e a versão do agente diferem. As direções aqui destinam-se à liberação mais atual desse agente. Para obter informações sobre como verificar a versão de um agente em seu ambiente, consulte Comando de versão do agente. Para obter informações detalhadas sobre a lista de versões do agente e o que há de novo para cada versão, consulte o Histórico de Mudanças.

O que Fazer Depois

Efetue login no Console do Cloud APM para visualizar os dados que são coletados pelo agente nos painéis. Para obter informações sobre como usar o Console do Cloud APM, consulte Iniciando o Console do Cloud APM.