プロジェクトのすべてのアラート構成を取得する
項目一覧
注意
グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/alertConfigs
リクエスト パス パラメーター
すべてのリクエスト パス パラメータは必須 です。
Parameter | タイプ | 説明 |
|---|---|---|
プロジェクトID | string | このプロジェクトの一意の識別子。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
|---|---|---|---|---|
pageNum | 数値 | 任意 | 結果のサブセクションを返す 1 から始まる整数。 | 1 |
itemsPerPage | 数値 | 任意 | 1 ページあたりに返す項目の数は最大 500 です。 | 100 |
pretty | ブール値 | 任意 | レスポンス本体を pretty-print に含めるかどうかを示すフラグ 形式。 | false |
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の APIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリで 結果のリストを返すエンドポイントの場合、 | false |
backupJobsEnabledOnly | ブール値 | 任意 | データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。 これを falseに設定し、 backupJobsEnabledフラグがfalseに設定されているデーモン構成を含めます。 | true |
リクエスト ボディ パラメータ
このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。
応答
応答ドキュメント
レスポンスJSONドキュメントには、 resultオブジェクトの配列、 linkオブジェクトの配列、および取得されたresultオブジェクトの合計数が含まれます。
名前 | タイプ | 説明 |
|---|---|---|
results | 配列 | 配列には、 results埋め込みドキュメントセクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。 |
links | 配列 | 配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様 で説明されています。 |
totalCount | 数値 | 結果セット内の項目の合計数の整数。 結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。 |
results embeddedDocument
各結果は 1 つのアラート構成です。
注意
アラート構成はさまざまです。 アラート構成には、これらの要素のサブセットのみを含めることができます。
名前 | タイプ | 説明 |
|---|---|---|
作成済み | string | ISO8601 のタイムスタンプ このアラート構成が作成されたときの UTC の日付と時刻形式。 |
enabled | ブール値 | このアラート構成が有効になっていることを示すフラグ。 |
eventTypeName | string | アラートをトリガーするイベントのタイプ。 |
グループ ID | string | このアラート構成を所有するプロジェクトの一意の識別子。 |
id | string | アラート構成の一意の識別子です。 |
Links | オブジェクトの配列 | サブリソースや関連リソースへの 1 つ以上のリンク。 URL 間の関係タイプについては、 Web リンク仕様 で説明されています。 。 |
マッチャー | オブジェクトの配列 | このアラート構成に対してオブジェクトを照合するときに適用するルール。 |
matchers .[n].fieldName | string | この構成で一致させたターゲット オブジェクト内のフィールドの名前。 |
matchers .[n].operator | string | 現在のメトリクス値を matcher.[n].valueと照合するときに適用する比較演算子。 |
matchers .[n].value | string | matchers.[n].operatorを使用して一致するかそれを超える値。 |
metricThreshold | オブジェクト | アラートをトリガーする比較の値と平均。 |
metricThreshold .metricName | string | 確認するメトリクスの名前。 alertsリソースのmetricNameフィールドと同じ値をサポートします。 |
metricThreshold .mode | string | このメトリクスの平均値。 |
metricThreshold .operator | string | 現在のメトリクス値をしきい値と照合するときに MongoDB Ops Manager が適用した比較演算子。 |
metricThreshold .threshold | 数値 | 超えた場合にアラートをトリガーする metricThreshold.metricNameの値。 |
metricThreshold .units | string | metricThreshold.thresholdの範囲を定義する容量または時間の単位。 |
notifications | オブジェクトの配列 | アラート条件が検出されたときに MongoDB Ops Manager が通知を送信する 1 つ以上のターゲット。 |
notifications.[n] .apiToken | string | Slack API トークン トークン。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .channelName | string | Slack チャンネル名。 notifications.[n].typeNameをSLACKに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .datadogApiKey | string | DataDog API キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .delayMin | 数値 | アラート条件が検出された後最初の通知を送信するまでに待機する時間（分）。 |
notifications.[n] .emailAddress | string | 通知を送信するメールアドレス。 notifications.[n].typeNameをEMAILに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .emailEnabled | ブール値 | メール通知を送信する必要があることを示すフラグ。 notifications.[n].typeNameをORG 、 GROUP 、またはUSERに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .intervalMin | 数値 | 解決されていない未確認アラートの連続した通知間で待機する時間（分）。 |
notifications.[n] .microsoftTeamsWebhookUrl | string | Microsoft Teams チャネルの受信 Webhook URL 。 Webhook 通知のアラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化された状態で表示されます。 |
notifications.[n] .mobileNumber | string | アラート通知が送信されるモバイル番号。 notifications.[n].typeNameをSMSに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .notificationToken | string | HipChat API トークン。 後でトークンが無効になった場合、MongoDB Atlas は API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .opsGenieApiKey | string | Opsgenie Alert API キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .opsGenieRegion | string | 使用するAPI URLを示すリージョン。 notifications.[n].typeNameをOPS_GENIEに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .roles | 文字列の配列 | 現在のプロジェクトまたは組織の MongoDB Ops Manager ロール。 notifications.[n].typeNameをORGまたはGROUPに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .roomName | string | HipChat ルーム名。 MongoDB Ops Manager は "notifications.typeName" : "HIP_CHATの場合にこの値を返します。 |
notifications.[n] .serviceKey | string | PagerDuty サービス キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .smsEnabled | ブール値 | テキスト通知を送信する必要があることを示すフラグ。 notifications.[n].typeNameをORG 、 GROUP 、またはUSERに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .snmpAddress | string | SNMPラップを送信するホスト名とポート。 この時点で、MongoDB Ops Manager は標準の SNMP ポート（162 ）に SNMP ラップを送信できます。 重要MongoDB Ops Manager 6.0.0 はSNMPアラートを廃止します。 MongoDB Ops Manager 7.0.0 にはSNMPアラートは含まれません。 その他のアラート オプションの詳細については、「サードパーティ サービスの統合 」を参照してください。 |
notifications.[n] .teamId | string | この通知を受け取るチームの固有の識別子。 |
notifications.[n] .teamName | string | この通知を受け取ったチームのラベル。 |
notifications.[n] .typeName | string | MongoDB Ops Manager がアラートの通知を送信する方法を意味します。 |
notifications.[n] .username | string | 通知を送信する MongoDB Ops Manager ユーザーの名前。 notifications.[n].typeNameをUSERに設定すると、MongoDB Ops Manager はこの値を返します。 |
notifications.[n] .victorOpsApiKey | string | VictorOps APIキー。 後でキーが無効になった場合、MongoDB Atlas は
API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .victorOpsRoutingKey | string | VictorOps ルーティングキー。 後でキーが無効になった場合、MongoDB Atlas は
|
notifications.[n] .webhookSecret | string | |
notifications.[n] .webhookUrl | string | |
しきい値 | オブジェクト | アラートをトリガーするしきい値。 MongoDB Ops Manager は、 eventTypeNameがOUTSIDE_METRIC_THRESHOLD以外の値である場合、この値を返します。 |
threshold .operator | string | 現在のメトリクス値をしきい値と照合するときに MongoDB Ops Manager が適用した比較演算子。 |
threshold .threshold | 数値 | 超えた場合に MongoDB Ops Manager がアラートをトリガーする値。 |
threshold .units | string | threshold.thresholdの範囲を定義する容量または時間の単位。 |
typeName | string | このフィールドは非推奨であり、無視されます。 |
Updated | string | ISO8601 のタイムスタンプ このアラート構成が最後に更新されたときの UTC の日付と時刻形式。 |
リクエストの例
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --include \ --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs"
応答例
応答ヘッダー
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
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}
レスポンス本体
{ "links" : [], "results": [ { "created" : "2013-10-30T15:28:30Z", "enabled" : true, "eventTypeName" : "RESYNC_REQUIRED", "groupId" : "{PROJECT-ID}", "id" : "5271259ee4b00ece6b4754ef", "links" : [], "matchers" : [ ], "notifications" : [ { "delayMin" : 0, "emailAddress" : "somebody@example.com", "intervalMin" : 60, "typeName" : "EMAIL" } ], "updated" : "2014-02-12T16:11:05Z" }, { "created" : "2014-03-19T16:42:07Z", "enabled" : true, "eventTypeName" : "MONITORING_AGENT_DOWN", "groupId" : "{PROJECT-ID}", "id" : "5329c8dfe4b0b07a83d67e7e", "links" : [], "matchers" : [ ], "notifications" : [ { "delayMin" : 0, "emailEnabled" : true, "intervalMin" : 5, "smsEnabled" : false, "typeName" : "GROUP" } ], "updated" : "2014-03-19T16:42:07Z" }, { "created" : "2014-04-03T20:26:50Z", "enabled" : true, "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD", "groupId" : "{PROJECT-ID}", "id" : "533dc40ae4b00835ff81eaee", "links" : [], "matchers" : [ { "field" : "hostnameAndPort", "operator" : "EQUALS", "value" : "mongo.example.com:27017" } ], "notifications" : [ { "delayMin" : 0, "intervalMin" : 5, "mobileNumber" : "2343454567", "typeName" : "SMS" } ], "metricThreshold" : { "metricName" : "ASSERT_REGULAR", "mode" : "AVERAGE", "operator" : "LESS_THAN", "threshold" : 99.0, "units" : "RAW" }, "updated" : "2014-04-03T20:26:50Z", } ], "totalCount": 3 }