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 iniciar la recopilación de tus métricas y logs de MySQL.

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

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 habilitado performance_schema; 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 el Agent versión 6.0 o posterior

1. Por defecto, MySQL loguea 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 por defecto en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

3. Añade este bloque de configuración en tu archivo mysql.d/conf.yaml para empezar a recopilar tus 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+
   

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

4. Reinicia el Agent.

Docker

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

Recopilación de métricas

Establece plantillas de integración de Autodiscovery como etiquetas de Docker en tu contenedor de aplicación:

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 las variables de plantilla de Autodiscovery para obtener más detalles sobre cómo usar <UNIQUEPASSWORD> como una variable de entorno en lugar de una etiqueta (label).

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

A continuación, establece integraciones de log 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

Establece plantillas de integraciones de Autodiscovery como anotaciones de pod en tu contenedor de aplicación. Alternativamente, puedes configurar plantillas con un archivo, configmap, o almacén de clave-valor.

Anotaciones v1 (para el Datadog Agent v7.36 o anterior)

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 las variables de plantilla de Autodiscovery para obtener más detalles sobre cómo usar <UNIQUEPASSWORD> como una 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, establece integraciones de log como anotaciones del pod. Alternativamente, puedes configurar esto con un archivo, configmap, o almacén de clave-valor.

Anotaciones 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

Establece las 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 las variables de plantilla de Autodiscovery para obtener más detalles sobre cómo usar <UNIQUEPASSWORD> como una variable de entorno en lugar de una etiqueta.

Recopilación de logs

Disponible para el Agent versión 6.0 o posterior

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

A continuación, establece integraciones de log como etiquetas de Docker:

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