Esta guía asume que has configurado la Monitorización de base de datos para tus bases de datos de Amazon Aurora Postgres o MySQL.

Antes de empezar

Bases de datos compatibles

Postgres, MySQL

Versiones compatibles del Agent

7.53.0+

Información general

Autodiscovery de Datadog te permite configurar la monitorización en infraestructuras dinámicas. Puedes utilizar esta función para monitorizar tus clústeres de Aurora sin tener que enumerar endpoints de host de base de datos individuales (por ejemplo, postgres.d/conf.yaml). Esto es especialmente útil para clústeres que utilizan Aurora Auto Scaling, que ajusta dinámicamente el número de réplicas de Aurora en respuesta a variaciones en la conectividad o la carga de trabajo. Autodiscovery descubre y monitoriza automáticamente tanto las instancias de endpoint primario como las de réplica.

Con Autodiscovery y la Monitorización de base de datos, puedes definir plantillas de configuración para checks de Postgres o MySQL y especificar a qué clústeres aplicar cada check.

Habilitación de Autodiscovery para clústeres de Aurora

1. Conceder permisos de AWS
2. Configurar etiquetas de Aurora
3. Configurar el Datadog Agent
4. Crear una plantilla de configuración

Conceder permisos a AWS

Datadog Agent requiere permiso para ejecutar rds:DescribeDBClusters y rds:DescribeDBInstances en tu cuenta de AWS. Datadog recomienda que adjuntes una política de rol de IAM a la instancia EC2 donde se ejecuta el Agent.

Una política de ejemplo que concede estos permisos:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "rds:DescribeDBClusters",
        "rds:DescribeDBInstances"
      ],
      "Resource": [
        "arn:aws:rds:<region>:<account>:cluster:*",
        "arn:aws:rds:<region>:<account>:db:*"
      ]
    }
  ]
}

También puedes adjuntar la política AmazonRDSReadOnlyAccess.

Configurar etiquetas de Aurora

Por defecto, el receptor descubre todos los clústeres de Aurora de la cuenta y la región en la que se ejecuta el Agent que tengan aplicado la etiqueta datadoghq.com/scrape:true. También puedes configurar el Agent para descubrir clústeres con etiquetas específicas.

Debes aplicar estas etiquetas al clúster de base de datos (Rol: Regional cluster). Para obtener más información sobre etiquetado de recursos de RDS, consulta la documentación de AWS.

Configurar el Datadog Agent

Autodiscovery utiliza un receptor de servicios del Agent, que descubre todos los endpoints de host de la base de datos en un clúster de Aurora y reenvía los endpoints descubiertos al pipeline de programación de check del Agent existente. Puedes configurar el receptor en el archivo datadog.yaml:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true

Nota: Agent solo descubre instancias de Aurora que se ejecutan en la misma región que el Agent. Para determinar la región de la instancia, el Agent utiliza IMDS (Instance Metadata Service). Si tu instancia EC2 requiere IMDSv2, debes configurar el Agent para utilizar IMDSv2 estableciendo ec2_prefer_imdsv2: true en datadog.yaml, como se muestra a continuación:

ec2_prefer_imdsv2: true
database_monitoring:
  autodiscovery:
    aurora:
      enabled: true

Por defecto, el receptor solo descubre clústeres de Aurora en la cuenta y la región donde se ejecuta el Agent, y solo aquellos con la etiqueta datadoghq.com/scrape:true. También puedes configurar el receptor para descubrir clústeres con etiquetas específicas.

Para especificar etiquetas personalizadas para el descubrimiento de clústeres de Aurora en el archivo datadog.yaml:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true
      tags:
        - "my-cluster-tag-key:value"

El receptor consulta la API de AWS para la lista de hosts en un bucle. La frecuencia con la que el receptor consulta la API de AWS, en segundos, es configurable en el archivo datadog.yaml:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true
      discovery_interval: 300

Crear una plantilla de configuración

Datadog Agent admite plantillas de configuración para integraciones de Postgres y MySQL. Define una plantilla de configuración para los clústeres de Aurora que desees monitorizar.

ad_identifiers:
  - _dbm_postgres_aurora

ad_identifiers:
  - _dbm_postgres_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    dbm: true
    aws:
      instance_endpoint: "%%host%%"
      region: "%%extra_region%%"
    tags:
    - "dbclusteridentifier:%%extra_dbclusteridentifier%%"
    - "region:%%extra_region%%"

ad_identifiers:
  - _dbm_postgres_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    dbm: true
    aws:
      instance_endpoint: "%%host%%"
      region: "%%extra_region%%"
      managed_authentication:
        enabled: "%%extra_managed_authentication_enabled%%"
    tags:
      - "dbclusteridentifier:%%extra_dbclusteridentifier%%"
      - "region:%%extra_region%%"

ad_identifiers:
  - _dbm_mysql_aurora

ad_identifiers:
  - _dbm_mysql_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    dbm: true
    aws:
      instance_endpoint: "%%host%%"
    tags:
    - "dbclusteridentifier:%%extra_dbclusteridentifier%%"
    - "region:%%extra_region%%"

Para obtener más información sobre la configuración de Autodiscovery con integraciones, consulta la documentación deAutodiscovery .

Variables de plantilla compatibles