Instalar y configurar NRDOT para el monitoreo de MySQL con Chef

Puede instalar y configurar el Collector de NRDOT para el monitoreo de MySQL mediante el libro de recetas de Chef newrelic-install. El libro de recetas instala el recolector, crea el usuario de monitoreo y configura el recolector cuando ejecuta la receta newrelic-install::default.

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.
Chef 15 o posterior.
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.

Descargar el cookbook de Chef

Descargue el cookbook de Chef newrelic-install desde Chef Supermarket al directorio del repositorio de Chef:

bash

$knife supermarket install newrelic-install

Reemplace los atributos predeterminados

Reemplace los atributos predeterminados en attributes/default.rb con los detalles de la cuenta:

Este cookbook monitorea una o más instancias de MySQL desde un único recolector. En lugar de un único conjunto de host/puerto/credencial, lee dos archivos que ya deben existir en el nodo: 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 coincidir. Consulte la página de instalación de la CLI para conocer los formatos de archivo exactos.

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

El cookbook 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 la receta:

bash

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

Atributo (bajo `env` )	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 instancia, ya presente en el nodo.	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 nodo.	Ninguno

Atributo (bajo

env

)

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 instancia, ya presente en el nodo.

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

Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

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 cookbook monitorea uno o más extremos de RDS MySQL o Aurora desde un solo recolector, usando el mismo patrón de archivo de instancias/archivo de secretos que la versión autohospedada (ambos archivos ya deben existir en el nodo).

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 (bajo `env` )	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 instancia, usando extremos de RDS como `host` , ya presente en el nodo.	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 nodo.	Ninguno

Atributo (bajo

env

)

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 instancia, usando extremos de RDS como

host

, ya presente en el nodo.

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

Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

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.

Cargue el cookbook de Chef

Cargue el cookbook de Chef newrelic-install en su servidor de Chef:

bash

$knife cookbook upload newrelic-install

Actualice la lista de ejecución

Agregue la receta newrelic-install a la lista de ejecución de un nodo:

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

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 Ansible

Aprenda a instalar y configurar el monitoreo de MySQL a escala con newrelic.newrelic_install rol de Ansible.

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 Chef

Instalación guiada

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

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

MySQL o Aurora en AWS RDS

Cargue el cookbook de Chef

Actualice la lista de ejecución

Encuentra y utiliza tus datos

Documentación relacionada

Introducción al monitoreo de MySQL con NRDOT

Instalación de la CLI

Instalación con Ansible

Instalación del chart de Helm

Requisitos previos