Dockerを使用したMySQL監視用のNRDOTのインストールと設定

前提条件

インストールする前に、以下のものがあることを確認してください：

• ホストにインストールされているDocker。

• すでに実行中のMySQLコンテナ（MySQL 5.7以降）。

• NewRelicライセンスキー。

• コレクターコンテナからNew Relic OTLPエンドポイントへのネットワーク接続。

  サポートされているMySQLのバージョン、必要な権限、およびperformance_schemaの要件については、互換性と前提条件をご覧ください。

データベースユーザーを構成する

docker execを使用してMySQLコンテナに対してSQLを実行し、必要な権限を持つ監視ユーザーを作成します。<YOUR_MYSQL_CONTAINER_NAME>、<YOUR_MYSQL_ROOT_PASSWORD>、<YOUR_DB_USERNAME>、<YOUR_DB_PASSWORD>をご自身の値に置き換えます。

• メトリクス収集に必要な最小限の権限を持つ監視ユーザーを作成するには、次を実行します：

  bash

  コピー

  $
  docker exec -i <YOUR_MYSQL_CONTAINER_NAME> mysql -u root -p'<YOUR_MYSQL_ROOT_PASSWORD>' -e "CREATE USER '<YOUR_DB_USERNAME>'@'%' IDENTIFIED BY '<YOUR_DB_PASSWORD>'; GRANT SELECT ON performance_schema.* TO '<YOUR_DB_USERNAME>'@'%'; FLUSH PRIVILEGES;"

• クエリサンプルと上位クエリも収集するには、代わりにすべての権限を付与してください：

  bash

  コピー

  $
  docker exec -i <YOUR_MYSQL_CONTAINER_NAME> mysql -u root -p'<YOUR_MYSQL_ROOT_PASSWORD>' -e "CREATE USER '<YOUR_DB_USERNAME>'@'%' IDENTIFIED BY '<YOUR_DB_PASSWORD>'; GRANT SELECT, PROCESS, REPLICATION CLIENT ON *.* TO '<YOUR_DB_USERNAME>'@'%'; GRANT SELECT ON performance_schema.* TO '<YOUR_DB_USERNAME>'@'%'; FLUSH PRIVILEGES;"

• （オプション）New Relicプラットフォームで待機時間データを表示するには、監視ユーザーに次の権限を付与します：

  bash

  コピー

  $
  docker exec -i <YOUR_MYSQL_CONTAINER_NAME> mysql -u root -p'<YOUR_MYSQL_ROOT_PASSWORD>' -e "GRANT UPDATE ON performance_schema.setup_consumers TO '<YOUR_DB_USERNAME>'@'%'; FLUSH PRIVILEGES;"

• （オプション）接続と権限を確認するには、次を実行します：

  bash

  コピー

  $
  docker exec -i <YOUR_MYSQL_CONTAINER_NAME> mysql -u '<YOUR_DB_USERNAME>' -p'<YOUR_DB_PASSWORD>' -e "SELECT 1;"

  コマンドがエラーなしで完了した場合、監視ユーザーとパスワードは正しいです。

NRDOT Collector の設定を作成します

この設定は、nrmysqlレシーバーを使用した基本的なMySQL監視に焦点を当てています。現在のディレクトリにmysql-config.yamlを生成するには、Dockerホストで以下を実行します：

$
cat << 'EOF' > mysql-config.yaml
$
receivers:
$
  nrmysql:
$
    endpoint: "<YOUR_MYSQL_CONTAINER_NAME>:3306"
$
    transport: tcp
$
    username: "<YOUR_DB_USERNAME>"
$
    password: "<YOUR_DB_PASSWORD>"
$
    allow_native_passwords: true
$
    collection_interval: 15s
$
    initial_delay: 1s
$
    explain_mode: procedure
$
    statement_events:
$
      digest_text_limit: 4096
$
      time_limit: 24h
$
      limit: 500
$
    query_sample_collection:
$
      max_rows_per_query: 100
$
      allowed_comment_keys: [nr_service_guid]
$
    top_query_collection:
$
      lookback_time: 60
$
      max_query_sample_count: 5000
$
      top_query_count: 200
$
      collection_interval: 60s
$
      query_plan_cache_size: 1000
$
      query_plan_cache_ttl: 1h
$
      allowed_comment_keys: [nr_service_guid]
$
    events:
$
      db.server.query_sample:
$
        enabled: true
$
      db.server.top_query:
$
        enabled: true
$
      db.server.query_plan:
$
        enabled: true
$
    resource_attributes:
$
      db.system.version:
$
        enabled: true
$
    metrics:
$
      mysql.query.count:
$
        enabled: true
$
      mysql.query.slow.count:
$
        enabled: true
$
      mysql.commands:
$
        enabled: true
$
      mysql.innodb.data_file.io:
$
        enabled: true
$

$
processors:
$
  batch:
$

$
exporters:
$
  otlp/newrelic:
$
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$
    headers:
$
      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
$
    compression: gzip
$
    retry_on_failure:
$
      enabled: true
$
      initial_interval: 5s
$
      max_interval: 30s
$
      max_elapsed_time: 300s
$

$
service:
$
  pipelines:
$
    metrics:
$
      receivers: [nrmysql]
$
      processors: [batch]
$
      exporters: [otlp/newrelic]
$
    logs:
$
      receivers: [nrmysql]
$
      processors: [batch]
$
      exporters: [otlp/newrelic]
$
EOF

設定パラメーター

NRDOT Collectorコンテナを起動してください。

コンテナ名で <YOUR_MYSQL_CONTAINER_NAME> を解決できるように、MySQLコンテナと同じDockerネットワーク上でコレクターを実行してください：

$
docker run -d \
>
  --name nrdot-collector \
>
  --network <YOUR_DOCKER_NETWORK> \
>
  -v "$PWD/mysql-config.yaml:/etc/nrdot-collector/mysql-config.yaml" \
>
  newrelic/nrdot-collector:latest \
>
  --config /etc/nrdot-collector/mysql-config.yaml

$
docker network create <YOUR_DOCKER_NETWORK>
$
docker network connect <YOUR_DOCKER_NETWORK> <YOUR_MYSQL_CONTAINER_NAME>

コレクターコンテナが実行されていることを確認します：

$
docker ps --filter name=nrdot-collector

実行されていない場合は、ログでエラーを確認してください。最も一般的な原因は、mysql-config.yamlでのYAMLインデントの問題、または到達できないMySQLコンテナです：

$
docker logs nrdot-collector

$
docker restart nrdot-collector

データを探す、使う

データの収集が開始されると、New Relic UIから包括的なMySQLデータベース監視にアクセスできます。

New RelicでMySQLデータベースエンティティを見つけるには：

1. one.newrelic.com > All capabilities > Databasesに移動します。

2. Entity typeドロップダウンからMySQL instanceを選択し、Applyをクリックします。

3. エンティティのリストからMySQLデータベースを選択します。

   データが到着していることを確認するには、クエリビルダーで次のクエリを実行します：

   SELECT count(*) FROM Metric
   WHERE metricName LIKE 'mysql.%'
   AND instrumentation.provider = 'opentelemetry'
   SINCE 10 minutes ago

   コピー