AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

すべてのグローバル アラートを取得

Retrieve all global alerts.

必須のロール

割り当てられた次のいずれかのロールを使用して、このエンドポイントを正常に呼び出すことができます。

リクエスト

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /globalAlerts

リクエスト パス パラメーター

このエンドポイントは、HTTP リクエスト パス パラメーターを使用しません。

リクエスト クエリ パラメータ

名前
タイプ
必要性
説明
default

pageNum

数値

任意

結果のサブセクションを返す 1 から始まる整数。

1

itemsPerPage

数値

任意

1 ページあたりに返す項目の数は最大 500 です。

100

pretty

ブール値

任意

レスポンス本体を pretty-print形式にするかどうかを示すフラグ。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope : true を設定します。

結果のリストを返すエンドポイントの場合、 contentオブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体にstatusフィールドを追加します。

false

名前
タイプ
必要性
説明
default

status

string

任意

返したいアラートのステータス。 MongoDB Ops Manager は、指定したステータスに一致するアラートを返します。 受け入れ可能な値は以下の通りです。

  • TRACKING: アラート条件は存在していますが、その条件がアラートをtriggerするに十分なく長く続いていません。

  • OPEN：アラートが開いています

  • CLOSED: アラートが閉じられました。

なし

createdOnOrAfter

string

任意

返却対象のアラートの作成日（ISO 8601形式）。MongoDB Ops Manager は、指定した日付以降に作成されたアラートを返します。

なし

createdOnOrBefore

string

任意

返却対象のアラートの作成日（ISO 8601）。MongoDB Ops Manager は、指定した日付またはそれ以前に作成されたアラートを返します。

なし

リクエスト ボディ パラメータ

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答

応答ドキュメント

応答JSONドキュメントには、resultオブジェクトの配列、linkオブジェクトの配列、および検索されたresultオブジェクトの合計数のカウントが含まれます。

名前
タイプ
説明

results

配列

配列には、results 埋め込みドキュメント セクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。

links

配列

配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様 で説明されています。

totalCount

数値

結果セット内の項目の合計数の整数。 結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。

results embeddedDocument

各結果は 1 つのアラートです。

名前
タイプ
説明

acknowledgedUntil

string

アラートが確認されたことを示すISO 8601 日付と時刻の形式のUTC タイムスタンプ。MongoDB Ops Manager は、ユーザーがこのアラートを認識した場合に、このフィールドを表示します。

acknowledgementComment

string

このアラートを確認したユーザーが残すコメント。 MongoDB Ops Manager は、ユーザーがこのアラートを確認した場合、このフィールドを表示します。

acknowledgingUsername

string

アラートを確認したユーザーの MongoDB Ops Manager ユーザー名 。 MongoDB Ops Manager は、ユーザーがこのアラートを確認した場合、このフィールドを表示します。

alertConfigId

string

このアラートをトリガーしたグローバル アラート構成の一意の識別子。

clusterId

string

このアラートが適用されるクラスターの一意の識別子。 MongoDB Ops Manager は、次のカテゴリ内のグローバル アラートに対してこのフィールドを返します。

clusterName

string

このアラートが適用されるクラスターに名前を付けます。 MongoDB Ops Manager は、次のカテゴリ内のグローバル アラートに対してこのフィールドを返します。

created

string

ISO 8601 の日付と時刻形式のタイムスタンプ。アラートが作成された時の日付と時刻形式（UTC）。

currentValue

オブジェクト

アラートをトリガーしたメトリクスの現在の値。 MongoDB Ops Manager は、ホストのカテゴリ内のグローバル アラートでこのフィールドを返します。

currentValue.number

数値

メトリクスの現在の値。

currentValue.units

string

currentValue.numberの単位。 単位はメトリクスの型によって異なります。

指定できる値は次のとおりです。

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

例、メモリ消費を測定するメトリクスにはBYTESを使用でき、時間を測定するメトリクスにはHOURSを使用できます。

eventTypeName

string

アラートをトリガーしたイベントの名前。

アラートを生成するイベントの種類を確認するには、「アラートのタイプ 」を参照してください。

MongoDB Ops Managerの監査ログに含まれるイベントの完全なリストについては、「監査イベント 」を参照してください。

groupId

string

このアラートが開かれたプロジェクトの一意の識別子。

hostId

string

メトリクスが属するホストの一意の識別子。 MongoDB Ops Manager は、次のカテゴリ内のグローバル アラートに対してこのフィールドを返します。

hostnameAndPort

string

アラートが適用される各ホストするのホスト名とポート。ホスト名は、ホスト名、FQDN、IPv4アドレス、またはIPv6アドレスのみにできます。MongoDB Ops Managerは、次のカテゴリのグローバルアラートに対してこのフィールドを返します。

id

string

アラートの一意の識別子。

lastNotified

string

ISO 8601 のタイムスタンプ このアラートの最後の通知が送信されたときの日付と時刻形式（UTC） 。Ops Manager は、Ops Manager が通知を送信した場合にこれを表示します。

metricName

string

値がしきい値を超えた測定値の名前。 MongoDB Ops Manager は"eventTypeName" : "OUTSIDE_METRIC_THRESHOLD"の場合にこのフィールドを返します。

可能な値については、「グローバル アラートの測定タイプ 」を参照してください。

replicaSetName

string

レプリカセットの名前。 MongoDB Ops Manager は、次のカテゴリ内のグローバル アラートに対してこのフィールドを返します。

resolved

string

アラートが閉じられたときの ISO8601 の日付と時刻形式の UTC のタイムスタンプ。 MongoDB Ops Manager"status" : "CLOSED" は、 の場合、グローバル アラートでこのフィールドを返します。

sourceTypeName

string

バックアップされるホストのタイプ。 MongoDB Ops Manager は、バックアップの カテゴリのグローバル アラートにこのフィールドを返します。 返される可能性のある値は次のとおりです。

  • REPLICA_SET

  • SHARDED_CLUSTER

  • CONFIG_SERVER

status

string

アラートの現在の状態。 返される可能性のある値は次のとおりです。

  • TRACKING: アラート条件は存在していますが、その条件がアラートをtriggerするに十分なく長く続いていません。

  • OPEN：アラートが開いています

  • CLOSED: アラートが閉じられました。

  • CANCELLED: アラートがキャンセルされました。

tags

文字列の配列

このアラートに関連付けられているタグ。

typeName

string

このフィールドは非推奨であり、無視されます。

updated

string

このアラートが最後に更新されたときの ISO の日付と時刻形式（UTC）のタイムスタンプ。8601

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \     --header "Accept: application/json" \     --include \     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlerts"

応答例

応答ヘッダー

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

レスポンス本体

{  "links": [],  "results": [{      "alertConfigId": "{ALERT-CONFIG-ID}",      "created": "2019-11-29T20:26:30Z",      "eventTypeName": "BACKUP_AGENT_DOWN",      "groupId": "{PROJECT-ID}",      "id": "{ALERT-ID}",      "lastNotified": "2020-04-09T20:21:00Z",      "links": [],      "status": "OPEN",      "tags": [],      "typeName": "AGENT",      "updated": "2019-11-29T20:26:30Z"    },    {      "alertConfigId": "{ALERT-CONFIG-ID}",      "created": "2019-11-29T20:43:00Z",      "eventTypeName": "BACKUP_AGENT_DOWN",      "groupId": "{PROJECT-ID}",      "id": "{ALERT-ID}",      "lastNotified": "2020-04-09T20:21:54Z",      "links": [],      "status": "OPEN",      "tags": [],      "typeName": "AGENT",      "updated": "2019-11-29T20:43:00Z"    },    {      "alertConfigId": "{ALERT-CONFIG-ID}",      "created": "2019-11-30T12:27:07Z",      "eventTypeName": "BACKUP_AGENT_DOWN",      "groupId": "{PROJECT-ID}",      "id": "{ALERT-ID}",      "lastNotified": "2020-04-09T20:20:33Z",      "links": [],      "status": "OPEN",      "tags": [],      "typeName": "AGENT",      "updated": "2019-11-30T12:27:07Z"    }  ],  "totalCount": 3}
戻る
グローバル アラート
次へ
1 つの取得
このページを評価

項目一覧