すべてのアラートの取得
項目一覧
注意
グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}
はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/alerts
リクエスト パス パラメーター
Parameter | タイプ | 説明 |
---|---|---|
プロジェクトID | string | (必須。) プロジェクト識別子。 |
リクエスト クエリ パラメータ
名前 | タイプ | 必要性 | 説明 | default |
---|---|---|---|---|
pageNum | 数値 | 任意 | 結果のサブセクションを返す 1 から始まる整数。 | 1 |
itemsPerPage | 数値 | 任意 | 1 ページあたりに返す項目の数は最大 500 です。 | 100 |
pretty | ブール値 | 任意 | レスポンス本体を pretty-print に含めるかどうかを示すフラグ 形式。 | false |
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の APIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリで 結果のリストを返すエンドポイントの場合、 | false |
backupJobsEnabledOnly | ブール値 | 任意 | データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。 これを false に設定し、 backupJobsEnabled フラグがfalse に設定されているデーモン構成を含めます。 | true |
名前 | タイプ | 必要性 | 説明 |
---|---|---|---|
status | string | 任意 | ステータスを指定して、指定したステータスのアラートのみを返します。 省略すると、すべてのアラートが返されます。 MongoDB Ops Manager は、次の値を受け入れます。
|
リクエスト ボディ パラメータ
このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。
応答
応答ドキュメント
レスポンスJSONドキュメントには、 resultオブジェクトの配列、 linkオブジェクトの配列、および取得されたresultオブジェクトの合計数が含まれます。
名前 | タイプ | 説明 |
---|---|---|
results | 配列 | 配列には、 results 埋め込みドキュメントセクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。 |
links | 配列 | 配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様 で説明されています。 |
totalCount | 数値 | 結果セット内の項目の合計数の整数。 結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。 |
results
embeddedDocument
各結果は 1 つのアラートです。
名前 | タイプ | 説明 |
---|---|---|
acknowledged Until | string | ISO8601 のタイムスタンプ アラートが確認されたまでの日付と時刻形式( UTC) 。 アラートが確認された場合、MongoDB Ops Manager はこの値を返します。 |
acknowledgement Comment | string | アラートを確認したユーザーが残すコメント。 アラートが確認された場合、MongoDB Ops Manager はこの値を返します。 |
acknowledging Username | string | アラートを確認したユーザーのユーザー名。 アラートが確認された場合、MongoDB Ops Manager はこの値を返します。 |
alertConfigId | string | このアラートをトリガーしたアラート構成の一意の識別子。 |
clusterId | string | このアラートが適用されるクラスターの一意の識別子。 MongoDB Ops Manager は次の場合にこの値を返します。
|
clusterName | string | このアラートが適用されるクラスターの名前。 MongoDB Ops Manager は次の場合にこの値を返します。
|
created | string | ISO8601 のタイムスタンプ アラートが開かれたときの UTC の日付と時刻形式。 |
currentValue | オブジェクト | アラートをトリガーしたメトリクスの現在の値。 MongoDB Ops Manager は |
currentValue .number | 数値 | メトリクスの値。 |
currentValue .units | string | 値の単位。 値は、メトリクスの型によって異なります。 たとえば、メモリ消費を測定するメトリクスにはバイト単位が含まれ、時間を測定するメトリクスには時間単位が含まれます。 MongoDB Ops Manager は次を返すことができます。
|
eventTypeName | string | アラートをトリガーしたイベントの名前。 アラートを生成するイベントの種類を確認するには、「アラートのタイプ 」を参照してください。 MongoDB Ops Managerの監査ログに含まれるイベントの完全なリストについては、「監査イベント 」を参照してください。 |
groupId | string | このアラートが開かれたグループの一意の識別子。 |
hostId | string | メトリクスが含まれるホストの一意の識別子。
|
hostnameAndPort | string | アラートが適用される各ホストのホスト名とポート。 これは、ホスト名、 FQDN 、 IPv4アドレス、またはIPv6アドレスにすることができます。
|
id | string | アラートの一意の識別子です。 |
lastNotified | string | ISO8601 のタイムスタンプ このアラートの最後の通知が送信された日時の UTC 形式の日付と時刻形式。通知が送信された場合、MongoDB Ops Manager はこの値を返します。 |
links | オブジェクトの配列 | サブリソースや関連リソースへの 1 つ以上のリンク。 応答内のすべての |
metricName | string | 値がしきい値を超えた測定値の名前。 MongoDB Ops Manager では、 可能な値については、「アラートの測定タイプ 」を参照してください。 |
replicaSetName | string | レプリカセットの名前。
|
resolved | string | ISO8601 のタイムスタンプ アラートが閉じられたときの日付と時刻形式( UTC) 。 MongoDB Ops Manager は |
status | string | アラートの現在の状態。 MongoDB Ops Manager は次のいずれかを返すことができます。
|
sourceTypeName | string |
|
tags | string 配列 | このアラートに設定された識別ラベル。 |
updated | string | ISO8601 のタイムスタンプ アラートが最後に更新されたときの UTC の日時形式。 |
アラートの測定タイプ
alerts
リソースは、 metricName
フィールドに測定型を返します。 このフィールドは、 eventTypeName
がOUTSIDE_METRIC_THRESHOLD
に設定されている場合にのみ存在します。
ホスト測定値
| serverStatusコマンドが生成する asserts ドキュメントにある MongoDB プロセスのアサートのレート。 |
| バックグラウンドでフラッシュされるデータの量。 |
| serverStatus コマンドが生成する ドキュメントと ドキュメントにある WiredTiger ストレージ エンジン wiredTiger.cache wiredTiger.concurrentTransactions キャッシュ内のバイト数。 |
| serverStatusコマンドが生成する connections ドキュメントにある MongoDB プロセスへの接続の数。 |
| |
| MongoDB プロセスの Memory Issues とPage Faults の数。 |
| serverStatusコマンドが生成する MongoDB プロセスのロックを待機している操作の数。 MongoDB Ops Managerは、storage engine のタイプに基づいてこれらの値を計算します。 |
| インデックス b木操作の数。 |
| ジャーナリング操作 の数。 |
| serverStatusコマンドが収集する mem ドキュメントにある MongoDB プロセスのメモリの量。 |
| serverStatusコマンドが収集する network ドキュメントにある MongoDB プロセスのスループットの量。 |
| MongoDB プロセスのoplog の期間とスループット。 |
| MongoDB dbStats コマンドから収集された、ディスク上のストレージ容量。 |
| serverStatusコマンドが収集する opcounters ドキュメントで、プロセスが最後に開始されてからの MongoDB プロセスでのデータベース操作の速度。 |
| |
| 選択した期間中に、1 秒あたりに返される、挿入、更新、または削除されるドキュメントの平均レート。 |
| ソートを実行するが、インデックスを使用してソートを実行できない、選択した期間における 1 秒あたりの操作の平均レート。 |
| 選択した期間中の読み取り、書込み、またはコマンド操作あたりの平均実行時間(ミリ秒)。 MongoDB 3.4 以降を実行しているホストで使用できます。 |
| 過去 1 時間以内にホストが再起動した回数。 |
| 物理メモリ使用量(バイト単位)。 |
| ネットワーク スループット(1 秒あたりのバイト数単位)。 |
| 使用中のスワップ領域の合計量。 |
| explainコマンドの totalKeysExamined の値に表示される、クエリおよびクエリプランの評価中にインデックス項目をスキャンするための 1 秒あたりの平均レート。 |
| クエリおよびクエリプランの評価中に 1 秒あたりにスキャンされるドキュメントの平均レートは、 explainコマンドの totalDocsExamined の値にあります。 |
| 返されたドキュメント数に対するスキャンされたインデックス数の比率。 |
| 返されたドキュメント数に対するスキャンされたドキュメント数の比率。 |
リクエストの例
次の例では、すべてのOPEN
アラートが返されます。
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/alerts?status=OPEN&pretty=true"
応答例
応答ヘッダー
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
レスポンス本体
1 { 2 "links" : [ { 3 "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/alerts?status=OPEN&pretty=true&pageNum=1&itemsPerPage=100", 4 "rel" : "self" 5 } ], 6 "results" : [ { 7 "alertConfigId" : "5953c5f380eef53887615fd4", 8 "created" : "2019-07-18T23:43:50Z", 9 "eventTypeName" : "MONITORING_AGENT_DOWN", 10 "groupId" : "{PROJECT-ID}", 11 "id" : "5d31043680eef5280d3664e0", 12 "lastNotified" : "2019-09-25T11:50:08Z", 13 "links" : [ { 14 "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/alerts/5d31043680eef5280d3664e0", 15 "rel" : "self" 16 } ], 17 "status" : "OPEN", 18 "tags" : [ ], 19 "updated" : "2019-07-18T23:43:50Z" 20 } ], 21 "totalCount" : 1 22 }