Instalar & configurar o NRDOT para monitoramento do MySQL com Ansible

Você pode instalar e configurar o NRDOT Collector para monitoramento do MySQL usando a role newrelic.newrelic_install do Ansible. A role instala o coletor, cria o usuário de monitoramento e configura o coletor em uma única play.

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.
Ansible Core 2.13 ou 2.14, Python 3.10 e as coleções ansible.windows e ansible.utils.
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.

Instale a função

bash

$ansible-galaxy install newrelic.newrelic_install

Certifique-se de que as coleções necessárias também estejam instaladas:

bash

$ansible-galaxy collection install ansible.windows ansible.utils

Configure o playbook

Esta role 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 host de destino: um arquivo de instância (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 ver os formatos exatos dos arquivos.

Crie um arquivo chamado playbook.yml e copie o seguinte conteúdo para ele. Defina targets como mysql-otel e substitua os valores de espaço reservado pelos seus:

- name: Install New Relic NRDOT for MySQL
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - mysql-otel
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_MYSQL_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_MYSQL_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_MYSQL_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

Importante

A função 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 antes de executar o playbook:

bash

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

Dica

Para habilitar o logging de depuração, adicione verbosity: "debug" em vars no playbook.

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, já presente no host de destino.	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 host de destino.	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, já presente no host de destino.

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 host de destino.

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.

Esta função 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 (ambos os arquivos já devem existir no host de destino). Crie um arquivo chamado playbook.yml e copie o seguinte conteúdo para ele. Defina targets como mysql-otel-rds e substitua os valores de espaço reservado pelos seus:

- name: Install New Relic NRDOT for MySQL on RDS
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - mysql-otel-rds
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_MYSQL_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>
    NR_CLI_MYSQL_INSTANCES_FILE: <path to the instances YAML file on the target host, using RDS endpoints as host>
    NR_CLI_MYSQL_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

Dica

Para habilitar o logging de depuração, adicione verbosity: "debug" em vars no playbook.

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ância, usando endpoint do RDS como `host` , já presente no host de destino.	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), já presente no host de destino.	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ância, usando endpoint do RDS como

host

, já presente no host de destino.

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), já presente no host de destino.

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.

Execute o playbook

bash

$ansible-playbook -i <inventory_file> <playbook_file>.yml

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

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

Instalar & configurar o NRDOT para monitoramento do MySQL com Ansible

Instalação guiada

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

Instale a função

Configure o playbook

MySQL ou Aurora no AWS RDS

Execute o playbook

Encontre e use seus dados

Documentação relacionada

Introdução ao monitoramento do MySQL com NRDOT

Instalação da CLI

Instalação via Chef

Instalação do chart do Helm

Pré-requisitos