Docs Menu
Docs Home
/
MongoDB Ops Manager
/ / / /

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

項目一覧

  • 必須のロール
  • リクエスト
  • リクエスト パス パラメーター
  • リクエスト クエリ パラメータ
  • リクエスト ボディ パラメータ
  • 応答
  • リクエストの例
  • 応答例
  • 応答ヘッダー
  • レスポンス本体

GLOBAL-ALERT-CONFIG-IDで識別される 1 つのグローバル アラート構成を取得します。

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

  • Global Owner

  • Global Monitoring Admin

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

GET /globalAlertConfigs/{GLOBAL-ALERT-CONFIG-ID}
名前
タイプ
必要性
説明
{GLOBAL-ALERT-CONFIG-ID}
string
必須
検索対象のグローバル アラート構成の一意の識別子。
名前
タイプ
必要性
説明
default
pretty
ブール値
任意
レスポンス本体を pretty-print に含めるかどうかを示すフラグ 形式。
false
envelope
ブール値
任意

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

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

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

名前
説明
status
HTTPレスポンス コード
content
期待される応答本体
false

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

名前
タイプ
説明
created
string
ISO8601 のタイムスタンプ アラート構成が作成されたときの UTC の日付と時刻形式。
enabled
ブール値
アラート構成が有効かどうかを指定するトグル。
eventTypeName
string

このアラート構成がアラートをトリガーするイベントのタイプ。

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

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

forAllGroups
ブール値

グローバル アラート構成をすべてのグループに適用するかどうかを指定するトグル。 また、 tags配列を使用して構成を特定のグループをターゲットにするかどうかにも影響します。

trueの場合、構成はすべてのグループに適用されます。 tags配列を使用して、アラート構成を特定のグループにターゲットにすることができます。

falseの場合、構成はgroupIds配列で指定されたグループにのみ適用されます。 groupIds配列には少なくとも 1 つのプロジェクトを指定する必要があります。 このアラート構成では、 tags配列は使用できません。

groupIds
文字列の配列
このアラート構成が適用されるグループの ID。 このフィールドは、 forAllGroupsfalseに設定されている場合にのみ適用されます。
id
string
アラート構成の一意の識別子です。
matchers
オブジェクトの配列

このグローバル アラート構成に対してオブジェクトを照合するときに適用するルール。 MongoDB Ops Managerは、 アラート条件のこれらすべてのルールに一致するエンティティのみをチェックします。

eventTypeNameがホスト、レプリカセット、またはシャーディングされたクラスターのイベントを指定している場合にのみ、 matchers配列を使用してフィルタリングできます。

matchers.fieldName
string

一致するターゲット オブジェクト内のフィールドの名前。

  • ホスト アラートは、次のフィールドをサポートします。

    • HOSTNAME

    • PORT

    • HOSTNAME_AND_PORT

    • REPLICA_SET_NAME

    • TYPE_NAME

  • レプリカセット アラートは次のフィールドをサポートします。

    • REPLICA_SET_NAME

    • SHARD_NAME

    • CLUSTER_NAME

  • シャーディングされたクラスター アラートは、次のフィールドをサポートします。

    • CLUSTER_NAME

    • SHARD_NAME

他のタイプのアラートはすべてマッチャーをサポートしていません。

matchers.operator
string

Operator to test the field's value. 可能な値は次のとおりです。

  • EQUALS

  • NOT_EQUALS

  • CONTAINS

  • NOT_CONTAINS

  • STARTS_WITH

  • ENDS_WITH

  • REGEX

matchers.value
string

指定された演算子でテストする値。

matchers.fieldNameTYPE_NAMEに設定されている場合は、次の値を照合できます。

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

metricThreshold
オブジェクト
このアラート構成でアラートをtriggerするしきい値。 eventTypeNameOUTSIDE_METRIC_THRESHOLDに設定されている場合にのみ存在します。
metricThreshold.metricName
string
確認するメトリクスの名前。 globalAlertsリソースのmetricNameフィールドと同じ値をサポートします。 可能な値のリストについては、「グローバル アラートの測定タイプ 」を参照してください。
metricThreshold.mode
string
これをAVERAGEに設定し、現在のメトリクス値を平均として計算します。
metricThreshold.operator
string

現在のメトリクス値をmetricThreshold.thresholdと照合するときに適用する演算子。 可能な値は次のとおりです。

  • GREATER_THAN

  • LESS_THAN

metricThreshold.threshold
数値
このアラート構成でアラートがトリガーされるしきい値。
metricThreshold.units
string

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

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

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

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

notifications
オブジェクトの配列
このアラート構成が記述するアラートを検出したときに MongoDB Ops Manager が送信する通知。
notifications.apiToken
string

Slack API トークンまたは Bot トークン。 SLACK通知にのみ存在します。 後でトークンが無効になった場合、 MongoDB Ops Managerはプロジェクト所有者にメールを送信し、トークンを削除します。

API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

  • UI を通じてアラートを表示または編集します。

  • APIを介してサードパーティ統合設定をクエリします。

notifications.channelName
string
Slack チャンネル名。 SLACK通知にのみ存在します。
notifications.delayMin
数値
アラート条件 が検出された後、MongoDB Ops Manager が最初の通知を送信するまでに待機する時間(分)。
notifications.emailAddress
string
通知を送信するメールアドレス。 EMAIL通知にのみ存在します。
notifications.emailEnabled
ブール値
MongoDB Ops Managerがメール通知を送信するかどうかを切り替えます。 GROUPUSERの通知にのみ存在します。
notifications.intervalMin
数値
このアラート構成がトリガーする未確認、未解決のアラートの連続した通知間で待機する時間(分)。
notifications.[n]
.webhookSecret
string

通知を受け入れ、転送する Webhook で認証するために使用される値。

notifications.[n].typeNameWEBHOOKに設定し、次のいずれかを実行すると、MongoDB Ops Manager はこの値を返します。

  • notification.[n].webhookSecret に空でないstringを設定した場合

  • 管理コンソールでデフォルトのwebhookSecretを設定します。

Webhook 通知の作成後、アラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化されます。

notifications.[n]
.webhookUrl
string

この通知をトリガーする Webhook のURL

notifications.[n].typeNameWEBHOOKに設定し、次のいずれかを実行すると、MongoDB Ops Manager はこの値を返します。

  • notification.[n].webhookURL に空でないstringを設定した場合

  • 管理コンソールページでデフォルトのwebhookUrlを設定します。

Webhook 通知の作成後、アラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化されます。

notifications.microsoftTeamsWebhookUrl
string

Microsoft Teams チャネルの受信 Webhook URL 。 MICROSOFT_TEAMS通知にのみ存在します。

Webhook 通知のアラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化された状態で表示されます。

notifications.notificationToken
string

HipChat API トークン。 HIP_CHAT通知にのみ存在します。 後でトークンが無効になった場合、 MongoDB Ops Managerはプロジェクト所有者にメールを送信し、トークンを削除します。

API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

  • UI を通じてアラートを表示または編集します。

  • APIを介してサードパーティ統合設定をクエリします。

notifications.roomName
string
HipChat ルーム名。 HIP_CHAT通知にのみ存在します。
notifications.serviceKey
string

PagerDuty 統合キー。 PAGER_DUTY通知にのみ存在します。 後でキーが無効になった場合、 MongoDB Ops Managerはプロジェクト所有者にメールを送信し、キーを削除します。

API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

  • UI を通じてアラートを表示または編集します。

  • APIを介してサードパーティ統合設定をクエリします。

notifications.smsEnabled
ブール値
MongoDB Ops Managerが SMS 通知を送信するかどうかを切り替えます。 GROUPUSERの通知にのみ存在します。
notifications.typeName
string

このアラート構成トリガーのアラート通知のタイプ。 可能な値は次のとおりです。

  • ADMIN

  • GROUP

  • USER

  • EMAIL

  • SMS ( MongoDB Ops ManagerがTwilio 統合用に構成されている場合にのみ使用できます。)

  • HIPCHAT

  • SLACK

  • PAGER_DUTY

notifications.username
string
通知を送信する MongoDB Ops Manager ユーザーの名前。 USER通知にのみ存在します。
threshold
オブジェクト

このアラート構成でアラートをtriggerするしきい値。 eventTypeNameが次のいずれかの値に設定されている場合にのみ存在します。

  • TOO_FEW_HEALTHY_MEMBERS

  • TOO_MANY_UNHEALTHY_MEMBERS

threshold.operator
string

現在のメトリクス値をthreshold.thresholdと照合するときに適用する演算子。 可能な値は次のとおりです。

  • GREATER_THAN

  • LESS_THAN

threshold.threshold
数値
このアラート構成でアラートがトリガーされるしきい値。
tags
文字列の配列
このアラート構成に関連付けられているタグ。
typeName
string
このフィールドは非推奨であり、無視されます。
updated
string
ISO8601 のタイムスタンプ このアラート構成が最後に更新されたときの UTC の日付と時刻形式。
1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --include \
4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlertConfigs/{GLOBAL-ALERT-CONFIG-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 "created": "2019-10-02T12:34:04Z",
3 "enabled": true,
4 "eventTypeName": "BACKUP_AGENT_DOWN",
5 "forAllGroups": true,
6 "groupIds": [],
7 "id": "{GLOBAL-ALERT-CONFIG-ID}",
8 "links": [
9 ],
10 "matchers": [],
11 "notifications": [
12 {
13 "delayMin": 0,
14 "intervalMin": 60,
15 "typeName": "ADMIN"
16 }
17 ],
18 "tags": [],
19 "typeName": "AGENT",
20 "updated": "2019-10-02T12:34:04Z"
21}

戻る

1 つのグローバル アラート構成によってトリガーされるすべてのオープン アラートを取得する