Datadog データソースに接続する

Datadog データソースを使用すると、Amazon Managed Grafana の Datadog モニタリングサービスのメトリクスを視覚化できます。

注記

このデータソースは Grafana Enterprise 専用です。詳細については、「Enterprise プラグインへのアクセスを管理する」を参照してください。

さらに、バージョン 9 以降をサポートするワークスペースでは、このデータソースで適切なプラグインのインストールが必要になる場合があります。詳細については、「プラグインを使用してワークスペースを拡張する」を参照してください。

使用方法

キャッシュ

大規模なダッシュボードでは、多くのクエリを Datadog API によってレート制限することができます (Datadog API が許可する 1 時間あたりの API 呼び出しの最大数に達します）。キャッシュ機能は、一意のクエリを 60 秒間キャッシュします。この間隔は、設定ページで長くまたは短く変更できます。

クエリエディタ

簡単に - 集計とメトリクスを選択します。結果をフィルタリングする場合は、1 つ以上のタグを選択します。

Datadog データソースは、Datadog クエリエディタがサポートするすべての高度な関数をサポートします。ドロップダウンリストから選択し、関数名を選択して配置します。

フィールドの使用可能性別のエイリアス：

• エイリアスを「別名」フィールドに入力します。

• スコープ付き変数を使用する：

  • $__metric = メトリクス名に置き換えられます

  • $__display_name = メトリクス名に置き換えられます

  • $__expression = 完全なメトリクス式に置き換えられます

  • $__aggr = メトリクス集計関数に置き換えられます (例: avg、max、min、sum)

  • $__scope = メトリクススコープ (リージョン、サイト、環境、ホストなど) に置き換えられます

• 正規表現を使用します。

  • 正規表現を「エイリアス RegExp」フィールドに /you regexp here/flags 形式で入力します。

  • 「別名」フィールドが空の場合、 RegExp 結果は を使用して結合されます。メトリクス式 = avg:system.load.5{*} : "Alias by" フィールド入力: ""Alias RegExp" フィールド入力: avg:(.+)\.(\d) 結果: system.load, 5

  • 「別名」フィールドで$<group_number>変数を使用します。メトリクス式 = avg:system.load.5{*} : "Alias by" フィールド入力: $1: $2 seconds "Alias RegExp" フィールド入力: avg:(.+)\.(\d) 結果: system.load: 5 seconds

  • $0 を使用して式全体を取得します。メトリクス式 = datadog.dogstatsd.packet.count{*} : "Alias by" フィールド入力: Expression: $0 "Alias RegExp" フィールド入力: DOGstatsd\.(.*)\.(.*){\*}/i 結果: Expression: datadog.dogstatsd.packet.count{*}

  注: 存在しないグループ番号を使用すると、エラーが発生します。

メトリクス算術

メトリクス算術を使用するには、クエリタイプを算術 に設定します。# 署名を使用して、必要なメトリクスにリンクします。例えば、 #A * 2はクエリ の結果を 2 倍にしますA。2 つのメトリクス間の算術は同じ方法で機能します。計算に使用する結果を含むクエリを追加し、3 番目のクエリで などのこれらのメトリクスにリンクします#A / #B。

‏注釈

アノテーションは、グラフの上にオーバーレイされるイベントです。イベントの例は、デプロイまたは停止です。このデータソースを使用すると、Datadog からイベントを取得し、Amazon Managed Grafana のグラフにオーバーレイできます。注釈イベントは、ソース、タグ、または優先度でフィルタリングできます。

テンプレート

テンプレート変数の値を取得するには、メトリクスとタグといういくつかのオプションがあります。クエリフィールド*で指定された使用可能なメトリクスのリストを取得するには。

すべてのタグを返すには、値 tagまたは を使用しますscope。

指定されたタググループのタグを返すには、次のいずれかのデフォルトのカテゴリ値を使用します。

• host

• device

• env

• region

• site

• status

• version

カスタムタググループの場合は、タググループ名を入力するだけです。例えば、カスタムタググループ名が の場合subscription_name、クエリフィールドにそのタググループ名を入力します。

正規表現フィールドを使用して結果をフィルタリングします。タグを使用する場合、複数値変数がサポートされます。選択した複数のタグ値がカンマ区切りのタグリストに変換されます。

アドホックフィルター

Grafana には、アドホックフィルター と呼ばれる新しい特殊なタイプのテンプレート変数があります。この変数は、ダッシュボード内のすべての Datadog クエリに適用されます。これにより、クイックフィルターのように使用できます。Datadog のアドホック変数は、 などのタグからすべてのキーと値のペアを取得しregion:east, region:west、クエリタグとして使用します。この変数を作成するには、アドホックフィルタータイプを選択し、Datadog データソースを選択します。この変数には任意の名前を設定できます。