MySQL カスタムクエリ

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

Datadog の MySQL インテグレーションでは、カスタムクエリからメトリクスを収集できます。

構成

詳細な設定手順は MySQL conf.yaml を参照してください。以下の追加事項も考慮してください。

データベースの明示

MySQL conf.yaml にカスタムクエリを追加する際は、参照する各テーブルにデータベース名を付けて修飾する必要があります。形式は次のとおりです。

SELECT * FROM database_name.table_name WHERE...

データベース名を省略すると、Agent は No database selected エラーでクエリを実行できません。

メトリクス名の指定

クエリで指定したメトリクス名はそのまま使用され、接頭辞は追加されません。例: myapp.custom_query.test

収集頻度

デフォルトでは、MySQL チェックによって 15〜20 秒ごとにメトリクスが収集されます。別の頻度で取得したい場合は、MySQL チェック全体の実行間隔を短くする (この場合、一般的な mysql.* メトリクスの頻度も変わります) か、API または DogStatsD を使用して CRON スクリプトでメトリクスを送信してください。

カスタムクエリの数

MySQL チェックで大量のカスタムクエリを実行すると、他の Agent チェックが遅延する場合があります。多数のカスタム MySQL クエリからメトリクスを収集する必要がある場合は、API または DogStatsD を使用して CRON スクリプトで送信してください。

例

tester というデータベースに test_table というテーブルがあり、以下のデータが含まれているとします。

col_1 | col_2 | col_3
---------------------
1     | a     | a
2     | b     | b
3     | c     | c

次のカスタムクエリを MySQL の conf.yaml に追加すると、値 2 のメトリクス myapp.custom_query.test.b が収集されます。

    custom_queries:
      - query: SELECT col_1 FROM tester.test_table WHERE col_2 = 'b'
        columns:
        - name: myapp.custom_query.test.b
          type: gauge
        tags:
        - tester:mysql

その他の参考資料

お役に立つドキュメント、リンクや記事:

Datadog MySQL インテグレーションドキュメント more more