Instalar e configurar o NRDOT para monitoramento do MySQL com a CLI

Você pode instalar e configurar o NRDOT Collector para o monitoramento do MySQL usando a CLI da New Relic. A CLI instala o coletor, cria o usuário de monitoramento e configura o coletor em um único comando.

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.
Um host coletor Linux executando Debian/Ubuntu ou RHEL/CentOS, com curl e systemd instalados e o cliente mysql disponível.
Para MySQL auto-hospedado: acesso administrativo ao seu servidor MySQL (a conta root ou equivalente).
Para o AWS RDS/Aurora MySQL: conectividade de rede do host do coletor para o endpoint do RDS (acesso de entrada na porta do MySQL no grupo de segurança do RDS) e o nome de usuário e a 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.

Instale e configure o NRDOT Collector

Esta receita monitora uma ou mais instâncias do MySQL a partir de um único coletor. Em vez de solicitar um único conjunto de host/porta/credencial, ela lê dois arquivos criados previamente: 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.

Crie o arquivo de instâncias. Adicione uma entrada por instância do MySQL que deseja que este coletor monitore; apenas uma entrada se estiver executando somente uma única instância:
bash
```
$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: localhost
$    port: 3306
$    login_name: newrelic
$EOF
```

Crie o arquivo de segredos com um login de administrador (qualquer usuário administrador com acesso total serve; não precisa ser root) e senha para cada instância, indexado para corresponder à ordem do arquivo de instância:

bash

$umask 077
$cat > ~/mysql-secrets.env << 'EOF'
$NR_CLI_MYSQL_ADMIN_USER_1=root
$NR_CLI_MYSQL_ADMIN_PASSWORD_1=YourRootPassword1
$EOF
$chmod 600 ~/mysql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mysql

Importante

Este instalador se conecta ao MySQL via TCP usando uma senha, portanto, a conta de administrador no seu arquivo de segredos deve usar autenticação baseada em senha. Em algumas instalações do Debian/Ubuntu, root@localhost usa por padrão o plug-in auth_socket (sem senha, apenas soquete local), o que não funcionará aqui. Altere-o primeiro executando isto localmente como root:

bash

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

Se isso falhar com Access denied, o pacote mysql-server também cria uma conta debian-sys-maint com credenciais de administrador conhecidas em /etc/mysql/debian.cnf. Use-o em vez disso:

bash

$mysql --defaults-file=/etc/mysql/debian.cnf -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<password>';"

A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

Variável	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.	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).	Nenhum

Variável

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.

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).

Nenhum

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. A instalação só falha totalmente se nenhuma instância passar.

Esta receita 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 o auto-hospedado.

Crie o arquivo de instâncias, usando o endpoint do RDS como host; apenas uma entrada se estiver monitorando somente uma única instância do RDS:

bash

$cat > ~/mysql-instances.yml << 'EOF'
$instances:
$  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
$    port: 3306
$    login_name: newrelic
$EOF

Crie o arquivo de segredos com o nome de usuário e a senha mestre do RDS para cada instância, indexado para corresponder à ordem do arquivo de instâncias:

bash

$umask 077
$cat > ~/mysql-secrets.env << 'EOF'
$NR_CLI_MYSQL_ADMIN_USER_1=admin
$NR_CLI_MYSQL_ADMIN_PASSWORD_1=YourMasterPassword1
$EOF
$chmod 600 ~/mysql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mysql-rds

A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

Variável	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, usando endpoints do RDS como `host` .	Nenhum
`NR_CLI_MYSQL_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).	Nenhum

Variável

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, usando endpoints do RDS como

host

Nenhum

NR_CLI_MYSQL_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).

Nenhum

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.

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.
Para confirmar que os dados estão chegando, execute esta consulta no criador de consulta:
```
SELECT count(*) FROM Metric
WHERE metricName LIKE 'mysql.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago
```

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 via Ansible

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

Instalação via Chef

Aprenda a instalar e configurar o monitoramento do MySQL em escala com o cookbook newrelic-install do Chef.

Instalação do chart do Helm

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

Instalação do Docker

Saiba como executar o NRDOT Collector como um contêiner irmão de uma instância do MySQL já em execução no Docker.

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

Instalar e configurar o NRDOT para monitoramento do MySQL com a CLI

Instalação guiada

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

Instale e configure o NRDOT Collector

AWS RDS/Aurora MySQL

Encontre e use seus dados

Documentação relacionada

Introdução ao monitoramento do MySQL com NRDOT

Instalação via Ansible

Instalação via Chef

Instalação do chart do Helm

Instalação do Docker

Pré-requisitos