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

項目一覧

必須のロール

リクエスト
リクエストパスパラメーター
リクエストクエリパラメータ
リクエストボディパラメータ
応答
応答ドキュメント
results embeddedDocument
リクエストの例
応答例
応答ヘッダー
レスポンス本体

MongoDB Ops Manager v6.0 は 1 月 2025 で EOL になります。可能な限りすぐに MongoDB Ops Manager の上位バージョンにアップグレードしてください。

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`を設定します。結果のリストを返すエンドポイントの場合、 `results`オブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体に`status`フィールドを追加します。	`false`
backupJobsEnabledOnly	ブール値	任意	データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。これを`false`に設定し、 `backupJobsEnabled`フラグが`false`に設定されているデーモン構成を含めます。	`true`

status

string

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

`TRACKING`	アラート条件は存在しますが、その条件がアラートをtriggerするのに十分な期間保持されていなかった。
`OPEN`	アラートが開いています。
`CLOSED`	アラートが閉じられます。

なし

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

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

応答

応答ドキュメント

レスポンスJSONドキュメントには、 resultオブジェクトの配列、 linkオブジェクトの配列、および取得されたresultオブジェクトの合計数が含まれます。

名前	タイプ	説明
`results`	配列	配列には、 `results`埋め込みドキュメントセクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。
`links`	配列	配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様で説明されています。
`totalCount`	数値	結果セット内の項目の合計数の整数。結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。

`results` embeddedDocument

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

名前

タイプ

説明

acknowledgedUntil

string

ISO8601 のタイムスタンプアラートが確認された 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

ISO8601 のタイムスタンプアラートが作成されたときの 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

ISO8601 のタイムスタンプこのアラートの最後の通知が送信された日時の UTC 形式の日付と時刻形式。MongoDB Ops Manager が通知を送信した場合、MongoDB 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

ISO8601 のタイムスタンプこのアラートが最後にアップデートされたときの UTC の日時形式。

リクエストの例

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 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

HTTP/1.1 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   "results": [{
4       "alertConfigId": "{ALERT-CONFIG-ID}",
5       "created": "2019-11-29T20:26:30Z",
6       "eventTypeName": "BACKUP_AGENT_DOWN",
7       "groupId": "{PROJECT-ID}",
8       "id": "{ALERT-ID}",
9       "lastNotified": "2020-04-09T20:21:00Z",
10       "links": [],
11       "status": "OPEN",
12       "tags": [],
13       "typeName": "AGENT",
14       "updated": "2019-11-29T20:26:30Z"
15     },
16     {
17       "alertConfigId": "{ALERT-CONFIG-ID}",
18       "created": "2019-11-29T20:43:00Z",
19       "eventTypeName": "BACKUP_AGENT_DOWN",
20       "groupId": "{PROJECT-ID}",
21       "id": "{ALERT-ID}",
22       "lastNotified": "2020-04-09T20:21:54Z",
23       "links": [],
24       "status": "OPEN",
25       "tags": [],
26       "typeName": "AGENT",
27       "updated": "2019-11-29T20:43:00Z"
28     },
29     {
30       "alertConfigId": "{ALERT-CONFIG-ID}",
31       "created": "2019-11-30T12:27:07Z",
32       "eventTypeName": "BACKUP_AGENT_DOWN",
33       "groupId": "{PROJECT-ID}",
34       "id": "{ALERT-ID}",
35       "lastNotified": "2020-04-09T20:20:33Z",
36       "links": [],
37       "status": "OPEN",
38       "tags": [],
39       "typeName": "AGENT",
40       "updated": "2019-11-30T12:27:07Z"
41     }
42   ],
43   "totalCount": 3
44 }

戻る

グローバルアラート

1 つのグローバルアラートを取得

1	{
2	"links": [],
3	"results": [{
4	"alertConfigId": "{ALERT-CONFIG-ID}",
5	"created": "2019-11-29T20:26:30Z",
6	"eventTypeName": "BACKUP_AGENT_DOWN",
7	"groupId": "{PROJECT-ID}",
8	"id": "{ALERT-ID}",
9	"lastNotified": "2020-04-09T20:21:00Z",
10	"links": [],
11	"status": "OPEN",
12	"tags": [],
13	"typeName": "AGENT",
14	"updated": "2019-11-29T20:26:30Z"
15	},
16	{
17	"alertConfigId": "{ALERT-CONFIG-ID}",
18	"created": "2019-11-29T20:43:00Z",
19	"eventTypeName": "BACKUP_AGENT_DOWN",
20	"groupId": "{PROJECT-ID}",
21	"id": "{ALERT-ID}",
22	"lastNotified": "2020-04-09T20:21:54Z",
23	"links": [],
24	"status": "OPEN",
25	"tags": [],
26	"typeName": "AGENT",
27	"updated": "2019-11-29T20:43:00Z"
28	},
29	{
30	"alertConfigId": "{ALERT-CONFIG-ID}",
31	"created": "2019-11-30T12:27:07Z",
32	"eventTypeName": "BACKUP_AGENT_DOWN",
33	"groupId": "{PROJECT-ID}",
34	"id": "{ALERT-ID}",
35	"lastNotified": "2020-04-09T20:20:33Z",
36	"links": [],
37	"status": "OPEN",
38	"tags": [],
39	"typeName": "AGENT",
40	"updated": "2019-11-30T12:27:07Z"
41	}
42	],
43	"totalCount": 3
44	}

必須のロール

リクエスト

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

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

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

応答

応答ドキュメント

results embeddedDocument

リクエストの例

応答例

応答ヘッダー

レスポンス本体

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

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

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

`results` embeddedDocument