AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu
Docs Home
/ /
グローバル アラート
Docs Home
/ /
測定値とアラート
/
グローバル アラート
Docs Home
/
管理
/
Ops Manager
/
API
/
リソース
/
測定値とアラート
/
グローバル アラート

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

ALERT-ID でアラートを 1 つ取得します。

必須のロール

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

リクエスト

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

GET /globalAlerts/{ALERT-ID}

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

名前
タイプ
説明

ALERT-ID

string

検索するアラートの一意の識別子。

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

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

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

false

envelope

ブール値

任意

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

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

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

  • status: HTTPレスポンス コード

  • content: 期待される応答本体

false

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

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

応答

名前
タイプ
説明

acknowledgedUntil

string

Timestamp in ISO 8601 date and time format in UTC through which the alert has been acknowledged. Ops Manager presents this field if a user acknowledged this alert.

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

Timestamp in ISO 8601 date and time format in UTC when the last notification was sent for this alert. Ops Manager displays this if Ops Manager sent notifications.

metricName

string

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

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

replicaSetName

string

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

resolved

string

アラートが閉じられたときの ISO 8601の日付と時刻形式（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 8601の日付と時刻形式（UTC）のタイムスタンプ。

リクエストの例

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

応答例

応答ヘッダー

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    "alertConfigId": "{ALERT-CONFIG-ID}",
3    "created": "2019-11-30T12:42:31Z",
4    "eventTypeName": "BACKUP_AGENT_DOWN",
5    "groupId": "{PROJECT-ID}",
6    "id": "{ALERT-ID}",
7    "lastNotified": "2020-04-09T20:25:05Z",
8    "links": [
9   ],
10   "status": "OPEN",
11   "tags": [],
12   "typeName": "AGENT",
13   "updated": "2019-11-30T12:42:31Z"
14}
戻る
すべて取得
次へ
確認応答 1
このページを評価

項目一覧