Datadog との統合
Atlas を設定して、プロジェクトに関するメトリック データを Datadog ダッシュボードに送信することができます。
注意
アラートとイベントを Datadog に送信するように Atlas プロジェクトを構成する場合は、この手順に従う必要はありません。Atlas は、 アラートとイベントの送信に使用されるのと同じ統合で、プロジェクト メトリクスを Datadog に送信します。
Datadog を構成して Atlas アラートを受信することもできます。詳細については、「通知オプション」を参照してください。
必要なアクセス権
Atlas を Datadog と統合するには、プロジェクトに対する Project Owner アクセス権が必要です。Organization Ownerアクセス権を持つユーザーは、自分自身を Project Owner としてプロジェクトに追加する必要があります。
前提条件
Datadog 統合は、M10+ クラスターでのみ使用できます。
注意
タグは、Datadog 統合ではサポートされていません。Datadog と統合するには、引き続きラベルを使用します。ラベルを定義するには、Modify One Cluster API エンドポイントの labels パラメーターを使用します。
Atlas を Datadog と統合するには、Datadog アカウントと Datadog API キーが必要です。Datadog の API キーは、初めて Datadog アカウントを作成するときに付与されます。
既存の Datadog アカウントをお持ちでない場合は、https://app.datadoghq.com/signup. でサインアップできます。
手順
Atlas CLI を使用して Datadog 統合を作成または更新するには、次のコマンドを実行します。
atlas integrations create DATADOG [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントの「 Atlas integrations create DATADOG 」を参照してください。
Atlas UI を使用して、次のように Atlas と Datadog の統合を構成します。
1
Atlas で、Project Integrations ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Projects メニューの横にある Options メニューをクリックし、 Integrations をクリックします。
プロジェクト統合ページが表示されます。
2
Datadog API キーを使用して、Datadog をプロジェクトにリンクします。
Datadog integration card（統合カード）で [Configure] をクリックします。
入力ボックスに Datadog API キーを入力します。
API リージョンを選択します。
Atlas は、Atlas UI で次の Datadog リージョンをサポートしています。
US1US3US5EU1AP1
Datadog はデフォルトで
US1を使用します。Datadog のリージョンの詳細については、Datadog サイトを参照してください。
[Save] をクリックします。
Datadog で利用可能なパフォーマンスメトリクス
Datadog は、Atlas クラスターの次のメトリック データを追跡します。括弧内のメトリクス名は Datadog の UI で使用されます。
メトリクス名 | メトリクス型 | 説明 |
|---|---|---|
CONNECTIONS(mongodb.atlas.connections.current) | プロセス | クラスターで現在開いている開いている接続の数。 |
DB_STORAGE_TOTAL(mongodb.atlas.stats.totalstoragesize) DB_DATA_SIZE_TOTAL(mongodb.atlas.stats.totaldatasize) DB_INDEX_SIZE_TOTAL(mongodb.atlas.stats.totalindexsize) | プロセス | クラスター上のデータベース ストレージ サイズ、データ サイズ、およびインデックス サイズの合計（バイト単位）。 |
DISK_LATENCY_READS(mongodb.atlas.system.disk.latency.reads) DISK_LATENCY_WRITES(mongodb.atlas.system.disk.latency.writes) | Disk | 読み取りリクエストと書き込みリクエストの遅延ゲージ（ミリ秒単位）。 |
DISK_MAX_LATENCY_READS(mongodb.atlas.system.disk.max.latency.reads) DISK_MAX_LATENCY_WRITES(mongodb.atlas.system.disk.max.latency.writes) | Disk | 読み取りリクエストと書込みリクエストの最大遅延ゲージ（ミリ秒単位）。 |
DISK_QUEUE_DEPTH(mongodb.atlas.system.disk.queuedepth) | Disk | メトリック粒度で指定された期間にわたって MongoDB が使用するディスク パーティションに発行されたリクエストのキューの平均長。 |
MAX_DISK_QUEUE_DEPTH(mongodb.atlas.system.disk.max.queuedepth) | Disk | MongoDB が使用するディスク パーティションに発行されたリクエストのキューの平均長さについて、メトリクス粒度で指定された期間の最大値。 |
DOCUMENT_METRICS_RETURNED(mongodb.atlas.metrics.document.returned) DOCUMENT_METRICS_INSERTED(mongodb.atlas.metrics.document.inserted) DOCUMENT_METRICS_UPDATED(mongodb.atlas.metrics.document.updated) DOCUMENT_METRICS_DELETED(mongodb.atlas.metrics.document.deleted) | プロセス | 1 秒あたりに読み取られるまたは書込まれるドキュメントの数。 |
NETWORK_BYTES_IN(mongodb.atlas.network.bytes.in) | プロセス | 1 秒あたりにデータベース サーバーに送信される物理バイトの平均レート（ワイヤ圧縮後）。 |
NETWORK_BYTES_OUT(mongodb.atlas.network.bytes.out) | プロセス | データベース サーバーから 1 秒あたりに送信される物理バイトの平均レート（ワイヤ圧縮後）。 |
NETWORK_NUM_REQUESTS(mongodb.atlas.network.num.requests) | プロセス | 1 秒あたりにデータベース サーバーに送信されるリクエストの平均レート。 |
OPCOUNTER_CMD(mongodb.atlas.opcounters.command) OPCOUNTER_QUERY(mongodb.atlas.opcounters.query) OPCOUNTER_UPDATE(mongodb.atlas.opcounters.update) OPCOUNTER_DELETE(mongodb.atlas.opcounters.delete) OPCOUNTER_GETMORE(mongodb.atlas.opcounters.getmore) OPCOUNTER_INSERT(mongodb.atlas.opcounters.insert) | プロセス | 1 秒あたりの操作数（操作の種類別）。 |
OP_EXECUTION_TIME_READS(mongodb.atlas.oplatencies.reads.avg) OP_EXECUTION_TIME_WRITES(mongodb.atlas.oplatencies.writes.avg) OP_EXECUTION_TIME_COMMANDS(mongodb.atlas.oplatencies.commands.avg) | プロセス | 操作型別に分けられた平均操作時間（ミリ秒単位）。 |
QUERY_TARGETING_SCANNED_OBJECTS_PER_RETURNED(mongodb.atlas.metrics.queryexecutor.scannedobjectsperreturned) | プロセス | 返されたオブジェクトに対するスキャンされたオブジェクトの数を測定する比率。値が低いほど、クエリの効率が高くなります。 |
REPLICATION_LAG(mongodb.atlas.replset.replicationlag) | プロセス | セカンダリへの更新がプライマリへの更新より遅れる時間（秒単位）。 |
REPLICATION_OPLOG_WINDOW(mongodb.atlas.replset.oplogWindow) | プロセス | プライマリのレプリケーション oplog で利用可能なデータベース操作の推定平均数（秒単位）。このメトリクスは、oplog のチャーンに基づいています。セカンダリ ノードのレプリケーション ラグがレプリケーション oplog ウィンドウを超え、レプリケーション ヘッドルームがゼロになった場合は、完全再同期が必要です。 |
REPLICATION_STATUS_HEALTH(mongodb.atlas.replstatus.health) | プロセス | レプリカセット ノードの正常性を示す数値。 次のシナリオでは、不正確なヘルス ステータスが表示される場合があります。
重要: ヘルスステータスが |
REPLICATION_STATUS_STATE(mongodb.atlas.replstatus.state) | プロセス | |
SYSTEM_MEMORY_USED(mongodb.atlas.system.memory.used) SYSTEM_MEMORY_AVAILABLE(mongodb.atlas.system.memory.available) | システム | 使用されている物理メモリをバイト単位で示すゲージ。 |
MAX_SYSTEM_MEMORY_USED(mongodb.atlas.system.memory.max.used) MAX_SYSTEM_MEMORY_AVAILABLE(mongodb.atlas.system.memory.max.available) | システム | 使用されている最大物理メモリをバイト単位で示すゲージ。 |
SYSTEM_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.norm.user) SYSTEM_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.norm.kernel) SYSTEM_NORMALIZED_CPU_NICE(mongodb.atlas.system.cpu.norm.nice) SYSTEM_NORMALIZED_CPU_IOWAIT(mongodb.atlas.system.cpu.norm.iowait) SYSTEM_NORMALIZED_CPU_IRQ(mongodb.atlas.system.cpu.norm.irq) SYSTEM_NORMALIZED_CPU_SOFTIRQ(mongodb.atlas.system.cpu.norm.softirq) SYSTEM_NORMALIZED_CPU_GUEST(mongodb.atlas.system.cpu.norm.guest) SYSTEM_NORMALIZED_CPU_STEAL(mongodb.atlas.system.cpu.norm.steal) | システム | サーバーのさまざまなプロセス全体で論理 CPU によって使用された時間の割合。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
MAX_SYSTEM_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.max.norm.user) MAX_SYSTEM_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.max.norm.kernel) MAX_SYSTEM_NORMALIZED_CPU_NICE(mongodb.atlas.system.cpu.max.norm.nice) MAX_SYSTEM_NORMALIZED_CPU_IOWAIT(mongodb.atlas.system.cpu.max.norm.iowait) MAX_SYSTEM_NORMALIZED_CPU_IRQ(mongodb.atlas.system.cpu.max.norm.irq) MAX_SYSTEM_NORMALIZED_CPU_SOFTIRQ(mongodb.atlas.system.cpu.max.norm.softirq) MAX_SYSTEM_NORMALIZED_CPU_GUEST(mongodb.atlas.system.cpu.max.norm.guest) MAX_SYSTEM_NORMALIZED_CPU_STEAL(mongodb.atlas.system.cpu.max.norm.steal) | システム | サーバーのさまざまなプロセスにわたって論理 CPU によって使用された時間の割合について、メトリック粒度で指定された期間の最大値。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
PROCESS_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.mongoprocess.norm.user) PROCESS_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.mongoprocess.norm.kernel) PROCESS_NORMALIZED_CPU_CHILDREN_USER(mongodb.atlas.system.cpu.mongoprocess.norm.childrenuser) PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL(mongodb.atlas.system.cpu.mongoprocess.norm.childrenkernel) | プロセス | サーバー内の MongoDB プロセスに固有のさまざまなプロセス全体で論理 CPU によって使用された時間の割合。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
MAX_PROCESS_NORMALIZED_CPU_USER(mongodb.atlas.system.cpu.mongoprocess.max.norm.user) MAX_PROCESS_NORMALIZED_CPU_KERNEL(mongodb.atlas.system.cpu.mongoprocess.max.norm.kernel) MAX_PROCESS_NORMALIZED_CPU_CHILDREN_USER(mongodb.atlas.system.cpu.mongoprocess.max.norm.childrenuser) MAX_PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL(mongodb.atlas.system.cpu.mongoprocess.max.norm.childrenkernel) | プロセス | サーバー内の MongoDB プロセスに固有のさまざまなプロセスにわたって論理 CPU によって使用された時間の割合に対する、メトリック粒度で指定された期間の最大値。これらの値は、論理 CPU コアの数を基準に正規化されています。 |
MEMORY_RESIDENT(mongodb.atlas.mem.resident) MEMORY_VIRTUAL(mongodb.atlas.mem.virtual) | プロセス | サーバー上の MongoDB プロセスによって消費されるメモリ（ MB 内）をメモリ型別に表示します。 |
OPCOUNTER_REPL_CMD(mongodb.atlas.opcountersrepl.command) OPCOUNTER_REPL_UPDATE(mongodb.atlas.opcountersrepl.update) OPCOUNTER_REPL_DELETE(mongodb.atlas.opcountersrepl.delete) OPCOUNTER_REPL_INSERT(mongodb.atlas.opcountersrepl.insert) | プロセス | MongoDB セカンダリ でのデータベース操作の速度を測定します。これは、MongoDB これらのメトリクスは、クラスター メトリクス の Opcounters - Repl チャートで確認できます。 |
OPLOG_RATE_GB_PER_HOUR(mongodb.atlas.replset.oplograte) | プロセス | プライマリが生成する oplog の平均速度（1 時間あたりギガバイト単位）。 |
TOTAL_NUMBER_OF_GETMORE_COMMANDS(mongodb.atlas.search.index.stats.commands.getmore) | Atlas Search | すべての Atlas 検索クエリで実行された getmore コマンドの合計数。 |
TOTAL_NUMBER_OF_DELETES(mongodb.atlas.search.index.stats.deletes) | Atlas Search | 削除されたドキュメントまたはフィールドの合計数（インデックス定義で指定）。 |
TOTAL_NUMBER_OF_INDEX_FIELD(mongodb.atlas.search.index.stats.index.fields) | Atlas Search | Atlas Search インデックスに存在するユニークなフィールドの合計数。 |
TOTAL_INDEX_SIZE_ON_DISK(mongodb.atlas.search.index.stats.index.size) | Atlas Search | ディスク上のすべてのインデックスの合計サイズ。 |
TOTAL_NUMBER_OF_INSERTS_SERIES(mongodb.atlas.search.index.stats.inserts) | Atlas Search | Atlas Search によってインデックスが作成されたドキュメントまたはフィールド（インデックス定義で指定）の合計数。 |
MAX_REPLICATION_LAG(mongodb.atlas.search.index.stats.max.replication.lag) | Atlas Search | |
TOTAL_NUMBER_OF_UPDATES(mongodb.atlas.search.index.stats.updates) | Atlas Search | Atlas Search が更新したドキュメントまたはフィールド（インデックス定義で指定）の合計数。 |
TOTAL_NUMBER_OF_ERROR_QUERIES(mongodb.atlas.search.index.stats.queries.error) | Atlas Search | Atlas Search が応答を返すことができないクエリの合計数。 |
TOTAL_NUMBER_OF_SUCCESS_QUERIES(mongodb.atlas.search.index.stats.queries.success) | Atlas Search | Atlas Search が正常に応答を返したクエリの合計数。 |
TOTAL_NUMBER_OF_TOTAL_QUERIES(mongodb.atlas.search.index.stats.queries.total) | Atlas Search | Atlas Search に送信されたクエリの合計数。 |
JVM_CURRENT_MEMORY(mongodb.atlas.search.jvm.current.memory) | Atlas Search | JVM ヒープが現在使用しているメモリの量。 |
JVM_MAX_MEMORY(mongodb.atlas.search.jvm.max.memory) | Atlas Search | JVM ヒープ内の使用可能なメモリの合計。 |
DISK_PARTITION_SPACE_FREE(mongodb.atlas.system.disk.space.free) DISK_PARTITION_SPACE_USED(mongodb.atlas.system.disk.space.used) DISK_PARTITION_SPACE_PERCENT_FREE(mongodb.atlas.system.disk.space.percentfree) DISK_PARTITION_SPACE_PERCENT_USED(mongodb.atlas.system.disk.space.percentused) | Disk | MongoDB が使用するディスク パーティションの空きディスク容量と使用済みディスク容量（バイト単位）を測定します。 |
MAX_DISK_PARTITION_SPACE_FREE(mongodb.atlas.system.disk.max.space.free) MAX_DISK_PARTITION_SPACE_USED(mongodb.atlas.system.disk.max.space.used) MAX_DISK_PARTITION_SPACE_PERCENT_FREE(mongodb.atlas.system.disk.max.space.percentfree) MAX_DISK_PARTITION_SPACE_PERCENT_USED(mongodb.atlas.system.disk.max.space.percentused) | Disk | MongoDB が使用するディスク パーティション上の空きディスク容量と使用済みディスク容量（バイト単位）の、メトリクス粒度で指定された期間の最大値。 |
DISK_PARTITION_IOPS_READ(mongodb.atlas.system.disk.iops.reads) DISK_PARTITION_IOPS_WRITE(mongodb.atlas.system.disk.iops.writes) DISK_PARTITION_IOPS_TOTAL(mongodb.atlas.system.disk.iops.total) | Disk | MongoDB 用ディスク パーティションの IOPS のスループットを測定します。 |
MAX_DISK_PARTITION_IOPS_READ(mongodb.atlas.system.disk.max.iops.reads) MAX_DISK_PARTITION_IOPS_WRITE(mongodb.atlas.system.disk.max.iops.writes) MAX_DISK_PARTITION_IOPS_TOTAL(mongodb.atlas.system.disk.max.iops.total) | Disk | メトリクスの粒度で指定された期間における、MongoDB 用ディスク パーティションの IOPS スループットの最大値 |
SYSTEM_NETWORK_BYTES_IN(mongodb.atlas.system.network.bytes.in) | システム | 1 秒あたりの物理バイト数の平均受信速度。 |
SYSTEM_NETWORK_BYTES_OUT(mongodb.atlas.system.network.bytes.out) | システム | 1 秒あたりの物理バイト数の平均送信速度。 |
MAX_SYSTEM_NETWORK_IN(mongodb.atlas.system.network.max.bytes.in) | システム | メトリック粒度で指定された期間における、1 秒あたりに受信される物理バイトの平均速度の最大値。 |
MAX_SYSTEM_NETWORK_OUT(mongodb.atlas.system.network.max.bytes.out) | システム | メトリック粒度で指定された期間における、1 秒あたりに送信される物理バイトの平均速度の最大値。 |
CACHE_BYTES_READ_INTO(mongodb.atlas.wiredtiger.cache.bytes_read_into_cache) CACHE_BYTES_WRITTEN_FROM(mongodb.atlas.wiredtiger.cache.bytes_written_from_cache) | プロセス | WiredTiger のキャッシュ に読み取られるバイトと書き込まれるバイトの平均レートを測定します。 |
CACHE_USED_BYTES(mongodb.atlas.wiredtiger.cache.bytes_currently_in_cache) CACHE_DIRTY_BYTES(mongodb.atlas.wiredtiger.cache.tracked_dirty_bytes_in_cache) | プロセス | WiredTiger のキャッシュ内のデータのバイト数とダーティ データのバイト数を測定します。 |
TICKETS_AVAILABLE_READS(mongodb.atlas.wiredtiger.concurrenttransactions.read.available) TICKETS_AVAILABLE_WRITES(mongodb.atlas.wiredtiger.concurrenttransactions.write.available) | プロセス | ストレージ エンジンでの読み取りおよび書き込み操作の数を測定します。 |
GLOBAL_LOCK_CURRENT_QUEUE_READERS(mongodb.atlas.global.lock.current.queue.readers) GLOBAL_LOCK_CURRENT_QUEUE_WRITERS(mongodb.atlas.global.lock.current.queue.writers) GLOBAL_LOCK_CURRENT_QUEUE_TOTAL(mongodb.atlas.global.lock.current.queue.total) | グローバル | Atlas が読み取り、書き込み、または読み取りと書き込みの組み合わせで保持している ロック が原因で現在キューに入れられている操作の数を示すゲージ。 |
AVG_OBJECT_SIZE(dbstats.avg.object.size) | ゲージ | |
COLLECTIONS(mongodb.atlas.dbstats.collections) | ゲージ | データベース内のコレクションの数。 |
DATA_SIZE(mongodb.atlas.dbstats.data.size) | ゲージ | データベースに保持されている非圧縮データの合計サイズ。 |
FILE_SIZE(mongodb.atlas.dbstats.file.size) | ゲージ | MongoDB がデータを保存するファイルシステムで使用中のすべてのディスク領域の合計サイズ。 |
INDEX_SIZE(mongodb.atlas.dbstats.index.size) | ゲージ | インデックスの空き領域を含む、データベース内のすべてのインデックスに割り当てられたディスク容量の合計。 |
INDEXES(mongodb.atlas.dbstats.indexes) | ゲージ | データベース内のすべてのコレクションにわたるインデックスの合計数。 |
NUM_EXTENTS(mongodb.atlas.dbstats.num.extents) | ゲージ | すべてのコレクションにわたるデータベース内のエクステント数のカウントが含まれます。 |
OBJECTS(mongodb.atlas.dbstats.objects) | ゲージ | すべてのコレクションにわたるデータベース内のオブジェクト（具体的には、ドキュメント）の数。 |
STORAGE_SIZE(mongodb.atlas.dbstats.storage.size) | ゲージ | ドキュメントストレージ用にデータベース内のすべてのコレクションに割り当てられたディスク領域の合計（空き領域を含む）。 |
VIEWS(mongodb.atlas.dbstats.views) | ゲージ | データベース内のビュー数。 |
COLLECTION_READ_LATENCY(mongodb.atlas.latencyStats.read.sum) COLLECTION_WRITE_LATENCY(mongodb.atlas.latencyStats.write.sum) COLLECTION_COMMANDS_LATENCY(mongodb.atlas.latencyStats.write.sum) COLLECTION_TOTAL_LATENCY(mongodb.atlas.latencyStats.total.sum) | カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシをマイクロ秒単位で提供する64ビット整数。 |
COLLECTION_READ_OPS(mongodb.atlas.latencyStats.read.count) COLLECTION_WRITE_OPS(mongodb.atlas.latencyStats.write.count) COLLECTION_COMMANDS_OPS(mongodb.atlas.latencyStats.write.count) COLLECTION_TOTAL_OPS(mongodb.atlas.latencyStats.total.count) | カウンター | 読み取り、書込み、コマンド、および合計リクエストについて、起動以降にコレクションに対して実行された操作の数を示す64ビット整数。 |
READ_HISTOGRAM_P50(mongodb.atlas.latencyStats.read.p50) WRITE_HISTOGRAM_P50(mongodb.atlas.latencyStats.write.p50) COMMANDS_HISTOGRAM_P50(mongodb.atlas.latencyStats.commands.p50) TOTAL_HISTOGRAM_P50(mongodb.atlas.latencyStats.total.p50) | カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の50パーセンタイルに対する操作の数。 |
READ_HISTOGRAM_P95(mongodb.atlas.latencyStats.read.p95) WRITE_HISTOGRAM_P95(mongodb.atlas.latencyStats.write.p95) COMMANDS_HISTOGRAM_P95(mongodb.atlas.latencyStats.commands.p95) TOTAL_HISTOGRAM_P95(mongodb.atlas.latencyStats.total.p95) | カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の95パーセンタイルに対する操作の数。 |
READ_HISTOGRAM_P99(mongodb.atlas.latencyStats.read.p99) WRITE_HISTOGRAM_P99(mongodb.atlas.latencyStats.write.p99) COMMANDS_HISTOGRAM_P99(mongodb.atlas.latencyStats.commands.p99) TOTAL_HISTOGRAM_P99(mongodb.atlas.latencyStats.total.p99) | カウンター | 読み取り、書込み、コマンド、および合計リクエストのレイテンシ ヒストグラム内の99パーセンタイルに対する操作の数。 |
Datadog で利用可能なタグ
クラスター タグに加えて、Datadog は次のタグを特定のメトリクスのラベルとして送信します。
Datadog Tags | 説明 |
|---|---|
organizationname | メトリクスに関連付けられた Atlas 組織。 |
projectname | メトリクスに関連付けられた Atlas プロジェクト。 |
clustername | メトリクスに関連付けられた Atlas クラスター。 |
replicasetname | メトリクスに関連付けられたレプリカセット。 |
shardedclustername | メトリクスに関連付けられた シャーディングされたクラスター 。 |
databasename | メトリクスに関連付けられているデータベース。 |
collectionname | メトリクスに関連付けられたコレクション。 |
hostnameport | Atlas のホスト名に関連付けられたポート番号。 |
hostnamestate | Atlas ホスト名の状態（プライマリ、セカンダリ、または個々のプロセス）。 このタグを使用すると、シャーディングされたクラスターまたはレプリカセットをクエリするときに、コレクションレベルのレイテンシ メトリクスをフィルタリングできます。 |