ホスト

ホストで実行中の Agent に対してこのチェックを構成するには

MySQL の メトリクス と ログ を収集するには、Agent の構成ディレクトリ のルートにある conf.d/ フォルダー内で mysql.d/conf.yaml ファイルを編集してください。

利用可能な設定オプションの完全な一覧については、サンプル mysql.d/conf.yaml を参照してください。

メトリクスの収集

• MySQL メトリクスを収集するには、mysql.d/conf.yaml に次の構成ブロックを追加します。

  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 Performance Schema クイック スタート を参照してください。

注: datadog ユーザーは、localhost ではなく host: 127.0.0.1 として MySQL インテグレーション構成内にセットアップされる必要があります。または、sock を使用することもできます。

Datadog へ MySQL メトリクスの送信を開始するには、Agent を再起動 してください。

ログ収集

Agent バージョン 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

   • Agent が /var/log/mysql ディレクトリとその中のすべてのファイルに対する読み取りアクセス許可を持つことを確認します。logrotate 構成もチェックして、これらのファイルが考慮され、アクセス許可が正しく設定されていることを確認します。

   • /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 Agent で、ログの収集はデフォルトで無効になっています。以下のように、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

コンテナで実行中の Agent に対してこのチェックを構成するには:

メトリクスの収集

アプリケーション コンテナで オートディスカバリー インテグレーション テンプレート を 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> を使用する方法については、オートディスカバリー テンプレート変数 を参照してください。

ログ収集

Datadog Agent では、ログの収集はデフォルトで無効になっています。有効にするには、Docker のログ収集 を参照してください。

次に、ログ インテグレーション を Docker ラベルとして設定します:

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

Kubernetes

このチェックを、Kubernetes で実行している Agent に構成します。

メトリクスの収集

アプリケーション コンテナに オートディスカバリー インテグレーション テンプレート をポッド アノテーションとして設定します。あるいは ファイル、ConfigMap、またはキーバリュー ストア でテンプレートを構成することも可能です。

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

Annotations v2 (Datadog Agent 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> を使用する方法については、オートディスカバリー テンプレート変数 を参照してください。

ログ収集

Datadog Agent では、ログの収集はデフォルトで無効になっています。有効にするには、Kubernetes のログ収集 を参照してください。

ログ インテグレーション をポッドのアノテーションとして設定します。代わりに ファイル、ConfigMap、またはキーバリュー ストア で構成することもできます。

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 で実行している Agent に構成するには:

メトリクスの収集

アプリケーション コンテナで オートディスカバリー インテグレーション テンプレート を 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> を使用する方法をご確認ください。

ログ収集

Agent バージョン 6.0 以降で利用可能

Datadog Agent では、ログの収集はデフォルトで無効になっています。有効にするには、ECS のログ収集 を参照してください。

次に、ログ インテグレーション を Docker ラベルとして設定します:

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