MySQL レシーバー

前提条件と要件

このレシーバーは MySQL バージョン 8.0 をサポートしています。

メトリクスを収集するための要件

以下が該当します：

• ほとんどのメトリクスを収集するには、SHOW GLOBAL STATUS を実行できる必要があります。

• 一部のメトリクスは、対応する機能が無効の場合、表示されません。

• オプションのメトリクスを収集するには、設定でそれを指定する必要があります。

利用可能なメトリクスの完全なリストについては、「メトリクス」を参照してください。

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するように MySQL レシーバーを設定します。

3. Collector を再起動します。

サンプル構成

レシーバーをアクティブにするには、設定ファイルの mysql セクションに receivers を追加します：

receivers:
  mysql:
    endpoint: localhost:3306
    username: otel
    password: ${env:MYSQL_PASSWORD}
    database: otel
    collection_interval: 10s
    initial_delay: 1s
    statement_events:
      digest_text_limit: 120
      time_limit: 24h
      limit: 250

次に、設定ファイルの service セクションの metrics パイプラインに、レシーバーを含めます：

service:
  pipelines:
    metrics:
      receivers:
        - mysql

以下の設定はオプションです：

• endpoint。デフォルトでは localhost:3306 です。

• tlsします。使用する TLS 設定を定義します。tls が設定されていない場合、デフォルトでは TLS 接続が非アクティブになります。

  • insecure。デフォルトでは false です。TLS 接続を非アクティブ化するには、true に設定します。

  • insecure_skip_verify。デフォルトでは false です。TLS をアクティブ化するが証明書を検証しない場合は、true に設定します。

  • server_name_overrideします。これを使用して、TLSConfig の ServerName を設定します。

• username。デフォルトでは root です。

• passwordします。ユーザー名のパスワード。

• allow_native_passwords。デフォルトでは true です。

• databaseします。データベース名。未指定の場合は、すべてのデータベースに対してメトリクスが収集されます。

• transport。デフォルトでは tcp です。サーバーへの接続に使用するネットワークを定義します。

• statement_eventsします。mysql.statement_events.count と mysql.statement_events.wait.time のメトリクスを構築するクエリの追加設定

  • digest_text_limit。デフォルトでは 120 です。digest_text の最大長。それより長いテキストは切り捨てられます。

  • time_limit。デフォルトでは 24h です。ステートメントが前回観測されてからの最大時間。

  • limit。デフォルトでは 250 です。レコード数の制限で、生成されるメトリクスの最大数です。

設定

次の表に、MySQL レシーバーの設定オプションを示します：

メトリクス

以下のメトリクス、リソース属性、および属性が利用可能です。

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true

トラブルシューティング