이 가이드에서는 Database Monitoring을 Amazon Aurora Postgres 또는 MySQL 데이터베이스에 대하여 구성한 것으로 가정합니다.

시작 전 참고 사항

지원되는 데이터베이스

Postgres, MySQL

지원되는 Agent 버전

7.53.0+

개요

Datadog의 Autodiscovery를 사용하면 동적 인프라에서 모니터링을 구성할 수 있습니다. 이 기능을 사용하면 개별적인 데이터베이스 호스트 엔드포인트(예: postgres.d/conf.yaml)를 목록으로 나열하지 않고도 Aurora 클러스터를 모니터링할 수 있습니다. 이것은 특히 연결성이나 워크로드 변동에 대응하여 Aurora Replicas의 수를 동적으로 조정하는 기능인 Aurora Auto Scaling을 사용하는 클러스터에 유용합니다. Autodiscovery는 기본 및 복제본 엔드포인트 인스턴스를 둘 다 자동으로 검색하고 모니터링합니다.

Autodiscovery 및 Database Monitoring을 사용하면 Postgres 또는 MySQL 검사에 대한 구성 템플릿을 정의하여 각 검사를 어느 클러스터에 적용할지 지정할 수 있습니다.

Aurora 클러스터에 대하여 Autodiscovery 활성화

1. AWS 권한 부여
2. Aurora 태그 구성
3. Datadog Agent 구성
4. 구성 템플릿 만들기

AWS 권한 부여

Datadog Agent에 AWS 계정에서 rds:DescribeDBClusters 및 rds:DescribeDBInstances를 실행할 권한이 필요합니다. Datadog에서는 Agent를 실행 중인 EC2 인스턴스에 IAM 역할 정책을 연결할 것을 권장합니다.

이러한 권한을 부여하는 정책의 예:

{
  "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:*"
      ]
    }
  ]
}

AmazonRDSReadOnlyAccess 정책을 연결할 수도 있습니다.

Aurora 태그 구성

리스너는 Agent가 실행 중인 계정과 리전에서 datadoghq.com/scrape:true 태그가 적용된 모든 Aurora 클러스터를 검색합니다. Agent가 특정 태그를 포함한 클러스터를 검색하도록 구성할 수도 있습니다.

이러한 태그를 DB 클러스터에 적용해야 합니다(역할: Regional cluster). RDS 리소스 태깅에 관한 자세한 내용은 AWS 설명서를 참조하세요.

tags를 빈 배열로 구성하면 Autodiscovery가 해당 계정 및 리전의 모든 클러스터를 검색합니다.

Datadog Agent 구성

Autodiscovery는 Agent 서비스 리스너를 사용하며, 이 리스너는 Aurora 클러스터의 모든 데이터베이스 호스트 엔드포인트를 검색하고 검색된 모든 엔드포인트를 기존 Agent 검사 스케줄링 파이프라인으로 전달합니다. 리스너는 datadog.yaml 파일에서 구성할 수 있습니다.

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true

참고: Agent는 Agent와 동일한 리전에서 실행 중인 Aurora 인스턴스만 검색합니다. Agent는 인스턴스의 리전을 판단하기 위해 IMDS(Instance Metadata Service)를 사용합니다. EC2 인스턴스에 IMDSv2가 필요한 경우, Agent가 IMDSv2를 사용하도록 구성해야 하며, 그러면 아래 표시된 것과 같이 datadog.yaml에서 ec2_prefer_imdsv2: true를 설정합니다.

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

By default, the listener only discovers Aurora clusters in the account and region where the Agent is running, and only those with the datadoghq.com/scrape:true tag. You can also configure the listener to discover clusters with specific tags.

To specify custom tags for Aurora cluster discovery in the datadog.yaml file:

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

To monitor all clusters in the account and region:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true
      tags: []

The listener queries the AWS API for the list of hosts in a loop. The frequency with which the listener queries the AWS API, in seconds, is configurable in the datadog.yaml file:

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

The listener provides an %%extra_dbm%% variable that can be used to enable or disable DBM for the instance. This value defaults to true if the tag datadoghq.com/dbm:true is present. To specify a custom tag for this value use dbm_tag:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true
      dbm_tag: "use_dbm:true"

The %%extra_dbm%% value is true if the tag is present, and false otherwise. It does not set its value to the value of the tag.

The listener provides an %%extra_global_view_db%% variable that can be used to set the global_view_db for the instance. This value defaults to the value of the tag datadoghq.com/global_view_db. To specify a custom tag for this value use global_view_db_tag:

database_monitoring:
  autodiscovery:
    aurora:
      enabled: true
      global_view_db_tag: "my_db_tag"

Create a configuration template

The Datadog Agent supports configuration templates for the Postgres and MySQL integrations. Define a configuration template for the Aurora clusters you wish to monitor.

ad_identifiers:
  - _dbm_postgres_aurora

ad_identifiers:
  - _dbm_postgres_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    dbm: "%%extra_dbm%%"
    database_autodiscovery:
      enabled: 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
    password: "ENC[datadog_user_database_password]"
    dbm: "%%extra_dbm%%"
    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_postgres_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    dbm: true
    database_autodiscovery:
      enabled: true
      global_view_db: "%%extra_global_view_db%%"
    aws:
      instance_endpoint: "%%host%%"
      region: "%%extra_region%%"
    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: "%%extra_dbm%%"
    aws:
      instance_endpoint: "%%host%%"
      region: "%%extra_region%%"
    tags:
    - "dbclusteridentifier:%%extra_dbclusteridentifier%%"
    - "region:%%extra_region%%"

ad_identifiers:
  - _dbm_mysql_aurora
init_config:
instances:
  - host: "%%host%%"
    port: "%%port%%"
    username: datadog
    password: "ENC[datadog_user_database_password]"
    dbm: "%%extra_dbm%%"
    aws:
      instance_endpoint: "%%host%%"
      region: "%%extra_region%%"
    tags:
    - "dbclusteridentifier:%%extra_dbclusteridentifier%%"
    - "region:%%extra_region%%"

ad_identifiers:
  - _dbm_mysql_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%%"

통합을 사용하여 Autodiscovery를 구성하는 방법에 관한 자세한 내용은 Autodiscovery 설명서를 참조하세요.

지원되는 템플릿 변수