MySQL (非推奨) 🔗

注意

MySQL モニターは現在非推奨となっており、2024年10月31日にサポート終了となります。この期間中は、重要なセキュリティおよびバグ修正のみが提供されます。サポートが終了すると、モニターは削除され、サポート対象外となり、Splunk Observability Cloud へのデータ送信に使用できなくなります。

MySQLデータベースを監視するには、代わりにネイティブのOpenTelemetry MySQLレシーバーを使うことができます。詳細については、MySQL レシーバーを参照してください。

Splunk Distribution of OpenTelemetry Collector は、MySQLからメトリクスとログを取得するために、MySQLモニタータイプで Smart Agentレシーバーを使用します。

このモニターは MySQL インスタンスに接続し、SHOW STATUS コマンドによって返された値をレポートし、以下を含みます：

処理されたコマンド数
テーブルと行の操作数（ハンドラ）
クエリ・キャッシュの状態
MySQLスレッドのステータス
ネットワーク・トラフィック

このインテグレーションはKubernetesとLinuxでのみ利用可能です。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索するを参照してください。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetesにインストールする
- Linuxにインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

このモニター用にMySQLユーザーを作成する 🔗

このモニター用にMySQLユーザーを作成するには、以下のコマンドを実行します：

CREATE USER '<username>'@'localhost' IDENTIFIED BY '<password>';
-- Give appropriate permissions
-- ("GRANT USAGE" is synonymous to "no privileges")
GRANT USAGE ON *.* TO '<username>'@'localhost';
-- Permissions for the stats options
GRANT REPLICATION CLIENT ON *.* TO '<username>'@'localhost';

新しいユーザーはデータベースに接続するのに十分な権限しか持っていません。追加の権限は必要ありません。

注釈

接続するDB名を別々に定義したい場合は、少なくともユーザーにSELECT権限を与える必要があります。

GRANT SELECT ON <db_name>.* TO '<user_name>'@'localhost';

ローカルホストに関する考慮事項 🔗

localhost への接続の場合、MySQL プログラムは Unix ソケットファイルを使用してローカルサーバーへの接続を試みます。クライアントがローカルサーバーへの TCP/IP 接続を確実に行うには、ホスト名値として 127.0.0.1 、またはローカルサーバーの IP アドレスまたは名前を指定します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/mysql:
    type: collectd/mysql
    host: 127.0.0.1
    port: 3306
    username: <global-username-for-all-db>
    password: <global-password-for-all-db>
    databases:
      - name: <name-of-db>
        username: <username> #Overrides global username
        password: <password> #Overrides global password

以下は、複数の MySQL データベースに接続する方法を示すサンプル YAML 設定です：

receivers:
  smartagent/mysql:
    type: collectd/mysql
    host: 127.0.0.1
    port: 3306
    databases:
      - name: <name>
        username: <username>
        password: <password>
      - name: <name>
        username: <username>
        password: <password>

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/mysql]

コンフィギュレーション設定 🔗

次の表に、このモニターの設定オプションを示します：

オプション	必須	タイプ	説明
`host`	はい	`string`	MySQL インスタンスのホスト名または IP アドレス。例えば `127.0.0.1`。
`port`	はい	`integer`	MySQL インスタンスのポート。たとえば、`3306` 。
`databases`	はい	`list of objects`	データベースのリストとオプションの認証の認証情報。
`username`	いいえ	`string`	すべてのデータベースのユーザー名。各ユーザー名を `databases` オブジェクトで定義することでオーバーライドできます。
`password`	いいえ	`string`	すべてのデータベースのパスワード。それぞれを定義することでオーバーライドできますユーザー名を `databases` オブジェクトで定義することでオーバーライドできます。
`reportHost`	いいえ	`bool`	`true` に設定すると、`host` ディメンションは、 MySQLデータベースホストの名前に設定されます。 `false` の場合、モニターは代わりにグローバルな `hostname` 設定を使用します。デフォルト値は `false` です。`disableHostDimensions` が `true` に設定されている場合、エージェントまたはモニターが実行されているホスト名は `host` メトリクス・ディメンション値には使用されません。
`innodbStats`	いいえ	`bool`	InnoDB 統計を収集します。InnoDB メトリクスを有効にする前にユーザーに `PROCESS` 権限が付与されていることを確認してください。デフォルト値は `false` です。

ネストされた databases コンフィギュレーション・オブジェクトには以下のフィールドがあります：

オプション	必須	タイプ	説明
`name`	はい	`string`	データベースの名前。
`username`	いいえ	`string`	データベースのユーザー名。
`password`	いいえ	`string`	データベースのパスワード。

メトリクス 🔗

このインテグレーションでは、以下のメトリクスを使用できます：

備考 🔗

Splunk Observability Cloudで利用可能なメトリクスタイプの詳細は、メトリクスタイプを参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloudのホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されず、料金が発生する場合があります。詳細については、メトリクスカテゴリを参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日に最終更新されました。

Related Topics