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.

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

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

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

tls.ca_pem

) en el

paquete de certificados de Amazon RDS

y deje

tls.insecure

tls.insecure_skip_verify

false

Cualquier despliegue remoto/entre hosts

MySQL trata

'<user>'@'localhost'

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