MySQL のデフォルトチェックとポリシー

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：8分

    • エージェントクライアントコレクター は、MySQL メトリクスモニタリングのための以下のデフォルトのチェックとポリシーを提供します。

    表 : 1. MySQL イベント
    タイプ チェック 説明 使用方法と使用例 出力
    イベント app.mysql.check-mysql-alive MySQL クエリからの結果セットの長さを検証します。 check-mysql-query-result-count.rb (オプション)

    クエリによって返されるアイテム数の -c, --critical COUNT COUNT 重大しきい値 (必須)

    -d, --database DATABASE MySQL データベース (必須)

    接続先の -h, --host HOST MySQL ホスト (必須)

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    接続先の -P, --port PORT MySQL ポート

    実行する -q, --query QUERY クエリ (必須)

    クエリによって返されるアイテム数の -w, --warning COUNT カウント警告しきい値 (必須)

    接続先の -S, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    使用例

    check-mysql-query-result-count.rb -h 127.0.0.1 -P 3306 -d mysql -q "select * from user" -w 5 -c 8

    		 MysqlQueryCountCheck OK/CRITICAL/WARNING：クエリ長としきい値の比率に関するメッセージ
    イベント app.mysql.check-mysql-threads 実行中のスレッドの MySQL DB 数を検証し、入力値に応じて OK/WARNING/CRITICAL のステータスを割り当てます。 check-mysql-threads.rb (オプション)

    ログインする -h, --hostname HOST ホスト名

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション (.ini パスが指定されている場合は必要)。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    その値を上回るとアラートが発行される実行中のスレッドの -c, --critnum NUMBER 数

    その値を上回ると警告が発行される実行中のスレッドの -w, --warnnum NUMBER 数

    接続先の -P, --port PORT MySQL ポート

    接続先の -S, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    使用例

    check-mysql-threads.rb -h 127.0.0.1 -P 3306 -l 0 -m 1 -c 25 -w 20

    		 CheckMySQLHealth の OK/重大/警告および実行中のスレッドの数
    イベント util.check-mysql-query MySQL DB が実行されているかどうかを確認します。 check-mysql-threads.rb (オプション)

    ログインする -h, --hostname HOST ホスト名

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション (.ini パスが指定されている場合は必要)。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    その値を上回るとアラートが発行される実行中のスレッドの -c, --critnum NUMBER 数

    その値を上回ると警告が発行される実行中のスレッドの -w, --warnnum NUMBER 数

    その値を下回るとアラートが発行される実行中のスレッドの -l, --critlow NUMBER 数

    その値を下回ると警告が発行される実行中のスレッドの -m, --warnlow NUMBER 数

    接続先の -P, --port PORT MySQL ポート

    接続先の -s, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    使用例

    check-mysql-threads.rb -h 127.0.0.1 -P 3306 -l 0 -m 1 -c 25 -w 20

    CheckMySQLHealth の OK/重大/警告および実行中のスレッドの数
    表 : 2. MySQL のメトリクス
    タイプ チェック 説明 使用方法と使用例 出力
    メトリクス app.mysql.metrics-mysql MySQL DB のメトリクスを返します。 /usr/local/bin/metrics-mysql-graphite.rb (オプション)

    接続先の -h, --host HOST MySQL ホスト (必須)

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション (.ini パスが指定されている場合は必要)。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    接続先の -P, --port PORT MySQL ポート。

    -s, --scheme SCHEME メトリクスの命名スキーム、メトリクスの後に付けるテキスト。

    接続先の -S, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    セカンダリステータスコピーに関する -v, --verbose Show エラー (生成された場合)。コマンドに -v を追加してアクティブ化します。

    使用例

    check-mysql-threads.rb -h 127.0.0.1 -P 3306 -l 0 -m 1 -c 25 -w 20

    		 MysqlQueryCountCheck OK/CRITICAL/WARNING：クエリ長としきい値の比率に関するメッセージ
    メトリクス app.mysql.check-mysql-threads 実行中のスレッドの MySQL DB 数を検証し、入力値に応じて OK/WARNING/CRITICAL のステータスを割り当てます。 /usr/local/bin/metrics-mysql-graphite.rb (オプション)

    接続先の -h, --hostname HOST ホスト名 (必須)

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション (.ini パスが指定されている場合は必要)。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    その値を上回るとアラートが発行される実行中のスレッドの -c, --critnum NUMBER 数

    その値を上回ると警告が発行される実行中のスレッドの -w, --warnnum NUMBER 数

    その値を下回るとアラートが発行される実行中のスレッドの -l, --critlow NUMBER 数

    その値を下回ると警告が発行される実行中のスレッドの -m, --warnlow NUMBER 数

    接続先の -P, --port PORT MySQL ポート

    接続先の -s, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    使用例

    metrics-mysql-graphite.rb -h 127.0.0.1 -P 3306

    hostname.mysql.general.abortedClients 7600 1649630975

    hostname.mysql.general.abortedConnects 247 1649630975

    hostname.mysql.general.txBytes 752733902 1649630975

    hostname.mysql.commands.admin_commands 1631 1649630975

    hostname.mysql.commands.alter_table 0 1649630975
    メトリクス app.mysql.metrics-mysql-processes MySQL DB プロセスに関するさまざまなメトリクスを返します。

    /usr/local/bin/metrics-mysql-processes.rb (オプション)

    接続先の -h, --host MySQL ホスト

    -i, --ini VALUE My.cnf ini ファイル

    my.cnf ini ファイル内の --ini-section VALUE セクション (.ini パスが指定されている場合は必要)。.ini ファイルを介して MySQL への接続を有効にするには、.ini ファイルの client セクションでプロパティ「user」および「password」に対して値を指定します。

    接続先の -P, --port PORT MySQL ポート

    -s --scheme SCHEME メトリクスの命名スキーム、メトリクスの後に付けるテキスト。

    接続先の -s, --socket UNIX ソケット (UNIX 系のシステムで指定されたホストが 'localhost' である場合は必須)

    使用例

    metrics-mysql-processes.rb -h 127.0.0.1 -P 3306

    プロセス、実行中のコマンド、およびコマンドを実行しているデータベース

    例：

    • hostname.mysql.database.mysql 1 1649631113
    • hostname.mysql.command.Daemon 1 1649631113
    • hostname.mysql.command.Sleep 4 1649631113
    • hostname.mysql.command.Query 1 1649631113