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

1 つのプロジェクト イベントを取得する

必須のロール

このリソースを正常に呼び出すには、API キーにProject Read Onlyロールが必要です。

リクエスト

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

GET /groups/{groupId}/events/{eventId}

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

名前
タイプ
説明

グループ ID

string

目的のイベントに関連付けられたプロジェクトの一意の識別子。

eventId

string

目的のイベントの一意の識別子。

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

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

クエリ パラメータ
タイプ
説明
default

pretty

ブール値

応答を pretty-print形式で表示します。

false

envelope

ブール値

false

includeRaw

ブール値

出力にrawドキュメントを含めるかどうかを指定します。 rawドキュメントには、イベントに関する追加のメタ情報が含まれています。

重要: rawドキュメントの値は、イベントが適用されるリソースによって異なります。このフィールドは注意が必要です。その構造はリソースの種類によって異なる可能性があるためです。

false

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

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

応答

名前
タイプ
説明

alertId

string

このイベントに関連付けられたアラートの一意の識別子。

alertConfigId

string

alertIdに関連付けられたアラート構成の一意の識別子。

apiKeyId

string

このイベントをトリガーしたAPI キーの一意の識別子。

このフィールドが応答に存在する場合、MongoDB Ops Manager はuserIdフィールドを返しません。

clusterId

string

このイベントが適用されるクラスターの一意の識別子。

clusterName

string

このイベントが適用されるクラスターの名前。

コレクション

string

イベントが発生したコレクションの名前。 このフィールドは、 eventTypeNameがDATA_EXPLORERまたはDATA_EXPLORER_CRUDのいずれかの場合に表示される可能性があります。

作成済み

string

このイベントがトリガーされたときの ISO の日付と時刻形式（UTC）のタイムスタンプ。8601

currentValue

オブジェクト

このイベントをトリガーしたメトリクスの現在の値。

currentValue
.number

数値

メトリクスの値。

currentValue
.units

string

値に関連する単位。

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

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

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

database

string

イベントが発生したデータベースの名前。 このフィールドは、 eventTypeNameがDATA_EXPLORERまたはDATA_EXPLORER_CRUDのいずれかの場合に表示される可能性があります。

distinct

オブジェクトの配列

このイベント中に配置に変更が加えられました。

MongoDB Ops Managerは、変更された内容に応じて異なる要素を返します。特権やロール、復元ジョブ、オートメーションモジュールなど。 この配列とそのオブジェクトのリストはすべて網羅されていません。

diffs
.id

string

このイベントで実行された差分の一意の識別子。

diffs
.params

オブジェクトの配列

指定されたリソースに対して行われた変更のコレクション。

diffs
.params
display

string

変更が行われたときにアクティビティ フィードのコンソールに表示されるラベル。

diffs
.params
:new

string

変更されたパラメーターの新しい状態。

diffs
.params
.old

string

変更されたパラメーターの初期状態。

diffs
.params
.param

string

変更されたパラメーターの名前。

diffs
.status

string

このリソースに加えられた変更の内容。

  • NEW

  • MODIFIED

  • REMOVED

  • SHUTDOWN

  • STARTUP

  • RESTORE

  • RESTART

diffs
.type

string

変更が行われたリソース。

  • AUTH

  • AUTOMATION_AGENT

  • BACKUP_AGENT

  • BI_CONNECTOR

  • MONITORING_AGENT

  • PROCESS

  • REPLICA_SET

  • ROLES

  • USERS

eventTypeName

string

このイベントをトリガーした状況の名前。

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

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

グループ ID

string

このイベントが発生したプロジェクトの一意の識別子。

hostId

string

このイベントが発生したホストの一意の識別子。

Hostname

string

このイベントが発生したホストのホスト名、FQDN、IPv 4アドレス、または IPv6 アドレス。

id

string

このイベントの一意の識別子。

is GlobalAdmin

ブール値

このイベントをトリガーしたユーザーがGlobal Monitoring Administratorロールを持っているかどうかを示すフラグ。

Links

オブジェクト配列

サブリソースまたは関連リソースへの 1 つ以上のリンク。応答内のすべての links 配列には、self と呼ばれるリンクが少なくとも 1 つ含まれています。URLの関係は、Web リンク仕様で説明されています。

metricName

string

値がしきい値を超えた測定値の名前。

opType

string

イベントを生成した操作のタイプ。 このフィールドは、 eventTypeNameがDATA_EXPLORERまたはDATA_EXPLORER_CRUDのいずれかである場合に表示されます。

ポート

integer

このイベントに関連付けられているホストのポート。

publicKey

string

このイベントをトリガーしたAPIキーに関連付けられた公開キー。

このフィールドが応答に存在する場合、MongoDB Ops Manager はusernameフィールドを返しません。

生

ドキュメント

イベントに関する追加のメタ情報。 このフィールドは、 includeRawクエリ パラメータがtrueの場合にのみ表示されます。

重要: rawドキュメントの値は、イベントが適用されるリソースによって異なります。このフィールドは注意が必要です。その構造はリソースの種類によって異なる可能性があるためです。

remoteAddress

string

イベントをトリガーした MongoDB Ops Manager ユーザー（userId） に関連付けられた IP アドレス。

ReplicaSetName

string

レプリカセットの名前。

shardName

string

イベントに関連付けられたシャードの名前。

targetPublicKey

string

イベントの対象となるAPI キーの公開キー。

targetUsername

string

このイベントの対象となる MongoDB Ops Manager ユーザーのユーザー名。

teamId

string

このイベントに関連付けられた MongoDB Ops Manager チームの一意の識別子。

userId

string

このイベントをトリガーした MongoDB Ops Manager ユーザーの一意の識別子。

このフィールドが応答に存在する場合、MongoDB Ops Manager はapiKeyIdフィールドを返しません。

username

string

このイベントをトリガーした MongoDB Ops Manager ユーザーのユーザー名。

このフィールドが応答に存在する場合、MongoDB Ops Manager はpublicKeyフィールドを返しません。

accessListEntry

string

イベントの対象となる API キーのアクセス リスト エントリ。

リクエストの例

curl --user "{publicKey}:{privateKey}" --digest \     --header "Accept: application/json" \     --include \     --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{groupId}/events/{eventId}?pretty=true"

応答例

応答ヘッダー

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" : "2020-07-13T21:28:37Z",  "diffs" : [ {    "id" : "admin@admin",    "name" : null,    "params" : [ {      "display" : "Added Privilege",      "new" : "config.system.sessions: moveChunk",      "old" : null,      "param" : "config.system.sessions: moveChunk"    }, {      "display" : "Added Privilege",      "new" : "config.system.sessions: splitChunk",      "old" : null,      "param" : "config.system.sessions: splitChunk"    }, {      "display" : "Added Privilege",      "new" : "config.system.sessions: splitVector",      "old" : null,      "param" : "config.system.sessions: splitVector"    } ],    "priviileges" : [ {      "actions" : [ "moveChunk" ],      "resource" : {        "collection" : "system.sessions",        "db" : "config"      }    }, {      "actions" : [ "moveChunk" ],      "resource" : {        "collection" : "",        "db" : ""      }    }, {      "actions" : [ "enableSharding" ],      "resource" : {        "cluster" : true      }    }, {      "actions" : [ "cleanupOrphaned" ],      "resource" : {        "cluster" : true      }    }, {      "actions" : [ "flushRouterConfig" ],      "resource" : {        "cluster" : true      }    }, {      "actions" : [ "splitChunk" ],      "resource" : {        "collection" : "system.sessions",        "db" : "config"      }    }, {      "actions" : [ "splitChunk" ],      "resource" : {        "collection" : "",        "db" : ""      }    }, {      "actions" : [ "splitVector" ],      "resource" : {        "collection" : "system.sessions",        "db" : "config"      }    }, {      "actions" : [ "viewRole" ],      "resource" : {        "collection" : "",        "db" : ""      }    } ],    "roles" : [ {      "db" : "admin",      "role" : "readWriteAnyDatabase"    }, {      "db" : "admin",      "role" : "dbAdminAnyDatabase"    }, {      "db" : "admin",      "role" : "enableSharding"    }, {      "db" : "admin",      "role" : "backup"    }, {      "db" : "admin",      "role" : "clusterMonitor"    } ],    "status" : "MODIFIED",    "type" : "ROLES"  }}
戻る
すべて取得（プロジェクト）
次へ
グローバル アラート
このページを評価

項目一覧