MySQL レシーバー

MySQLレシーバーは、Splunk Distribution of OpenTelemetry CollectorがMySQLのグローバルステータスとInnoDBテーブルに関するメトリクスをクエリして取得できるようにします。

MySQL レシーバーは、MySQL のグローバルステータスと InnoDB テーブルに関するメトリクスをクエリして取得します。サポートされているパイプラインのタイプは metrics です。詳細については「パイプラインでデータを処理する」を参照してください。

前提条件と要件

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

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

以下が該当します：

ほとんどのメトリクスを収集するには、SHOW GLOBAL STATUS を実行できる必要があります。
一部のメトリクスは、対応する機能が無効の場合、表示されません。
オプションのメトリクスを収集するには、設定でそれを指定する必要があります。

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

はじめに

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

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように MySQL レシーバーを設定します。
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します。データベース名。未指定の場合は、すべてのデータベースに対してメトリクスが収集されます。

collection_interval。デフォルトでは 10s です。このレシーバーがメトリクスを収集する間隔を設定します。
- この値は、Golang の time.ParseDuration で読み取り可能な文字列である必要があります。詳細は Go の公式ドキュメント「ParseDuration function」を参照してください。
- 有効な時間単位は ns、us （ µs ）、ms、s、m、h です。

initial_delay。デフォルトでは 1s です。このレシーバーが初めてメトリクスを収集するまでの待機時間を決定します。

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 レシーバーの設定オプションを示します：

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/receiver/mysql.yaml

メトリクス

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

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/metric-metadata/mysqlreceiver.yaml

特定のメトリクスをアクティブまたは非アクティブにする

各メトリクスの metrics セクションの enabled フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

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

以下は、アクティブ化されたメトリクスを持つホスト・メトリクス・レシーバーの構成例です：

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

注: 非アクティブ化されたメトリックは Splunk Observability Cloud に送信されません。

請求

MTS ベースのサブスクリプションの場合、すべてのメトリックがメトリックの使用にカウントされます。
ホストベースのプランを使用している場合、このドキュメントでアクティブ（アクティブ：はい）としてリストされているメトリックはデフォルトと見なされ、無料で含まれています。

詳細については、「Infrastructure Monitoringのサブスクリプション使用状況（ホストとメトリクスのプラン）」を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______