Instalar e configurar o NRDOT para monitoramento do PostgreSQL com o Chef

Você pode instalar e configurar o NRDOT Collector para o monitoramento do PostgreSQL usando o cookbook newrelic-install do Chef. O cookbook instala o coletor, cria a função de monitoramento e suas permissões, e configura o coletor quando você executa a receita newrelic-install::default.

Instalação guiada

Para instalar pela interface da New Relic, acesse one.newrelic.com > Integrations & Agents > PostgreSQL (Database 360). Esta página aborda apenas a instalação manual.

Pré-requisitos

Uma conta New Relic com uma chave de licença válida.
Um ID de conta da New Relic.
PostgreSQL 14 ou posterior.
Chef 15 ou posterior.
Um host coletor Linux executando Debian/Ubuntu ou RHEL/CentOS.
pg_stat_statements deve ser carregado via shared_preload_libraries, o que requer a reinicialização do banco de dados. Atenda aos pré-requisitos no nível do servidor antes de executar a receita.
Para PostgreSQL auto-hospedado: acesso administrativo ao seu servidor PostgreSQL (o superusuário postgres ou equivalente), com uma senha definida e pg_hba.conf permitindo autenticação de host baseada em senha.
Para PostgreSQL ou Aurora no AWS RDS: conectividade de rede do host do coletor para o endpoint do RDS, e o nome de usuário e senha mestre do RDS.
Conectividade de rede para o endpoint OTLP da New Relic para sua região.

Para requisitos detalhados, consulte Compatibilidade.

Baixar o cookbook do Chef

Faça o download do newrelic-install cookbook do Chef do Chef Supermarket para o seu diretório de repositório (chef-repo):

bash

$knife supermarket install newrelic-install

Substituir os atributos padrão

Substitua os atributos padrão em attributes/default.rb pelos detalhes da sua conta:

Este cookbook monitora uma ou mais instâncias do PostgreSQL a partir de um único coletor. Em vez de um único conjunto de host/porta/credencial, ele lê dois arquivos que já devem existir no nó: um arquivo de instâncias (YAML) listando cada instância a ser monitorada e os bancos de dados a serem monitorados em cada uma, e um arquivo de segredos (KEY=VALUE) com um login e senha de superusuário para cada uma, indexados para corresponder. Consulte a página de instalação da CLI para obter os formatos exatos dos arquivos.

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-postgresql'
]
default['newrelic_install']['env']['NR_CLI_POSTGRES_CONFIG_PRESET']         = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_POSTGRES_INSTANCES_FILE']        = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_SECRETS_FILE']          = <path to the secrets file (KEY=VALUE per instance) on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER'] = <y or N, default N; PREVIEW feature, see table below>
# See all available targets at: https://github.com/newrelic/chef-install

Importante

O cookbook se conecta ao PostgreSQL via TCP usando uma senha, portanto, o superusuário de cada instância deve ter uma senha definida e pg_hba.conf deve permitir a autenticação de host baseada em senha (md5 ou scram-sha-256) para conexões TCP:

bash

$sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD '<password>';"

Atributo (em `env`)	Descrição	Padrão
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuração NRDOT: `1` Básico, `2` Avançado.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.	Nenhum
`NR_CLI_POSTGRES_SECRETS_FILE`	Obrigatório. Caminho para o arquivo de segredos (`KEY=VALUE`, um par de login/senha de superusuário por instância), já presente no nó.	Nenhum
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Colete planos de consulta para instruções de bloqueio/gravação também. Cria uma função auxiliar `SECURITY DEFINER` (`otel.explain_statement`) em cada banco de dados monitorado, concedendo ao usuário de monitoramento `EXPLAIN` execução sem conceder acesso DML. Este é um recurso PREVIEW. `y`/`N`.	`n`

Dica

Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

Dica

Para monitorar mais de uma instância do PostgreSQL a partir deste coletor, adicione mais entradas ao arquivo de instâncias e credenciais numeradas correspondentes (_2, _3, ...) ao arquivo de segredos. Uma instância que falha em suas verificações (ou não tem bancos de dados listados) é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Este cookbook monitora um ou mais endpoints do RDS PostgreSQL ou Aurora a partir de um único coletor, usando o mesmo padrão de arquivo de instâncias/arquivo de segredos que o auto-hospedado (ambos os arquivos já devem existir no nó).

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-postgresql-rds'
]
default['newrelic_install']['env']['NR_CLI_POSTGRES_CONFIG_PRESET']         = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_POSTGRES_INSTANCES_FILE']        = <path to the instances YAML file on the node, using RDS or Aurora endpoints as host>
default['newrelic_install']['env']['NR_CLI_POSTGRES_SECRETS_FILE']          = <path to the secrets file (KEY=VALUE per instance) on the node>
default['newrelic_install']['env']['NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER'] = <y or N, default N; PREVIEW feature, see table below>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (em `env`)	Descrição	Padrão
`NR_CLI_POSTGRES_CONFIG_PRESET`	Configuração NRDOT: `1` Básico, `2` Avançado.	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, usando endpoints do RDS ou Aurora como `host`, já presente no nó.	Nenhum
`NR_CLI_POSTGRES_SECRETS_FILE`	Obrigatório. Caminho para o arquivo de segredos (`KEY=VALUE`, um par de nome de usuário/senha mestre do RDS por instância), já presente no nó.	Nenhum
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	Colete planos de consulta para instruções de bloqueio/gravação também. Cria uma função auxiliar `SECURITY DEFINER` (`otel.explain_statement`) em cada banco de dados monitorado, concedendo ao usuário de monitoramento `EXPLAIN` execução sem conceder acesso DML. Este é um recurso PREVIEW. `y`/`N`.	`n`

Dica

Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

Dica

Para monitorar mais de um endpoint do RDS PostgreSQL ou Aurora a partir deste coletor, adicione mais entradas ao arquivo de instâncias e credenciais numeradas correspondentes ao arquivo de segredos. Uma instância que falha em suas verificações (ou não tem bancos de dados listados) é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Faça o upload do cookbook do Chef

Faça o upload do cookbook newrelic-install do Chef para o seu servidor Chef:

bash

$knife cookbook upload newrelic-install

Atualizar a run list

Adicione a receita newrelic-install à run list de um nó:

"run_list": [
  "recipe[newrelic-install]"
]

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados PostgreSQL por meio da interface do New Relic.

Para encontrar a entidade de banco de dados PostgreSQL no New Relic:

Vá para one.newrelic.com > All capabilities > Databases.
Na dropdown Entity type, selecione PostgreSQL instance e clique em Apply.
Selecione seu banco de dados PostgreSQL na lista de entidades.

Introdução ao monitoramento do PostgreSQL com NRDOT

Saiba mais sobre todos os métodos de instalação disponíveis para o monitoramento do PostgreSQL com o New Relic.

Instalação da CLI

Saiba como instalar e configurar o monitoramento do PostgreSQL com um único comando da CLI do New Relic.

Instalação via Ansible

Saiba como instalar e configurar o monitoramento do PostgreSQL em escala com a newrelic.newrelic_install função Ansible.

Instalação do chart do Helm

Saiba como instalar e configurar o monitoramento do PostgreSQL no Kubernetes com o chart do Helm postgresql-otel.

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

Instalar e configurar o NRDOT para monitoramento do PostgreSQL com o Chef

Instalação guiada

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Baixar o cookbook do Chef

Substituir os atributos padrão

PostgreSQL ou Aurora no AWS RDS

Faça o upload do cookbook do Chef

Atualizar a run list

Encontre e use seus dados

Documentação relacionada

Introdução ao monitoramento do PostgreSQL com NRDOT

Instalação da CLI

Instalação via Ansible

Instalação do chart do Helm

Pré-requisitos