Atlas を構成して、プロジェクトのメトリクス データを Datadog ダッシュボードに送信できます。
注意
アラートとイベントを Datadog に送信するように Atlas プロジェクトを構成する場合は、この手順に従う必要はありません。Atlas は、アラートとイベントの送信に使用されるのと同じ統合で、プロジェクト メトリクスを Datadog に送信します。
DataDog を構成して Atlas アラートを受信することもできます。詳細については、通知オプションを参照してください。
必要なアクセス権
Atlas を Datadog と統合するには、プロジェクトの Project Owner アクセス権が必要です。Organization Owner アクセス権を持つユーザーは、自分自身を Project Owner としてプロジェクトに追加する必要があります。
前提条件
Datadog 統合は、M10+ クラスターでのみ使用できます。
Atlas を Datadog と統合するには、Datadog アカウントと Datadog API キーが必要です。Datadog の API キーは、初めて Datadog アカウントを作成するときに付与されます。
既存の DataDog アカウントをお持ちでない場合は、 アプリ. でサインアップできます。
手順
Atlas CLI を使用して Datadog 統合を作成または更新するには、次のコマンドを実行します。
atlas integrations create DATADOG [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントの「 Atlas integrations create DATADOG 」を参照してください。
Atlas UI を使用して、次のように Atlas と Datadog の統合を構成します。
Atlas で、Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 アイコンを Project Overview の横にあるをクリックします。
[ Project Settings ]ページが表示されます。
Datadog API キーを使用して、Datadog をプロジェクトにリンクします。
Datadog integration card(統合カード)で [Configure] をクリックします。
入力ボックスに Datadog API キーを入力します。
API リージョンを選択します。
Atlas は、Atlas UI で次の Datadog リージョンをサポートしています。
US1US3US5EU1AP1
Datadog はデフォルトで
US1を使用します。DataDog のリージョンの詳細については、DataDog サイト を参照してください。
(任意)データベースメトリクスの追跡を有効にするには、Send Database Metrics を On に切り替えます。
(任意)レイテンシ メトリクスの追跡を有効にするには、Send Collection Latency Metrics を On に切り替えます。
(任意)クエリシェイプメトリクスの追跡を有効にするには、Send Query Shape Metrics を On に切り替えます。
[Save] をクリックします。
Datadog で利用可能なタグ
統合により、特定のメトリクスに対して次の Datadog タグ が生成されます。
Datadog Tags | 説明 |
|---|---|
| メトリクスに関連付けられた Atlas 組織。 |
| メトリクスに関連付けられた Atlas プロジェクト。 |
| メトリックに関連付けられた Atlas プロジェクトの一意の識別子。 |
| メトリクスに関連付けられた Atlas クラスター。 |
| メトリックに関連付けられたレプリカセット。 |
| メトリクスに関連付けられたシャーディングされたクラスター。 |
| メトリックに関連付けられたデータベース。 |
| メトリクスに関連付けられたコレクション。 |
| Atlas ホスト名に関連付けられたポート番号。 |
| Atlas ホスト名の状態(プライマリ、セカンダリ、または個別のプロセス)。このタグを使用して、シャーディングされたクラスターまたはレプリカセットをクエリする際に、コレクションレベルのレイテンシ メトリクスをフィルターできます。 |
| メトリクスに関連付けられたストリーム プロセッサの名前。 |
| メトリクスに関連付けられたストリーム プロセッサの一意識別子。 |
| メトリックに関連付けられた Stream Processing ワークスペースの名前。 |
| メトリクスに関連付けられた Stream Processing ワークスペースの一意の識別子。 |
さらに、Atlas はユーザー定義のカスタムタグを Datadog に送信します。タグはメトリクスにのみ適用され、アラートには適用されません。
注意
DataDog メトリクスにカスタム タグを送信することは、 UIまたはAPIを通じて有効にするオプトイン機能です。 各手順の詳細については、このドキュメントの「手順」セクションを参照してください。
Atlas 統合ステータスを追跡するための Datadog 機能
Datadog は、Atlas との統合ステータスを追跡するために設定可能な、以下の機能を提供します。
No-data Alert
Datadog のデータ未検出アラートは、通常の状況下でメトリクスがデータを報告していない場合に通知します。この機能により、パフォーマンスの変化、API キーの問題、接続の断絶など、Atlas との統合に関する問題を特定できます。
サービス チェック
Datadog のサービス チェックは、Datadog を使用して、Atlas 統合のステータスをモニターします。この機能は、一定の間隔で報告されるべきメトリクスが、指定された回数連続で取得できないかどうかをモニターします。サービス チェックによってアラートが送信された場合、Atlas との統合に問題が発生していることを示します。
Datadog で利用可能なパフォーマンスメトリクス
Datadog は、Atlas クラスターの次のメトリック データを追跡します。括弧内のメトリクス名は Datadog の UI で使用されます。
重要
デフォルトでは、Datadogは高濃度のメトリクスデータを追跡しません。これらのメトリクスの追跡を有効にするには、次の設定を指定する必要があります。
sendDatabaseMetrics:データベース名、コレクション番号、ストレージ サイズ、インデックス サイズなどのデータベース メトリクスを追跡します。これらのメトリクスの名前にはmongodb.atlas.dbstatsが最初に付きます。sendCollectionLatencyMetrics:データベース名、コレクション名、ならびにコマンド、操作、およびトランザクションに関するレイテンシ情報を含む、コレクションのレイテンシ メトリクスを追跡します。これらのメトリクスの名前にはmongodb.atlas.latencyStatsが最初に付きます。sendQueryShapeMetrics: 実行時間とカウント、検査されて返されたキーとドキュメント、応答時間などのクエリシェイプメトリクスを追跡します。これらのメトリクスには、名前のプレフィックスとしてmongodb.atlas.querystatsが付きます。
これらの設定は、Atlas Administration API エンドポイントまたは Atlas UI を使用して有効にします。
クラスターと操作メトリクス
メトリクス名 | メトリクス型 | 説明 |
|---|---|---|
| プロセス | クラスターで現在開いている開いている接続の数。 |
| プロセス | データベースサーバーへのアクティブなクライアント接続の数。アクティブな接続とは、現在実行中の操作を指す。 |
| プロセス | データベースサーバーへの 1 秒あたりの合計接続数。 |
| プロセス | 新しい接続リクエストが Ingress セッション確立キューに追加されるレート。 |
| プロセス | 接続リクエストが Ingress セッション確立キューから削除される速度。 |
| プロセス | 入力セッション確立レートリミッターが接続リクエストを拒否するレート。ゼロ以外の値は、レートリミッターが負荷により新しい接続を活発的に拒否していることを意味します。 |
| プロセス | 接続リクエストが Ingress セッション確立レート リミットを正常に通過し、許可されるレート。 |
| プロセス | Ingress セッション確立キューで待機中に中断された接続リクエストの 1 秒あたりの割合。中断はタイムアウトまたはキャンセルによって発生する可能性があります。 |
| プロセス | 1 秒あたりに読み取られるまたは書込まれるドキュメントの数。 |
| プロセス | 1 秒あたりにデータベース サーバーに送信される物理バイトの平均レート(ワイヤ圧縮後)。 |
| プロセス | データベース サーバーから 1 秒あたりに送信される物理バイトの平均レート(ワイヤ圧縮後)。 |
| プロセス | 1 秒あたりにデータベース サーバーに送信されるリクエストの平均レート。 |
| プロセス | 1 秒あたりの操作数(操作の種類別)。 |
| プロセス | TTL(Time-To-Live)インデックスモニターによって 1 秒あたりに削除されるドキュメントの速度。期限切れのドキュメントの自動クリーンアップを追跡します。 |
| プロセス | 操作型別に分けられた平均操作時間(ミリ秒単位)。 |
| プロセス | 返されたオブジェクトに対するスキャンされたオブジェクトの数を測定する比率。値が低いほど、クエリの効率が高くなります。 |
| プロセス | 単一のシャードを対象とする現在開いているカーソルの数。 |
| プロセス | 複数のシャードを対象とする現在開いているカーソル(スキャッター ギャザー カーソル)の数。 |
| プロセス |
|
| プロセス | このサーバー上で現在アクティブなトランザクション(コマンドを実行しているトランザクション)の数。 |
| プロセス | このサーバー上で現在開いているトランザクション(アクティブ + 非アクティブ)の数。 |
| プロセス | このサーバー上で開始されたトランザクションの 1 秒あたりのレート。 |
| プロセス | このサーバー上で中止されたトランザクションの 1 秒あたりの割合。 |
| プロセス | このサーバーでコミットされたトランザクションの 1 秒あたりのレート。 |
| プロセス | このサーバー上で準備状態になったトランザクションの 1 秒あたりの割合。クロスシャードの 2 フェーズに関するコミット トランザクションへの参加を示します。 |
| プロセス | クロスシャード 2 フェーズのコミット トランザクションが開始される 1 秒あたりの速度。ゼロ以外の値は、マルチシャード書込みトランザクションが存在することを示します。 |
| プロセス | クロスシャード 2 フェーズのコミット トランザクションが正常にコミットされる 1 秒あたりのレート。 |
| プロセス | セカンダリへの更新がプライマリへの更新より遅れる時間(秒単位)。 |
| プロセス | プライマリのレプリケーション oplog で利用可能なデータベース操作の推定平均数(秒単位)。このメトリクスは、oplog のチャーンに基づいています。セカンダリ ノードのレプリケーション ラグがレプリケーション oplog ウィンドウを超え、レプリケーション ヘッドルームがゼロになった場合は、完全再同期が必要です。 |
| プロセス | レプリカセット ノードの正常性を示す数値。 次のシナリオでは、不正確なヘルス ステータスが表示される場合があります。
重要: ヘルスステータスが |
| プロセス | レプリカセット ノードの レプリカの状態 を表す |
| プロセス | MongoDB セカンダリ でのデータベース操作の速度を測定します。これは、MongoDB これらのメトリクスは、クラスター メトリクスを通じてアクセスしたOpcounters - Replチャートで表示できます。 |
| プロセス | プライマリが生成する oplog の平均速度(1 時間あたりギガバイト単位)。 |
| プロセス | すべてのデータベースにわたるプロファイリング コレクションへの合計書き込み (write) の 1 秒あたりの割合。 |
| プロセス | すべてのデータベースにわたってプロファイルコレクションに現在書込まれている操作のインスタンス数。 |
| プロセス | このサーバー上のすべてのデータベースに存在する system.profile コレクションの合計数。 |
| プロセス | プロファイルコレクションで開かれた非追尾可能 (tailable) カーソルの 1 秒あたりの割合。MongoDB 8.0 および 8.1 で利用可能( |
| プロセス | プロファイルコレクションで開かれた 追尾可能 (tailable) カーソル の 1 秒あたりの割合。MongoDB 8.0 および 8.1 で利用可能( |
| プロセス | プロファイルコレクションで開かれた、追尾可能 (tailable) と非追尾可能 (tailable) の両方を含む、1 秒あたりのカーソルの合計レート。MongoDB 8.0 および 8.1 で利用可能( |
ホストシステムメトリクス
メトリクス名 | メトリクス型 | 説明 |
|---|---|---|
| プロセス | サーバー上の MongoDB プロセスによって消費されるメモリ( |
| システム | 使用されている物理メモリをキロバイト単位で示すゲージ。 |
| システム | 使用されている最大物理メモリをキロバイト単位で示すゲージ。 |
| システム | サーバーのさまざなプロセス全体で論理 CPU が使用した時間の割合。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
| システム | サーバーのさまざなプロセス全体で論理 CPU が使用される時間の割合の最大値。DataDog は、メトリクスの粒度によって設定された期間にわたる最大値をレコードします。これらの値は、論理 CPU コアの数に対して正規化されます。 |
| プロセス | サーバー内の MongoDB プロセスに固有のさまざまなプロセス全体で論理 CPU によって使用された時間の割合。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
| プロセス | サーバー内の MongoDB プロセスに固有のさまざまなプロセスで論理 CPU が使用される時間の割合の最大値。DataDog は、メトリクスの粒度によって設定された期間における最大値をレコードします。これらの値は、論理 CPU コアの数に対して正規化されます。 |
| Disk | 読み取りリクエストと書き込みリクエストの遅延ゲージ(ミリ秒単位)。 |
| Disk | 読み取りリクエストと書込みリクエストの最大遅延ゲージ(ミリ秒単位)。 |
| Disk | MongoDB が使用するディスク パーティションに発行されたリクエスト キューの平均長。DataDog は、メトリクスの粒度によって設定された期間にわたってこの平均値を記録します。 |
| Disk | MongoDB が使用するディスク パーティションに発行されたリクエストキューの最大平均長。DataDog は、メトリクスの粒度によって設定された期間にわたる最大値を記録します。 |
| Disk | データパーティションのディスク読み取りスループット(1 秒あたりのバイト数)。 |
| Disk | データパーティションのディスク書込みスループット(1 秒あたりのバイト数)。 |
| Disk | MongoDB 用ディスク パーティションの IOPS のスループットを測定します。 |
| Disk | MongoDB が使用するディスク パーティションの最大スループットは IOPS です。DataDog は、メトリクスの粒度によって設定された期間における最大値を記録します。 |
| Disk | MongoDB が使用するディスク パーティションの空きディスク容量と使用済みディスク容量(バイト単位)を測定します。 |
| Disk | MongoDB が使用するディスク パーティションの空きディスク容量と使用済みディスク容量(バイト単位)の最大値。DataDog は、メトリクスの粒度によって設定された期間における最大値を記録します。 |
| システム | 1 秒あたりの物理バイト数の平均受信速度。 |
| システム | 1 秒あたりの物理バイト数の平均送信速度。 |
| システム | 1 秒あたりの物理バイト数の最大平均受信速度。DataDog は、メトリクスの粒度によって設定された期間における最大値を記録します。 |
| システム | 1 秒あたりの物理バイト数の最大平均送信速度。DataDog は、メトリクスの粒度によって設定された期間における最大値を記録します。 |
| プロセス | WiredTiger のキャッシュ に読み取られるバイトと書き込まれるバイトの平均レートを測定します。 |
| プロセス | WiredTiger のキャッシュ内のデータのバイト数とダーティ データのバイト数を測定します。 |
| プロセス | キャッシュに読み込まれたページ数と、キャッシュからリクエストされたページ数。 |
| プロセス | WiredTigerキャッシュに構成された最大バイト数。キャッシュ書き込み比率(現在キャッシュにあるバイト / 構成された最大バイト数)とダーティ埋め込み比率(キャッシュ内の追跡ダーティバイト / 構成された最大バイト数)の計算に使用されます。 |
| プロセス | ストレージ エンジンでの読み取りおよび書き込み操作の数を測定します。 |
| グローバル | Atlas が読み取り、書き込み、または読み取りと書き込みの組み合わせで保持している ロック が原因で現在キューに入れられている操作の数を示すゲージ。 |
データベース、クエリ、検索、Stream Processing メトリクス
メトリクス名 | メトリクス型 | 説明 |
|---|---|---|
| プロセス | クラスター上のデータベース ストレージ サイズ、データ サイズ、およびインデックス サイズの合計(バイト単位)。 |
| ゲージ | |
| ゲージ | データベース内のコレクションの数。 |
| ゲージ | データベースに保持されている非圧縮データの合計サイズ。 |
| ゲージ | MongoDB がデータを保存するファイルシステムで使用中のすべてのディスク領域の合計サイズ。 |
| ゲージ | インデックスの空き領域を含む、データベース内のすべてのインデックスに割り当てられたディスク容量の合計。 |
| ゲージ | データベース内のすべてのコレクションにわたるインデックスの合計数。 |
| ゲージ | すべてのコレクションにわたるデータベース内のエクステント数。 |
| ゲージ | すべてのコレクションにわたるデータベース内のオブジェクト(具体的には、ドキュメント)の数。 |
| ゲージ | ドキュメントストレージ用にデータベース内のすべてのコレクションに割り当てられたディスク領域の合計(空き領域を含む)。 |
| ゲージ | データベース内のビュー数。 |
| カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシをマイクロ秒単位で提供する64ビット整数。 |
| カウンター | 読み取り、書込み、コマンド、および合計リクエストの最後のレポート間隔以降にコレクションで実行された操作の数を示す 64 ビットの整数。 |
| カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の50パーセンタイルに対する操作の数。 |
| カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の95パーセンタイルに対する操作の数。 |
| カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の99パーセンタイルに対する操作の数。 |
| カウンター | 指定されたクエリシェイプによってディスクからキャッシュに読み取られたバイト数。 |
| ゲージ | 指定されたクエリシェイプを持つクエリによって返されたドキュメントに対する検査されたドキュメントの割合。 |
| カウンター | 指定されたクエリシェイプを持つクエリによって検査されたドキュメントの合計数。 |
| カウンター | 指定されたクエリシェイプを持つクエリによって返されたドキュメントの合計数。 |
| カウンター | 特定のクエリシェイプを持つクエリが実行された合計回数。 |
| ゲージ | 特定のクエリシェイプを持つクエリによって返されたドキュメントを含むインデックスに対する検査された限界内のインデックス キーと限界外のインデックスキーの割合。 |
| カウンター | 指定されたクエリシェイプを持つクエリによって検査された、限界内のインデックス キーと限界外のインデックスキーの総数。 |
| ゲージ | 指定されたクエリシェイプ)。 |
| カウンター | クエリ処理の開始から最初のサーバー応答までに費やされた時間(マイクロ秒単位)。 |
| カウンター | 指定されたクエリシェイプでクエリの実行中に費やされた合計時間(ミリ秒)。クエリで |
| プロセス | すべてのシャードを対象とする検索操作の 1 秒あたりの割合。 |
| プロセス | 複数 のシャードを対象としているがすべてのシャードを対象としていない検索操作の 1 秒あたりの割合。 |
| プロセス | 正確に 1 つのシャードをターゲットとした検索操作の 1 秒あたりの割合。 |
| プロセス | シャーディングされていないコレクションに対する検索操作の 1 秒あたりの料金。 |
| プロセス | すべてのシャードを対象とする挿入操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードではなく複数のシャードを対象とする挿入操作の 1 秒あたりの割合。 |
| プロセス | 1 つのシャードのみを対象とする挿入操作の 1 秒あたりの割合。 |
| プロセス | シャーディングされていないコレクションに対する挿入操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードを対象とする更新操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードではなく複数のシャードを対象とする更新操作の 1 秒あたりの割合。 |
| プロセス | 1 つのシャードのみを対象とする更新操作の 1 秒あたりの割合。 |
| プロセス | シャーディングされていないコレクションに対する更新操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードを対象とする削除操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードではなく複数のシャードを対象とする削除操作の 1 秒あたりの割合。 |
| プロセス | 1 つのシャードのみを対象とする削除操作の 1 秒あたりの割合。 |
| プロセス | シャーディングされていないコレクションに対する削除操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードを対象とする集計操作の 1 秒あたりの割合。 |
| プロセス | すべてのシャードではなく複数のシャードを対象とする集計操作の 1 秒あたりのレート。 |
| プロセス | 1 つのシャードのみを対象とする集計操作の 1 秒あたりの割合。 |
| プロセス | シャーディングされていないコレクションに対する 1 秒あたりの集計操作の速度。 |
| MongoDB Search | すべてのMongoDB Search クエリで実行された |
| MongoDB Search | 削除されたドキュメントまたはフィールドの合計数(インデックス定義で指定)。 |
| MongoDB Search | MongoDB Searchインデックスに存在する一意のフィールドの合計数。 |
| MongoDB Search | ディスク上のすべてのインデックスの合計サイズ。 |
| MongoDB Search | ベクトル検索インデックスに必要なメモリ(バイト単位)。 |
| MongoDB Search | インデックス生成全体におけるインデックス付きフィールドの最大数。 |
| MongoDB Search | インデックス生成全体の nGram フィールドの最大数。 |
| MongoDB Search | インデックス生成全体における Lucene ドキュメントの最大数。 |
| MongoDB Search | MongoDB Search によってインデックスが作成されたドキュメントまたはフィールド(インデックス定義で指定)の合計数。 |
| MongoDB Search | |
| MongoDB Search | MongoDB Search が更新したドキュメントまたはフィールド(インデックス定義で指定)の合計数。 |
| MongoDB Search | MongoDB Search が応答を返せないクエリの合計数。 |
| MongoDB Search | MongoDB Search が正常に応答を返したクエリの合計数。 |
| MongoDB Search | MongoDB Search に送信されたクエリの合計数。 |
| MongoDB Search | 検索ノードのアドミッション制御キューのスレッショールドを超える検索クエリの1秒あたりのレート。キューに入ったクエリがこのスレッショールドを超えると、このメトリクスが増加します。 |
| MongoDB Search | 検索プロセスが意図されたキャパシティーを超えて動作していることを示す、検索プロセスがキューのスレッショルドを超えた 1 秒あたりの平均レート。持続的な非ゼロ値は、入力が受け入れられるよりも速く到着していることを示します。 |
| MongoDB Search | JVM ヒープが現在使用しているメモリの量。 |
| MongoDB Search | JVM ヒープ内の使用可能なメモリの合計。 |
| MongoDB Search | 検索プロセスによって使用される常駐メモリ。 |
| MongoDB Search | 検索プロセスによって使用される仮想記憶。 |
| MongoDB Search | 検索プロセスで使用される共有メモリ。 |
| ゲージ | 最後に読み取られた変更イベントと、oplog 内の最後のイベントとの遅延(秒単位)。 |
| カウンター | デッドレターキュー (DLQ) に送信されたメッセージの合計数。 |
| カウンター | デッドレターキュー (DLQ) に送信された合計バイト数。 |
| カウンター | 拒否されたドキュメントを含む、読み取られた入力メッセージの総数。 |
| カウンター | 拒否されたメッセージを含む、読み取られた入力バイトの合計数。 |
| ゲージ | すべてのパーティションラグの合計(Kafkaソースを使用するストリームプロセッサーにのみ適用されます)。 |
| ゲージ | デッドレターキュー (DLQ) に送信された最後のドキュメントのタイムスタンプ。 |
| ゲージ | 最後に処理されたドキュメントのタイムスタンプ。 |
| カウンター | 拒否されたドキュメントを含む、演算子ターゲットに対して読み取られた入力メッセージの合計数。 |
| カウンター | 演算子ターゲットに対して発行された出力メッセージの合計数。 |
| カウンター | 出力されたメッセージの合計数。 |
| カウンター | 出力されたバイト数の合計。 |
| カウンター | 入出力ペアに対して処理されたイベントの総数。 |
| ゲージ | 入力 + 出力の 50 番目のパーセンタイル レイテンシ(マイクロ秒単位)。 |
| ゲージ | プロセッサの 50 番目のパーセンタイル レイテンシ(マイクロ秒単位)。 |
| ゲージ | 失敗状態のストリーム プロセッサの数。 |
| ゲージ | 実行中状態のストリーム プロセッサの数。 |
| ゲージ | 停止状態のストリーム プロセッサの数。 |
| ゲージ | ストリーム プロセッサの現在のライフサイクル状態(整数として報告)。
|
| ゲージ | 現在使用されているコンテナの CPU 制限(cgroup)の割合。 |
| ゲージ | 現在使用されているコンテナのメモリ制限(cgroup)の割合。 |
Stream Processing メトリクスの名前には mongodb.atlas.stream_processing が付きます。Atlas Stream Processing モニタリングの詳細については、Atlas Stream Processing モニタリングとアラート を参照してください。