Pular para o conteúdo principal
Versão 4.1.0

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

O Exportador de Métricas do PgBouncer expõe métricas como o número de ligações ativas, ligações em espera na fila e utilização de recursos do PgBouncer, entre outras. Esta informação é importante para ajustar o comportamento do pooling e garantir que o ambiente responde de forma eficiente aos pedidos dos clientes.

Por meio desta opção de configuração é possível definir a porta de exposição das métricas do PgBouncer para recolha pelo Prometheus.

alerta

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

O usuário pode ser configurado durante o processo de configuração do Exportador de Métricas do PgBouncer, bastando confirmar a operação.

O usuário pode também ser configurado manualmente, através das seguintes operações:

√ Inclusão do usuário no ficheiro de configuração do PgBouncer userlist.txt;
√ Inclusão do usuário no parâmetro do PgBouncer stats_users;

Além disso, é necessário configurar o valor "extra_float_digits" no parâmetro "ignore_startup_parameters", nas instâncias de PgBouncer onde será configurado.

O Exportador de Métricas do PgBouncer será configurado, existindo ou não estas configurações no PgBouncer. No entanto, a exportação das métricas apenas ocorrerá a partir do momento em que tudo esteja configurado na instância de PgBouncer e o serviço deste Exportador de Métricas seja iniciado.

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.

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á desativada para esta operação.

Configuração Interativa
Terminal input
    pgsmart obs exporter config

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

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

  2. Confirme se pretende ou não atualizar o repositório de pacotes da Plataforma.

    2.1. Se confirmado, indique o novo repositório.

  3. Selecione o Exportador de Métricas do PgBouncer.

  4. Selecione a interface de rede para ligação.

  5. Adicione a(s) instância(s) do gerenciamento de pool(s) de ligação(ões).

    alerta

    Este Exportador de Métricas requer a configuração prévia do parâmetro ignore_startup_parameters com o valor extra_float_digits para cada instância do PgBouncer.

    É possível realizar tal configuração pelo próprio PgSmart, por meio da opção de configuração do serviço de pool de ligações.

    Esta configuração é necessária para que o driver de ligação à instância ignore determinados parâmetros na inicialização da ligação.

    É importante salientar que o Exportador de Métricas do PgBouncer será configurado pelo PgSmart, independentemente desta configuração.

    Porém, a exportação de métricas apenas será iniciada após a configuração do parâmetro ignore_startup_parameters.

    5.1. Indique a porta de ligação para o gerenciamento do pool de ligações.

    5.2. Confirme se pretende a configuração do usuário de acesso pgsmart_metrics no PgBouncer.

    5.3. Indique a porta de exposição das métricas e da interface web.

    5.4. Confirme se pretende adicionar mais uma instância do gerenciamento do pool de ligações.

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

    Poderão ser adicionadas tantas instâncias quanto necessário.

    nota

    As métricas exportadas podem ser visualizadas pela consola:

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

    Ou pela interface web:

    Terminal input
        http://192.168.56.234:9100/metrics