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

アラート構成の更新

注意

グループとプロジェクトは同義期間です。あなたの {PROJECT-ID} はグループ ID と同じです。既存のグループの場合、グループ/プロジェクトID は同じままです。このページでは、説明を参照するときに、より一般的な期間のグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。

ベース URL: https://cloud.mongodb.com/api/public/v1.0

PUT /groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}

注意

アラート構成の有効/無効状態のみを更新するには、代わりに「 アラート構成の有効化と無効化 」を参照してください。

すべてのリクエスト パス パラメータは必須 です。

Parameter
タイプ
説明

プロジェクトID

string

このプロジェクトの一意の識別子。

ALERT-CONFIG-ID

string

このアラート構成の一意の識別子。

次のクエリ パラメータは 任意です。

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

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

false

envelope

ブール値

任意

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

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

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

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

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

false

注意

アラート構成はさまざまです。 アラート構成には、これらの要素のサブセットのみを含めることができます。

名前
タイプ
説明

enabled

ブール値

省略した場合、構成は無効になります。

eventTypeName
必須

string

アラートをトリガーするイベントの種類。

値には、次のものが含まれます。

エージェント

アラート

オートメーション構成

バックアップ

BI Connector

請求

クラスター

Data Explorer のアクセス

ディスクバックアップ

Host

組織

プロジェクト

レプリカセット

サポートケース

チーム

user

アラートとその説明を生成するイベントの完全なリストを確認するには、「アラート タイプ 」を参照してください。

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

フィールドの値をテストする演算子。 指定できる値は以下のとおりです。

  • EQUALS

  • NOT_EQUALS

  • CONTAINS

  • NOT_CONTAINS

  • STARTS_WITH

  • ENDS_WITH

  • REGEX

matchers.value

string

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

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

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

マッチャー

オブジェクト配列

このアラート構成に対してオブジェクトを照合するときに適用するルール。 これらのすべてのルールに一致するエンティティのみがアラート条件についてチェックされます。

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

metricThreshold.metricName

string

確認するメトリクスの名前。 alertsリソースのmetricNameフィールドと同じ値をサポートします。

metricThreshold.mode

string

このメトリクスの平均を計算するには、 AVERAGEに設定します。

metricThreshold.operator

string

現在のメトリクス値をしきい値と照合するときに適用する演算子。 指定できる値は以下のとおりです。

  • GREATER_THAN

  • LESS_THAN

metricThreshold.threshold

数値

アラートがトリガーされる範囲外のしきい値。

metricThreshold.units

string

しきい値の単位。 メトリクスの型によって異なります。

たとえば、メモリ消費を測定するメトリクスにはバイト単位が含まれ、時間を測定するメトリクスには時間単位が含まれます。

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

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

metricThreshold

オブジェクト

アラートがトリガーされるしきい値。 "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD"の場合は必須です。

authentication.apiToken

string

Slack API トークンまたは Bot トークン。 "notifications.typeName" : "SLACK"の場合は必須です。 後でトークンが無効になった場合、Cloud Manager は プロジェクト所有者 にメールを送信し、最終的にトークンを削除します。

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

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

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

refresh.channelName

string

Slack チャンネル名。 "notifications.typeName" : "SLACK"の場合は必須です。

authentication.datadogApiKey

string

DataDog API キー。 DataDog ダッシュボードで確認できます。 "notifications.typeName" : "DATADOG"の場合は必須です。

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

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

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

authentication.deployMin

数値

アラート条件が検出された後最初の通知を送信するまでに待機する時間(分)。

authentication.emailAddress

string

通知を送信するメールアドレス。 "notifications.typeName" : "EMAIL"の場合は必須です。

authentication.emailEnabled

ブール値

メール通知を送信するかどうかを決定します。 次の場合は必須です。

  • "notifications.typeName" : "GROUP"

  • "notifications.typeName" : "USER"

refresh.IntervalMin

数値

解決されていない未確認アラートの連続した通知間で待機する時間(分)。

refresh.webhookSecret

string

通知を受け入れ、転送する Webhook で認証するために使用される値。 シークレットを明示的に宣言できるのは、次の両方を持つリクエストでのみです。

  • A notifications.typeName WEBHOOK

  • 明示的に宣言された notifications.webhookURL

統合ページまたは統合 APIを使用してのみ、デフォルトのwebhookURLにwebhookSecretを構成できます。

webhookSecret webhookURLを明示的に宣言するには、このフィールドを省略します。

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

refresh.webhookUrl

string

この通知をトリガーする Webhook のURL 。webhookUrl を明示的に宣言しない場合、リクエストはデフォルトの webhookUrl を使用します。これは、Integrations ページか、Integrations API のいずれかで設定されます。

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

authentication.webhook bodyTemplate

string

Webhook 通知のボディコンテンツをレンダーする、"${field}" 補間を使用したテンプレート。Cloud Manager は、通知を送信するときに、${eventType} などの各 ${field} プレースホルダーを一致するアラート値に置き換えます。レンダリングされたボディは有効な JSON でなければなりません。また、Content-Type: application/json ヘッダーとともに送信されます。

テンプレートのレンダーに失敗したり、サイズ制限を超えたり、無効な出力が生成された場合、 Cloud Manager は代わりにデフォルトのペイロードを送信します。

authentication.webhookheadersTemplate

string

Webhook 通知に含めるカスタムヘッダーを、${field} の差し込みを使用してレンダーするテンプレート。Cloud Manager は、通知を送信するときに、各 ${field} プレースホルダを対応するアラート値に置き換えます。レンダリングされたヘッダーは、各ヘッダー名をその値にマップする JSON オブジェクトである必要があります。Cloud Manager は、テンプレートにウェブフックシークレットまたは署名ヘッダーを公開しません。

テンプレートのレンダーが失敗した場合、サイズ制限を超えた場合、または無効な出力を生成した場合、Cloud Manager はデフォルトヘッダーを送信します。

authentication.MicrosoftTeamsWebhookUrl

string

Microsoft Teams チャネルの受信 Webhook URL 。 "notifications.typeName" : "MICROSOFT_TEAMS"の場合は必須です。

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

refresh. mobileNumber

string

SMS メッセージの送信先の携帯電話番号。 "notifications.typeName" : "SMS"の場合は必須です。

transformation.notificationToken

string

HipChat API トークン。 "notifications.typeName" : "HIP_CHAT"の場合は必須です。 後でトークンが無効になった場合、Cloud Manager は プロジェクト所有者 にメールを送信し、最終的にトークンを削除します。

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

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

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

refresh.role

string

構成されたアラートを受信する 1 つ以上のプロジェクト ロール。 受け入れ可能な値は以下の通りです。

このフィールドを含めると、Cloud Manager は、配列で指定されたロールを割り当てられたユーザーにのみアラートを送信します。 このフィールドを省略すると、Cloud Manager はロールを割り当てられたユーザーにアラートを送信します。

GROUPの通知タイプで構成可能です。

refresh.roomName

string

HipChat ルーム名。 "notifications.typeName" : "HIP_CHAT"の場合は必須です。

authentication.serviceKey

string

PagerDuty 統合キー。 "notifications.typeName" : "PAGER_DUTY"の場合は必須です。

authentication.smsEnabled

ブール値

SMS 通知を送信する必要があることを示すフラグ。 次の場合は必須です。

  • "notifications.typeName" : "GROUP"

  • "notifications.typeName" : "USER"

refresh. teamId

string

チームの一意の識別子。

refresh.typeName

string

アラート通知のタイプ。 指定できる値は以下のとおりです。

  • EMAIL

  • GROUP (プロジェクト)

  • HIPCHAT

  • ORG

  • PAGER_DUTY

  • SLACK

  • SMS

  • TEAM

  • USER

  • WEBHOOK

  • MICROSOFT_TEAMS

refresh.username

string

通知を送信する Cloud Manager ユーザーの名前。 アラート構成を所有するプロジェクト内のユーザーを指定します。 "notifications.typeName" : "USER"の場合は必須です。

通知
Required

オブジェクト配列

アラート条件が検出されたときに送信する通知。

しきい値. 演算子

string

現在のメトリクス値をしきい値と照合するときに適用する演算子。

  • GREATER_THAN

  • LESS_THAN

mapping.threshold

数値

アラートがトリガーされる範囲外のしきい値。

しきい値

オブジェクト

アラートがトリガーされるしきい値。 次の場合は必須です。

  • "eventTypeName" : "TOO_FEW_HEALTHY_MEMBERS"

  • "eventTypeName" : TOO_MANY_UNHEALTHY_MEMBERS

応答にはアラート構成の詳細が含まれます。

注意

アラート構成はさまざまです。 アラート構成には、これらの要素のサブセットのみを含めることができます。

名前
タイプ
説明

作成済み

string

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

enabled

ブール値

このアラート構成が有効になっていることを示すフラグ。

eventTypeName

string

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

グループ ID

string

このアラート構成を所有するプロジェクトの一意の識別子。

id

string

アラート構成の一意の識別子です。

Links

オブジェクトの配列

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

マッチャー

オブジェクトの配列

このアラート構成に対してオブジェクトを照合するときに適用するルール。

matchers
.[n].fieldName

string

この構成で一致させたターゲット オブジェクト内のフィールドの名前。

matchers
.[n].演算子

string

現在のメトリクス値をmatcher.[n].valueと照合するときに適用する比較演算子。

matchers
.[n].value

string

matchers.[n].operatorを使用して一致するかそれを超える値。

metricThreshold

オブジェクト

アラートをトリガーする比較の値と平均。

metricThreshold
.metricName

string

確認するメトリクスの名前。 alertsリソースのmetricNameフィールドと同じ値をサポートします。

metricThreshold
モード

string

このメトリクスの平均値。

metricThreshold
.演算子

string

現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。

metricThreshold
.threshold

数値

超えた場合にアラートをトリガーするmetricThreshold.metricNameの値。

metricThreshold
.units

string

metricThreshold.thresholdの範囲を定義する容量または時間の単位。

notifications

オブジェクトの配列

アラート条件が検出されたときに Cloud Manager が通知を送信する 1 つ以上のターゲット。

通知.[n]
.apiToken

string

Slack API トークン トークン。 notifications.[n].typeNameをSLACKに設定すると、Cloud Manager がこの値を返します。

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

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

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

通知.[n]
.channelName

string

Slack チャンネル名。 notifications.[n].typeNameをSLACKに設定すると、Cloud Manager がこの値を返します。

通知.[n]
.datadogApiKey

string

DataDog API キー。 notifications.[n].typeNameをDATADOGに設定すると、Cloud Manager がこの値を返します。

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

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

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

通知.[n]
.delayMin

数値

アラート条件が検出された後最初の通知を送信するまでに待機する時間(分)。

通知.[n]
.emailAddress

string

通知を送信するメールアドレス。 notifications.[n].typeNameをEMAILに設定すると、Cloud Manager がこの値を返します。

通知.[n]
.emailEnabled

ブール値

メール通知を送信する必要があることを示すフラグ。 notifications.[n].typeNameをORG 、 GROUP 、またはUSERに設定すると、Cloud Manager はこの値を返します。

通知.[n]
.intervalMin

数値

解決されていない未確認アラートの連続した通知間で待機する時間(分)。

通知.[n]
.microsoftTeamsWebhookUrl

string

Microsoft Teams チャネルの受信 Webhook URL 。 notifications.[n].typeNameをMICROSOFT_TEAMSに設定すると、Cloud Manager がこの値を返します。

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

通知.[n]
.mobileNumber

string

アラート通知が送信されるモバイル番号。 notifications.[n].typeNameをSMSに設定すると、Cloud Manager がこの値を返します。

通知.[n]
.notificationToken

string

HipChat API トークン。 notifications.[n].typeNameをHIP_CHATに設定すると、Cloud Manager がこの値を返します。

後でトークンが無効になった場合、MongoDB Atlas はProject Ownerにメールを送信し、最終的にトークンを削除します。

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

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

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

通知.[n]
.opsGenieApiKey

string

OpsGenie Alert APIキー。notifications.[n].typeNameを OPS_GENIE に設定すると、 Cloud Manager はこの値を返します。

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

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

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

通知.[n]
.opsGenieRegion

string

どの API URL を使用するかを示するリージョンCloud Manager は、notifications.[n].typeName を OPS_GENIE に設定した場合、この値を返します。

通知.[n]
.ロール

文字列の配列

現在のプロジェクトまたは組織の Cloud Manager ロール。 notifications.[n].typeNameをORGまたはGROUPに設定すると、Cloud Manager はこの値を返します。

通知.[n]
.roomName

string

HipChat ルーム名。 Cloud Manager は、 "notifications.typeName" : "HIP_CHATの場合にこの値を返します。

通知.[n]
.serviceKey

string

PagerDuty サービス キー。 notifications.[n].typeNameをPAGER_DUTYに設定すると、Cloud Manager がこの値を返します。

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

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

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

通知.[n]
.smsEnabled

ブール値

テキスト通知を送信する必要があることを示すフラグ。 notifications.[n].typeNameをORG 、 GROUP 、またはUSERに設定すると、Cloud Manager はこの値を返します。

通知.[n]
.teamId

string

この通知を受け取るチームの固有の識別子。

通知.[n]
.teamName

string

この通知を受け取ったチームのラベル。

通知.[n]
.typeName

string

Cloud Manager がアラートの通知を送信する方法を意味します。

通知.[n]
.ユーザー名

string

通知を送信する Cloud Manager ユーザーの名前。 notifications.[n].typeNameをUSERに設定すると、Cloud Manager がこの値を返します。

通知.[n]
.victorOpsApiKey

string

VictorOps APIキー。

後でキーが無効になった場合、MongoDB Atlas はProject Ownerにメールを送信し、最終的にキーを削除します。

notifications.[n].typeNameをVICTOR_OPSに設定すると、Cloud Manager がこの値を返します。

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

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

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

通知.[n]
.victorOpsRoutingKey

string

VictorOps ルーティングキー。

後でキーが無効になった場合、MongoDB Atlas はProject Ownerにメールを送信し、最終的にキーを削除します。

notifications.[n].typeNameをVICTOR_OPSに設定すると、Cloud Manager がこの値を返します。

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

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

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

通知.[n]
.webhookBodyTemplate

string

${field} 補間を使用して、webhook 通知の本文コンテンツをレンダーするテンプレート。notifications.[n].typeName を WEBHOOK に設定し、notifications.[n].webhookBodyTemplate を空でない string に設定すると、Cloud Manager はこの値を返します。Cloud Manager は、応答のテンプレート値を抽出します。

通知.[n]
.webhookHeadersTemplate

string

${field} 補間を使用して、webhook 通知に含めるカスタムヘッダーをレンダーするテンプレート。notifications.[n].typeName を WEBHOOK に設定し、notifications.[n].webhookHeadersTemplate を空でない string に設定すると、Cloud Manager はこの値を返します。Cloud Manager は、応答のテンプレート値を抽出します。

通知.[n]
.webhookSecret

string

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

notifications.[n].typeNameをWEBHOOKに設定し、次のいずれかの場合に、Cloud Manager にこの値が返されます。

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

  • 統合ページで、または統合 APIを使用してデフォルトのwebhookSecretを設定します

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

通知.[n]
.webhookUrl

string

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

notifications.[n].typeNameをWEBHOOKに設定し、次のいずれかの場合に、Cloud Manager にこの値が返されます。

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

  • 統合ページで、または統合 APIを使用してデフォルトのwebhookUrlを設定します

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

しきい値

オブジェクト

アラートをトリガーするしきい値。 Cloud Manager は、 eventTypeNameがOUTSIDE_METRIC_THRESHOLD以外の値である場合、この値を返します。

スレッショルド
演算子

string

現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。

スレッショル
.スレッショル

数値

超えた場合に Cloud Manager がアラートをトリガーする値。

スレッショルド
.単位

string

threshold.thresholdの範囲を定義する容量または時間の単位。

typeName

string

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

Updated

string

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

curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --include \ --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}" \ --data ' { "eventTypeName" : "RESYNC_REQUIRED", "enabled" : true, "matchers" : [ { "fieldName" : "REPLICA_SET_NAME", "operator" : "EQUALS", "value" : "rs1" } ], "notifications" : [ { "typeName" : "EMAIL", "emailAddress" : "sos@example.com", "intervalMin" : 60, "delayMin" : 5 }, { "typeName" : "GROUP", "intervalMin" : 120, "delayMin" : 60, "smsEnabled" : true, "emailEnabled" : false } ] }'
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}
{ "created" : "2014-04-23T14:52:29Z", "enabled" : false, "groupId" : "{PROJECT-ID}", "id" : "{ALERT-CONFIG-ID}", "links" : [], "matchers" : [ { "fieldName" : "REPLICA_SET_NAME", "operator" : "EQUALS", "value" : "rs1" } ], "notifications" : [ { "delayMin" : 5, "emailAddress" : "sos@example.com", "intervalMin" : 60, "typeName" : "EMAIL" }, { "delayMin" : 60, "emailEnabled" : false, "intervalMin" : 120, "smsEnabled" : true, "typeName" : "GROUP" } ], "updated" : "2014-04-23T14:56:25Z"}