Pular para o conteúdo principal
Versão 4.1.0

Configuração do Exportador de Métricas do PostgreSQL

O Exportador de Métricas do PostgreSQL coleta informações sobre transações, latência de queries, uso de memória por processos, estatísticas de uso dos bancos de dados, entre outras. Isso ajuda os administradores a monitorar a saúde e o desempenho de suas instâncias PostgreSQL, facilitando otimizações e ajustes.

Por meio desta opção de configuração será possível informar a porta de exposição das métricas do PostgreSQL para serem coletadas pelo Prometheus.

alerta

  • Para realizar esta operação é necessário que o usuário "pgsmart_metrics" exista nas instâncias PostgreSQL onde será configurado.

  • A criação do usuário poderá ser feita durante o processo de Configuração do Exportador de Métricas, bastando, para isto, informar um ´superusuário´ para a instância de banco de dados e sua respectiva senha de acesso.

    • Também é possível a criação do usuário manualmente, por meio dos seguintes comandos:

      1. Realize a conexão com a instância PostgreSQL desejada.

      2. Execute o comando abaixo para criar o usuário pgsmart_metrics sem privilegios de acesso às tabelas e dados do usuário:

        Terminal input
           CREATE USER pgsmart_metrics ENCRYPTED PASSWORD <valor do parâmetro metrics_password>;

      3. Execute o comando abaixo para conceder a role pg_monitor (somente privilégios para ler e executar visões e funções de monitoramento) para o usuário pgsmart_metrics.

        Terminal input
           GRANT pg_monitor TO pgsmart_metrics;

    • Estas informações NÃO serão armazenadas e só serão usadas durante a operação de configuração.

  • O Exportador de Métricas do PostgreSQL será configurado, existindo ou não o usuário pgsmart_metrics. Entretanto, somente iniciará a exportação das métricas a partir do momento em que tal usuário existir, com os devidos privilégios, na instância PostgreSQL monitorada.

nota

A senha do usuário pgsmart_metrics poderá ser modificada no PgSmart Web ou no PgSmart Cli, por meio do parâmetro ´metrics_password´.

important

A senha de instância não será trocada, cabendo ao DBA/Administrador realizar esta troca, uma vez que o Agente não possui as credenciais de acesso para realizá-la.

Pré-Requisitos
Sintaxe do Comando
Terminal input
   pgsmart obs exporter config [Flags]

Flags:

  • -a, --agent=<agent> Alias, hostname ou IP do servidor onde o PgSmart Agent desejado está instalado.
  • -h, --help Ajuda
Configuração Não-Interativa

A execução não interativa está desabilitada para esta operação.

Configuração Interativa
Terminal input
   pgsmart obs exporter config

Configuração do Exportador de Métricas do PostgreSQL​

  1. Selecione o Agente do PgSmart ou Registrar um novo.

  2. Selecione o Exportador de Métricas do PostgreSQL.

  3. Selecione a interface de rede para conexão.

  4. Selecione o Diretório de Dados (PGDATA) da instância PostgreSQL (ou adicione o Diretório de Dados desejado).

  5. Confirme se deseja que o PgSmart crie o usuário de acesso.
    5.1. Informe o superusuário da instância PostgreSQL.
    5.2. Informe a senha do superusuário da instância PostgreSQL.

    nota

    As credenciais informadas não são armazenadas pelo PgSmart. Elas são utilizadas apenas para a criação do usuário de acesso e manipuladas somente em memória.

  6. Informe a porta de exposição das métricas e interface web.

  7. Confirme se deseja adicionar mais instâncias PostgreSQL.

Figura 1 - Configuração do Exportador de Métricas PostgreSQL
Figura 1 - Configuração do Exportador de Métricas PostgreSQL
nota

As métricas exportadas podem ser visualizadas pelo console:

Terminal input
   curl http://192.168.56.235:9100/metrics

Ou pela interface web:

Terminal input
   http://192.168.56.235:9100/metrics