호스트

호스트에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

Agent 구성 디렉터리 루트에서 conf.d/ 폴더의 mysql.d/conf.yaml 파일을 편집하여 MySQL 메트릭 및 로그 수집을 시작하세요.

사용 가능한 구성 옵션의 전체 목록은 샘플 mysql.d/conf.yaml을 참고하세요.

메트릭 수집

• mysql.d/conf.yaml에 이 설정 블록을 추가하여 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
  

참고: 특수 문자가 있는 경우 비밀번호를 작은따옴표로 묶어 입력하세요.

extra_performance_metrics를 수집하려면 MySQL 서버에 performance_schema가 활성화되어 있어야 합니다. 그렇지 않은 경우 extra_performance_metrics를 false로 설정해야 합니다. performance_schema에 대한 자세한 내용은 MySQL 성능 스키마 빠른 시작을 참고하세요.

참고: datadog 사용자는 MySQL 통합 설정 을 localhost 대신 host: 127.0.0.1로 설정해야 합니다. 또는 sock를 사용할 수도 있습니다.

Agent를 다시 시작하여 MySQL 메트릭을 Datadog으로 전송합니다.

로그 수집

에이전트 버전 > 6.0에서 사용 가능

1. 기본적으로 MySQL은 읽기 위해 루트 액세스 권한이 필요한 모든 항목을 /var/log/syslog에서 기록합니다. 로그에 더 쉽게 액세스할 수 있도록 하려면 다음 단계를 따르세요:

   • /etc/mysql/conf.d/mysqld_safe_syslog.cnf를 수정하고 해당 줄을 삭제하거나 댓글을 달 수 있습니다.

   • /etc/mysql/my.cnf를 편집하고 다음 줄을 추가하여 일반, 오류 및 느린 쿼리 로그를 활성화합니다.

       [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
     

   • 파일을 저장하고 다음 명령을 사용하여 MySQL을 다시 시작합니다. service mysql restart

   • 에이전트 디렉터리와 그 안의 모든 파일에 대한 읽기 권한이 /var/log/mysql 디렉터리에 있는지 확인합니다. 설정 로그 로테이션을 두 번 점검하여 해당 파일이 고려되고 권한도 올바르게 설정되었는지 확인합니다.

   • /etc/logrotate.d/mysql-server에는 다음과 유사한 내용이 있습니다:

       /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. 로그 수집은 Datadog 에이전트에서 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화합니다.

   logs_enabled: true
   

3. MySQL 로그 수집을 시작하려면 이 설정 블록을 mysql.d/conf.yaml 파일에 추가합니다:

   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+
   

   사용자 정의 메트릭을 포함한 사용 가능한 모든 구성 옵션은 샘플 mysql.yaml에서 확인할 수 있습니다.

4. Agent를 다시 시작합니다.

도커(Docker)

컨테이너에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 Docker 레이블로 설정합니다.

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

레이블 대신 환경 변수로 <UNIQUEPASSWORD>를 사용하는 방법은 Autodiscovery 템플릿 변수를 참고하세요.

로그 수집

Datadog Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 Docker 로그 수집을 참고하세요.

그런 다음 로그 통합을 Docker 레이블로 설정합니다.

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

Kubernetes

쿠버네티스에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 포드 주석으로 설정합니다. 또는 파일, 구성 맵, 키-값 저장소를 사용하여 템플릿을 구성할 수 있습니다.

Annotations v1(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

주석 v2(Datadog 에이전트 v7.36 이상용)

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

레이블 대신 환경 변수로 <UNIQUEPASSWORD>를 사용하는 방법은 Autodiscovery 템플릿 변수를 참고하세요.

로그 수집

Datadog Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 Kubernetes 로그 수집을 참고하세요.

그런 다음 로그 통합을 파드 어노테이션으로 설정합니다. 또는 파일, 구성 맵, 키-값 저장소를 사용하여 구성할 수 있습니다.

Annotations v1/v2

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

ECS

ECS에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 Docker 레이블로 설정합니다.

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

레이블 대신 환경 변수로 <UNIQUEPASSWORD>를 사용하는 방법은 Autodiscovery 템플릿 변수를 참고하세요.

로그 수집

에이전트 버전 > 6.0에서 사용 가능

Datadog Datadog Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 ECS 로그 수집을 참고하세요.

그런 다음 로그 통합을 Docker 레이블로 설정합니다.

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