Docs Menu
Docs Home
/
MongoDB Ops Manager
/
API
/
リソース
/
測定値とアラート
/
グローバル アラート構成

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 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前
説明

状態

HTTPレスポンス コード

envelope

期待される応答本体

false

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

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

応答

名前
タイプ
説明

created

string

ISO8601 のタイムスタンプ アラート構成が作成されたときの UTC の日付と時刻形式。

enabled

ブール値

アラート構成が有効かどうかを指定するトグル。

eventTypeName

string

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

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

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

forAllGroups

ブール値

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

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

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

groupIds

文字列の配列

このアラート構成が適用されるグループの ID。 このフィールドは、 forAllGroupsがfalseに設定されている場合にのみ適用されます。

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.fieldNameがTYPE_NAMEに設定されている場合は、次の値を照合できます。

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

metricThreshold

オブジェクト

このアラート構成でアラートをtriggerするしきい値。 eventTypeNameがOUTSIDE_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がメール通知を送信するかどうかを切り替えます。 GROUPとUSERの通知にのみ存在します。

notifications.intervalMin

数値

このアラート構成がトリガーする未確認、未解決のアラートの連続した通知間で待機する時間（分）。

notifications.[n]
.webhookSecret

string

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

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

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

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

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

notifications.[n]
.webhookUrl

string

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

notifications.[n].typeNameをWEBHOOKに設定し、次のいずれかを実行すると、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 通知を送信するかどうかを切り替えます。 GROUPとUSERの通知にのみ存在します。

notifications.snmpAddress

string

SNMP ラップを送信するホスト名とポート。 現時点では、 MongoDB Ops Managerは標準の SNMP ポート（162）にのみ SNMP マップを送信できます。 SNMP通知にのみ存在します。

重要

MongoDB Ops Manager 6.0.0 はSNMPアラートを廃止します。 MongoDB Ops Manager 7.0.0 にはSNMPアラートは含まれません。 その他のアラート オプションの詳細については、「サードパーティ サービスの統合 」を参照してください。

注意

MongoDB Ops Managerは SNMP v2c を使用します。

notifications.typeName

string

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

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}

戻る

すべてのオープン アラートを取得

次へ

作成