Host

Para configurar este check para un Agent que se ejecuta en un host:

Edita el archivo MySQL.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para empezar a recopilar tus métricas y logs de MySQL.

Para obtener una lista completa de las opciones de configuración disponibles, consulta el ejemplo mysql.d/conf.yaml.

Recopilación de métricas

• Añade este bloque de configuración a tu mysql.d/conf.yaml para recopilar tus métricas de MySQL:

  init_config:
  
  instances:
    - host: 127.0.0.1
      username: datadog
      password: "<YOUR_CHOSEN_PASSWORD>" # from the CREATE USER step earlier
      port: "<YOUR_MYSQL_PORT>" # e.g. 3306
      options:
        replication: false
        galera_cluster: true
        extra_status_metrics: true
        extra_innodb_metrics: true
        schema_size_metrics: false
        disable_innodb_metrics: false
  

Nota: Escribe tu contraseña entre comillas simples en caso de que haya un carácter especial.

Para recopilar extra_performance_metrics, tu servidor de MySQL debe tener performance_schema activado, de lo contrario, configura extra_performance_metrics en false. Para obtener más información sobre performance_schema, consulta Inicio rápido del esquema de rendimiento de MySQL.

Nota: El usuario datadog debe establecerse en la configuración de la integración de MySQL como host: 127.0.0.1 en lugar de localhost. Como alternativa, también puedes utilizar sock.

Reinicia el Agent para empezar a enviar métricas de MySQL a Datadog.

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

1. De manera predeterminada, MySQL registra todo en /var/log/syslog que requiere acceso raíz para la lectura. Para que los logs sean más accesibles, sigue estos pasos:

   • Edita /etc/mysql/conf.d/mysqld_safe_syslog.cnf y elimina o comenta las líneas.

   • Edita /etc/mysql/my.cnf y añade las siguientes líneas para activar los logs de consultas generales, de error y lentas:

       [mysqld_safe]
       log_error = /var/log/mysql/mysql_error.log
     
       [mysqld]
       general_log = on
       general_log_file = /var/log/mysql/mysql.log
       log_error = /var/log/mysql/mysql_error.log
       slow_query_log = on
       slow_query_log_file = /var/log/mysql/mysql_slow.log
       long_query_time = 2
     

   • Guarda el archivo y reinicia MySQL con los siguientes comandos: service mysql restart

   • Asegúrate de que el Agent tiene acceso de lectura al directorio /var/log/mysql y a todos los archivos que contiene. Vuelve a controlar tu configuración de logrotate para asegurarte de que esos archivos se tienen en cuenta y que los permisos se establecen correctamente allí también.

   • En /etc/logrotate.d/mysql-server debería haber algo parecido a:

       /var/log/mysql.log /var/log/mysql/mysql.log /var/log/mysql/mysql_slow.log {
               daily
               rotate 7
               missingok
               create 644 mysql adm
               Compress
       }
     

2. La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

3. Añade este bloque de configuración a tu archivo mysql.d/conf.yaml para empezar a recopilar logs de MySQL:

   logs:
     - type: file
       path: "<ERROR_LOG_FILE_PATH>"
       source: mysql
       service: "<SERVICE_NAME>"
   
     - type: file
       path: "<SLOW_QUERY_LOG_FILE_PATH>"
       source: mysql
       service: "<SERVICE_NAME>"
       log_processing_rules:
         - type: multi_line
           name: new_slow_query_log_entry
           pattern: "# Time:"
           # If mysqld was started with `--log-short-format`, use:
           # pattern: "# Query_time:"
           # If using mysql version <5.7, use the following rules instead:
           # - type: multi_line
           #   name: new_slow_query_log_entry
           #   pattern: "# Time|# User@Host"
           # - type: exclude_at_match
           #   name: exclude_timestamp_only_line
           #   pattern: "# Time:"
   
     - type: file
       path: "<GENERAL_LOG_FILE_PATH>"
       source: mysql
       service: "<SERVICE_NAME>"
       # For multiline logs, if they start by the date with the format yyyy-mm-dd uncomment the following processing rule
       # log_processing_rules:
       #   - type: multi_line
       #     name: new_log_start_with_date
       #     pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])
       # If the logs start with a date with the format yymmdd but include a timestamp with each new second, rather than with each log, uncomment the following processing rule
       # log_processing_rules:
       #   - type: multi_line
       #     name: new_logs_do_not_always_start_with_timestamp
       #     pattern: \t\t\s*\d+\s+|\d{6}\s+\d{,2}:\d{2}:\d{2}\t\s*\d+\s+
   

   Consulta el ejemplo mysql.yaml para conocer todas las opciones de configuración disponibles, incluidas las de métricas personalizadas.

4. Reinicia el Agent.

Docker

Para configurar este check para un Agent que se ejecuta en un contenedor:

Recopilación de métricas

Configura Plantillas de integración de Autodiscovery como etiquetas de Docker en tu contenedor de aplicaciones:

LABEL "com.datadoghq.ad.check_names"='["mysql"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"server": "%%host%%", "username": "datadog","password": "<UNIQUEPASSWORD>"}]'

Consulta variables de plantillas de Autodiscovery para obtener más detalles sobre el uso de <UNIQUEPASSWORD> como variable de entorno en lugar de una etiqueta.

Recopilación de logs

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent . Para activarla, consulta Recopilación de logs de Docker.

A continuación, configura Integraciones de logs como etiquetas de Docker:

LABEL "com.datadoghq.ad.logs"='[{"source":"mysql","service":"mysql"}]'

Kubernetes

Para Configurar este check para un Agent que se ejecuta en Kubernetes:

Recopilación de métricas

Configura Plantillas de integraciones de Autodiscovery como anotaciones de pod en tu contenedor de aplicaciones. Alternativamente, puedes configurar plantillas con un archivo, mapa de configuración o almacenamiento de valores de claves.

Annotations v1 (para el Datadog Agent < v7.36)

apiVersion: v1
kind: Pod
metadata:
  name: mysql
  annotations:
    ad.datadoghq.com/mysql.check_names: '["mysql"]'
    ad.datadoghq.com/mysql.init_configs: '[{}]'
    ad.datadoghq.com/mysql.instances: |
      [
        {
          "server": "%%host%%", 
          "username": "datadog",
          "password": "<UNIQUEPASSWORD>"
        }
      ]
  labels:
    name: mysql
spec:
  containers:
    - name: mysql

Anotaciones v2 (para el Datadog Agent v7.36 o posterior)

apiVersion: v1
kind: Pod
metadata:
  name: mysql
  annotations:
    ad.datadoghq.com/mysql.checks: |
      {
        "mysql": {
          "instances": [
            {
              "server": "%%host%%", 
              "username": "datadog",
              "password": "<UNIQUEPASSWORD>"
            }
          ]
        }
      }
  labels:
    name: mysql
spec:
  containers:
    - name: mysql

Consulta variables de plantilla de Autodiscovery para más detalles sobre el uso de <UNIQUEPASSWORD> como variable de entorno en lugar de una etiqueta.

Recopilación de logs

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta Recopilación de logs de Kubernetes.

A continuación, configura Integraciones de logs como anotaciones del pod. Alternativamente, puedes configurar esto con un archivo, mapa de configuración o almacenamiento de valores de claves.

Annotations v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: mysql
  annotations:
    ad.datadoghq.com/mysql.logs: '[{"source": "mysql", "service": "mysql"}]'
  labels:
    name: mysql

ECS

Para configurar este check para un Agent que se ejecuta en ECS:

Recopilación de métricas

Configura Plantillas de integraciones de Autodiscovery como etiquetas de Docker en el contenedor de tu aplicación:

{
  "containerDefinitions": [{
    "name": "mysql",
    "image": "mysql:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"mysql\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"server\": \"%%host%%\", \"username\": \"datadog\",\"password\": \"<UNIQUEPASSWORD>\"}]"
    }
  }]
}

Consulta variables de plantilla de Autodiscovery para obtener más detalles sobre el uso de <UNIQUEPASSWORD> como variable de entorno en lugar de una etiqueta.

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent. Para activarla, consulta Recopilación de logs de ECS.

A continuación, configura Integraciones de logs como etiquetas de Docker:

{
  "containerDefinitions": [{
    "name": "mysql",
    "image": "mysql:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"mysql\",\"service\":\"mysql\"}]"
    }
  }]
}