Compatibilidad y requisitos previos

Antes de comenzar a monitorear su MySQL con NRDOT, asegúrese de que su entorno cumpla con estos requisitos.

Requisitos previos

Antes de comenzar, cerciorar de tener lo siguiente:

Una clave de licenciade New Relic válida
Conectividad de red entre el host donde instala el NRDOT Collector y su base de datos MySQL. Si planea instalar el NRDOT Collector en un host diferente al de su base de datos MySQL, consulte los Requisitos de acceso a la red.
Conectividad de red a la documentación de los extremos OTLP de New Relic

Versiones de MySQL admitidas

El receptor detecta el producto y la versión de la base de datos en la primera conexión y ajusta su comportamiento en consecuencia. Las versiones no compatibles o más antiguas siguen funcionando, pero con funcionalidad reducida:

Versiones	Planes de consulta en `db.server.top_query`	Propagación de traceparent	`client.port` / `network.peer.port`	Sintaxis de estado de réplica
`8.0.3`–`8.0.21`	Sí	Sí	0	`SHOW SLAVE STATUS`
`8.0.22+`	Sí	Sí	Completado	`SHOW REPLICA STATUS`
`8.4.x`	Sí	Sí	Completado	`SHOW REPLICA STATUS`
`9.x`	Sí	Sí	Completado	`SHOW REPLICA STATUS`

Requisitos de acceso a la red

Por defecto, NRDOT se conecta a través de TCP (transport: tcp en la configuración del receptor, el valor por defecto). Si el recolector se ejecuta en el mismo host que la base de datos, en su lugar puede establecer transport: unix y apuntar endpoint al socket de dominio Unix de la base de datos (por ejemplo, /var/run/mysqld/mysqld.sock), lo que evita por completo las comprobaciones de red a continuación. Para cualquier otro despliegue (recolector y base de datos en diferentes hosts, contenedores o VPC), se requiere TCP.

Despliegue	Qué revisar
MySQL autoadministrado en EC2	Grupo de seguridad: agregue una regla de entrada en el puerto de la base de datos (predeterminado `3306`) desde el origen del recolector: su propio ID de grupo de seguridad (misma VPC, preferible a una IP sin procesar) si el recolector se ejecuta en una instancia EC2 diferente, o no se necesita ninguna regla si se ejecuta como sidecar en la misma instancia. Verifique también `bind-address` en `my.cnf`: muchas distribuciones incluyen por defecto `bind-address = 127.0.0.1`, que rechaza cualquier conexión TCP no local. Establézcalo en la IP privada de la instancia o en `0.0.0.0` antes de que un recolector remoto pueda acceder a él.
Amazon RDS/Aurora para MySQL	Grupo de seguridad de VPC: agregue una regla de entrada en el puerto de la instancia de RDS (predeterminado `3306`) desde el grupo de seguridad del recolector o la IP privada; RDS no tiene `my.cnf` a nivel de sistema operativo para editar, por lo que esta es la única puerta de red. Los permisos deben provenir del usuario maestro de RDS. RDS no tiene una cuenta `root`. Privilegios restringidos: `SUPER` y `FILE` están restringidos o no están disponibles según la versión del motor de RDS y el grupo de parámetros. TLS: las instancias de RDS con la imposición de “Require SSL/TLS” necesitan que el recolector confíe en la CA de RDS de Amazon. Establezca `tls.ca_file` (o `tls.ca_pem`) en el paquete de certificados de Amazon RDS y deje `tls.insecure`/`tls.insecure_skip_verify` en `false`.
Cualquier despliegue remoto/entre hosts	MySQL trata `'<user>'@'localhost'` y `'<user>'@'%'` (o un host/CIDR específico) como cuentas diferentes, incluso con un nombre de usuario idéntico. Crear el usuario de monitoreo como `'<user>'@'localhost'` falla silenciosamente al autenticar desde un recolector que se ejecuta en cualquier otro lugar, con un error de acceso denegado indistinguible de una contraseña incorrecta. Use `'<user>'@'%'` o limítelo a la IP/CIDR privada específica del recolector.

Importante

Verificado en una instancia activa de Amazon RDS para MySQL: la familia de grupos de parámetros mysql8.0 de RDS no expone parámetros performance_schema_consumer_* en absoluto; solo los parámetros de tamaño/búfer, además de performance_schema, slow_query_log y long_query_time, se pueden configurar allí. Esto significa que events_waits_current (necesario para mysql.events_waits_current.timer_wait y para los dashboards basados en esperas en general) solo se puede activar en tiempo de ejecución en RDS, y no sobrevive a un reinicio o conmutación por error.

Configuración del lado del servidor recomendada

Configure estos parámetros del servidor MySQL para garantizar que el receptor pueda recopilar todas las métricas y planes de consulta disponibles. La siguiente tabla enumera los parámetros y sus valores recomendados:

Parámetro	Valor recomendado	Por qué
`performance_schema`	Activado	Las muestras de consultas, las consultas principales y la detección de bloqueos dependen de ello
`max_digest_length`	`4096`	Texto de resumen más largo antes de que MySQL lo trunque
`performance_schema_max_digest_length`	`4096`	Igual, en la capa del esquema de rendimiento
`performance_schema_max_sql_text_length`	`4096`	Si una sentencia capturada se trunca, el receptor omite `EXPLAIN` para ella por completo. Los planes de consulta desaparecen silenciosamente para sentencias largas en el valor predeterminado de `1024`bytes

Próximos pasos

Una vez que haya verificado que su entorno cumple con estos requisitos previos:

Elija su método de instalación:

Revise las métricas disponibles que se recopilarán
Consulte Habilitar información valiosa detallada para conocer características opcionales como los planes de consulta de sentencias de escritura y el seguimiento de la duración de la espera de bloqueo
Consulte la guía de resolución de problemas para problemas comunes