Instalar y configurar NRDOT para el monitoreo de MySQL con Ansible

Puede instalar y configurar el Collector de NRDOT para el monitoreo de MySQL mediante el rol de Ansible newrelic.newrelic_install. El rol instala el recolector, crea el usuario de monitoreo y configura el recolector en una sola ejecución.

Instalación guiada

Para instalar a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > MySQL (Database 360) . Esta página solo cubre la instalación manual.

Requisitos previos

Una cuenta de New Relic con una clave de licencia válida.
Un ID de cuenta de New Relic.
MySQL 5.7 o posterior.
Ansible Core 2.13 o 2.14, Python 3.10 y las colecciones ansible.windows y ansible.utils.
Un host recolector de Linux que ejecuta Debian/Ubuntu o RHEL/CentOS.
Para MySQL autohospedado: acceso administrativo al servidor de MySQL (la cuenta root o equivalente), mediante autenticación basada en contraseña.
Para MySQL o Aurora en AWS RDS: conectividad de red desde el host del recolector hasta el extremo de RDS, y el nombre de usuario y la contraseña maestros de RDS.
Conectividad de red al extremo OTLP de New Relic para su región.
Para obtener información detallada sobre los requisitos, consulte Compatibilidad y requisitos previos.

Instale el rol

bash

$ansible-galaxy install newrelic.newrelic_install

Asegúrese de que las colecciones requeridas también estén instaladas:

bash

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

Configure el playbook

Este rol monitorea una o más instancias de MySQL desde un solo recolector. En lugar de un solo conjunto de host/puerto/credenciales, lee dos archivos que ya deben existir en el host objetivo: un archivo de instancias (YAML) que enumera cada instancia a monitorear y un archivo de secretos (KEY=VALUE) con un inicio de sesión y contraseña de administrador para cada una, indexados para que coincidan. Consulte la página de instalación de la CLI para conocer los formatos de archivo exactos.

Cree un archivo denominado playbook.yml y copie el siguiente contenido en él. Establezca targets en mysql-otel y reemplace los valores del marcador de posición por los suyos:

- 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

El rol se conecta a MySQL a través de TCP mediante una contraseña, por lo que la cuenta de administrador en el archivo de secretos debe usar autenticación basada en contraseña. En algunas instalaciones de Debian/Ubuntu, root@localhost usa por defecto el plug-in auth_socket (sin contraseña, solo socket local), lo cual no funcionará aquí. Cámbielo antes de ejecutar el playbook:

bash

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

Sugerencia

Para habilitar el logging de depuración, agregue verbosity: "debug" debajo de vars en el playbook.

Variable	Descripción	Por defecto
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.	Ninguno
`NR_CLI_MYSQL_SECRETS_FILE`	Obligatorio. Ruta al archivo de secretos ( `KEY=VALUE` , un par de inicio de sesión/contraseña de administrador por instancia), ya presente en el host objetivo.	Ninguno

Variable

Descripción

Por defecto

NR_CLI_MYSQL_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.

Ninguno

NR_CLI_MYSQL_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

, un par de inicio de sesión/contraseña de administrador por instancia), ya presente en el host objetivo.

Ninguno

Sugerencia

Para monitorear más de una instancia de MySQL desde este recolector, agregue más entradas al archivo de instancia y las credenciales numeradas correspondientes (_2, _3,...) al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este rol monitorea uno o más extremos de RDS MySQL o Aurora desde un único recolector, utilizando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado (ambos archivos ya deben existir en el host objetivo). Cree un archivo denominado playbook.yml y copie el siguiente contenido en él. Establezca targets en mysql-otel-rds y reemplace los valores del marcador de posición por los suyos:

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

Sugerencia

Para habilitar el logging de depuración, agregue verbosity: "debug" debajo de vars en el playbook.

Variable	Descripción	Por defecto
`NR_CLI_MYSQL_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MYSQL_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancias, utilizando extremos de RDS como `host` , ya presente en el host objetivo.	Ninguno
`NR_CLI_MYSQL_SECRETS_FILE`	Obligatorio. Ruta al archivo de secretos ( `KEY=VALUE` , un par de nombre de usuario/contraseña maestro de RDS por instancia), ya presente en el host objetivo.	Ninguno

Variable

Descripción

Por defecto

NR_CLI_MYSQL_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MYSQL_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancias, utilizando extremos de RDS como

host

, ya presente en el host objetivo.

Ninguno

NR_CLI_MYSQL_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

, un par de nombre de usuario/contraseña maestro de RDS por instancia), ya presente en el host objetivo.

Ninguno

Sugerencia

Para monitorear más de un extremo de RDS MySQL o Aurora desde este recolector, agregue más entradas al archivo de instancias y credenciales numeradas coincidentes al archivo de secretos. Una instancia que falla sus comprobaciones se omite con un motivo registrado en lugar de abortar toda la instalación.

Ejecute el playbook

bash

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

Encuentra y utiliza tus datos

Una vez que sus datos se estén recopilando, puede acceder al monitoreo integral de bases de datos MySQL a través de la UI de New Relic.

Para encontrar su entidad de base de datos MySQL en New Relic:

Vaya a one.newrelic.com > All capabilities > Databases.
En el menú desplegable Entity type, seleccione MySQL instance y luego haga clic en Apply.
Seleccione su base de datos MySQL de la lista de entidades.

Introducción al monitoreo de MySQL con NRDOT

Conozca todos los métodos de instalación disponibles para el monitoreo de MySQL con New Relic.

Instalación de la CLI

Aprenda a instalar y configurar el monitoreo de MySQL con un solo comando de la CLI de New Relic.

Instalación con Chef

Aprenda a instalar y configurar el monitoreo de MySQL a escala con el cookbook de Chef newrelic-install.

Instalación del chart de Helm

Aprenda a instalar y configurar el monitoreo de MySQL en Kubernetes con el chart de Helm mysql-otel.

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de MySQL con Ansible

Instalación guiada

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Instale el rol

Configure el playbook

MySQL o Aurora en AWS RDS

Ejecute el playbook

Encuentra y utiliza tus datos

Documentación relacionada

Introducción al monitoreo de MySQL con NRDOT

Instalación de la CLI

Instalación con Chef

Instalación del chart de Helm

Requisitos previos