Instale e configure o NRDOT para o monitoramento do MySQL com o Chef

É possível instalar e configurar o NRDOT Collector para o monitoramento do MySQL usando o cookbook do Chef newrelic-install. O cookbook instala o coletor, cria o usuário de monitoramento e configura o coletor ao executar a receita newrelic-install::default.

Instalação guiada

Para instalar pela interface da New Relic, acesse one.newrelic.com > Integrations & Agents > MySQL (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.
MySQL 5.7 ou superior.
Chef 15 ou posterior.
Um host coletor Linux executando Debian/Ubuntu ou RHEL/CentOS.
Para MySQL auto-hospedado: acesso administrativo ao seu servidor MySQL (a conta root ou equivalente), usando autenticação baseada em senha.
Para MySQL 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 e pré-requisitos.

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 MySQL 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 um arquivo de segredos (KEY=VALUE) com um login e senha de administrador 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-mysql'
]
default['newrelic_install']['env']['NR_CLI_MYSQL_CONFIG_PRESET']  = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_MYSQL_INSTANCES_FILE'] = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_MYSQL_SECRETS_FILE']   = <path to the secrets file (KEY=VALUE per instance) on the node>
# See all available targets at: https://github.com/newrelic/chef-install

Importante

O cookbook se conecta ao MySQL via TCP usando uma senha, portanto, a conta de administrador no arquivo de segredos deve usar autenticação baseada em senha. Em algumas instalações do Debian/Ubuntu, root@localhost usa o plug-in auth_socket por padrão (sem senha, apenas soquete local), o que não funcionará neste caso. É necessário alterá-lo antes de executar a receita:

bash

$mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<password>';"

Atributo (em `env`)	Descrição	Padrão
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuração do NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.	Nenhum
`NR_CLI_MYSQL_SECRETS_FILE`	Obrigatório. Caminho para o arquivo de segredos (`KEY=VALUE`, um par de login/senha de administrador por instância), já presente no nó.	Nenhum

Atributo (em env)

Descrição

Padrão

NR_CLI_MYSQL_CONFIG_PRESET

Configuração do NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.

Nenhum

NR_CLI_MYSQL_SECRETS_FILE

Obrigatório. Caminho para o arquivo de segredos (KEY=VALUE, um par de login/senha de administrador por instância), já presente no nó.

Nenhum

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 MySQL a partir deste coletor, adicione mais entradas ao arquivo de instância e credenciais numeradas correspondentes (_2, _3,...) ao arquivo de segredos. Uma instância que falha em suas verificações é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Este cookbook monitora um ou mais endpoints do RDS MySQL ou Aurora a partir de um único coletor, usando o mesmo padrão de arquivo de instâncias/arquivo de segredos que a versão auto-hospedada (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-mysql-rds'
]
default['newrelic_install']['env']['NR_CLI_MYSQL_CONFIG_PRESET']  = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_MYSQL_INSTANCES_FILE'] = <path to the instances YAML file on the node, using RDS endpoints as host>
default['newrelic_install']['env']['NR_CLI_MYSQL_SECRETS_FILE']   = <path to the secrets file (KEY=VALUE per instance) on the node>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (em `env`)	Descrição	Padrão
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuração do NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instância, usando endpoints do RDS como `host`, já presente no nó.	Nenhum
`NR_CLI_MYSQL_SECRETS_FILE`	Obrigatório. Caminho para o arquivo de segredos (`KEY=VALUE`, um par de nome de usuário mestre/senha do RDS por instância), já presente no nó.	Nenhum

Atributo (em env)

Descrição

Padrão

NR_CLI_MYSQL_CONFIG_PRESET

Configuração do NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instância, usando endpoints do RDS como host, já presente no nó.

Nenhum

NR_CLI_MYSQL_SECRETS_FILE

Obrigatório. Caminho para o arquivo de segredos (KEY=VALUE, um par de nome de usuário mestre/senha do RDS por instância), já presente no nó.

Nenhum

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 MySQL ou Aurora a partir deste coletor, adicione mais entradas ao arquivo de instância e credenciais numeradas correspondentes ao arquivo de segredos. Uma instância que falha em suas verificações é 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 MySQL por meio da interface do New Relic.

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

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

Introdução ao monitoramento do MySQL com NRDOT

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

Instalação da CLI

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

Instalação via Ansible

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

Instalação do chart do Helm

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

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

Instale e configure o NRDOT para o monitoramento do MySQL 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

MySQL 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 MySQL com NRDOT

Instalação da CLI

Instalação via Ansible

Instalação do chart do Helm

Pré-requisitos