Definições de configuração da integração PostgreSQL

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

Configurações da instância do PostgreSQL

A integração PostgreSQL coleta informações métricas (M) e de inventário (I). A coluna Applies To na tabela a seguir indica quais configurações podem ser usadas para cada coleção específica:

Contexto	Descrição	Aplica-se a
`HOSTNAME`	O nome do host da conexão PostgreSQL. O padrão é localhost.	MI
`PORT`	A porta onde o PostgreSQL está sendo executado. O padrão é 5432.	MI
`USERNAME`	O nome de usuário para a conexão PostgreSQL. Required.	MI
`PASSWORD`	A senha para a conexão PostgreSQL. Required.	MI
`COLLECTION_LIST`	Matriz JSON, um objeto JSON ou a string literal `ALL` que especifica a entidade a ser coletada. O usuário PostgreSQL só pode coletar métricas de tabelas e índices de tabelas para as quais possui `SELECT` permissões. Obrigatório, exceto para `PgBouncer`. Importante Isso não se aplica a consultas personalizadas configuradas com `CUSTOM_METRICS_QUERY` ou `CUSTOM_METRICS_CONFIG`. Para obter ajuda, veja estes exemplos.	M
`COLLECTION_IGNORE_DATABASE_LIST`	Matriz JSON de nomes de bancos de dados que serão ignorados para coleta de métricas. Normalmente útil para casos em que `COLLECTION_LIST` está definido como `ALL` e alguns bancos de dados precisam ser ignorados. O padrão é `[]`. Importante Isso não se aplica a consultas personalizadas configuradas com `CUSTOM_METRICS_QUERY` ou `CUSTOM_METRICS_CONFIG`.	M
`PGBOUNCER`	Colete `pgbouncer` métricas. O padrão é `false`.	M
`ENABLE_SSL`	Determina se o SSL está habilitado. Se `true`, `ssl_cert_location` e `ssl_key_location` forem obrigatórios. O padrão é `false`.	MI
`TRUST_SERVER_CERTIFICATE`	Se `true`, o certificado do servidor não será verificado para SSL. Se `false`, o certificado do servidor identificado em `ssl_root_cert_location` será verificado. O padrão é `false`.	MI
`SSL_ROOT_CERT_LOCATION`	Caminho absoluto para o arquivo de certificado raiz codificado em PEM. Obrigatório se `trust_server_certificate` for `false`.	MI
`SSL_CERT_LOCATION`	Caminho absoluto para o arquivo de certificado de cliente codificado em PEM. Obrigatório se `enable_ssl` for `true`.	MI
`SSL_KEY_LOCATION`	Caminho absoluto para o arquivo de chave do cliente codificado em PEM. Obrigatório se `enable_ssl` for `true`.	MI
`TIMEOUT`	Espera máxima pela conexão, em segundos. Defina como `0` para não ter tempo limite. O padrão é 10.	MI
`DATABASE`	O banco de dados PostgreSQL ao qual se conectar. O padrão é `postgres`.	MI
`CUSTOM_METRICS_QUERY`	A consulta SQL que requer `columns metric_name`, `metric_type` e `metric_value.metric_type` pode ser `gauge`, `rate`, `delta` ou `attribute`. Colunas adicionais coletadas com a consulta são adicionadas à métrica definida como atributo.	M
`CUSTOM_METRICS_CONFIG`	Um caminho para um arquivo YAML com uma lista de consultas personalizadas, juntamente com seu tipo de métrica, banco de dados e substituições de nomes de amostra. Veja os exemplos para detalhes.	M
`COLLECT_DB_LOCK_METRICS`	Possibilita a coleta de métricas de bloqueio do banco de dados, que podem ser intensivas em desempenho. O padrão é `false`.	M
`COLLECT_BLOAT_METRICS`	Habilite a métrica de inchaço do espaço de tabela, que pode exigir muito desempenho. O padrão é `true`.	M
`METRICS`	Defina como `true` para ativar a coleta somente de métricas. O padrão é `false`.
`INVENTORY`	Defina como `true` para ativar a coleta somente de inventário. O padrão é `false`.

Os valores para estas configurações podem ser definidos de diversas maneiras:

Adicionando o valor diretamente no arquivo de configuração. Esta é a forma mais comum.
Substituindo os valores das variáveis de ambiente usando a notação {{ }} . Leia mais sobre como usar passthroughs de variáveis de ambiente com integração no host ou veja o exemplo de substituição de variáveis de ambiente.
Importante
Isso requer o agente de infraestrutura v1.14.0+.
Usando gerenciamento de segredos. Use isto para proteger informações confidenciais, como senhas que seriam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte gerenciamento de segredos.

Etiquetas e atributo personalizado

Variáveis de ambiente podem ser usadas para controlar definições de configuração, como e, em seguida, são passadas para o agente de infraestrutura. Para obter instruções sobre como usar esse recurso, consulte Configurar o agente de infraestrutura.

Você pode decorar ainda mais sua métrica usando etiquetas. Os rótulos permitem que você adicione pares de valores principais atributo à sua métrica que você pode usar para consultar, filtrar ou agrupar sua métrica.

Nosso arquivo de configuração de amostra padrão inclui exemplos de rótulos, mas, como não são obrigatórios, você pode remover, modificar ou adicionar novos de sua escolha:

labels:
   env: production
   role: postgresql

Dados de inventário

A integração do PostgreSQL coleta cada configuração de pg_settings junto com seus boot_val e reset_val. A infraestrutura dados de inventário aparece na página Inventário, na fonte config/postgresql .

Resolução de problemas

Aqui estão algumas dicas de resolução de problemas para a integração PostgreSQL:

Se você tiver problemas de conexão, certifique-se de poder se conectar ao cluster na mesma caixa com psql.
Se você tiver problemas para coletar a métrica PgBouncer, certifique-se de estar conectado à instância através de PgBouncer. A porta padrão é 6432.
Se você receber a mensagem de erro Error creating list of entities to collect: pq: unsupported startup parameter: extra_float_digits, defina ignore_startup_parameters = extra_float_digits no arquivo de configuração PgBouncer .

Esta tradução de máquina é fornecida para sua comodidade.

Definições de configuração da integração PostgreSQL

Configurações da instância do PostgreSQL .css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Importante

Importante

Etiquetas e atributo personalizado

Dados de inventário

Resolução de problemas

Configurações da instância do PostgreSQL