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 recolhe informações sobre transações, latência de queries, uso de memória por processos, estatísticas de utilização das bases de dados, entre outras. Ajuda os administradores a monitorizar a saúde e o desempenho das suas instâncias PostgreSQL, facilitando otimizações e ajustes.

Através desta opção de configuração, será possível indicar a porta de exposição das métricas do PostgreSQL para que sejam recolhidas 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 isso, indicar um superusuário da instância de base de dados e a respetiva palavra-passe de acesso.

    • Também é possível criar o usuário manualmente, através dos seguintes comandos:

      1. Estabeleça a ligação à instância PostgreSQL desejada.

      2. Execute o comando abaixo para criar o usuário pgsmart_metrics sem privilégios 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 (apenas privilégios para ler e executar visões e funções de monitorização) ao usuário pgsmart_metrics:

        Terminal input
           GRANT pg_monitor TO pgsmart_metrics;
  • O Exportador de Métricas do PostgreSQL será configurado, exista ou não o usuário pgsmart_metrics. Contudo, apenas iniciará a exportação das métricas quando tal usuário existir, com os devidos privilégios, na instância PostgreSQL monitorizada.

nota

A palavra-passe do usuário pgsmart_metrics pode ser modificada no PgSmart Web ou no PgSmart Cli, através do parâmetro metrics_password.

important

A palavra-passe da instância não será trocada, cabendo ao DBA/Administrador realizar essa alteração, uma vez que o Agente não possui as credenciais de acesso para a efetuar.

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 pretendido está instalado.
  • -h, --help Ajuda
Configuração Não Interativa

A execução não interativa está desativada 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 Registe um novo.

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

  3. Selecione a interface de rede para ligaçã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. Indique o superusuário da instância PostgreSQL.
    5.2. Indique a palavra-passe do superusuário da instância PostgreSQL.

    nota

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

  6. Indique 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