機能説明
指定されたOB Cloudデータベースインスタンスで、指定された期間に発生した異常イベント情報を照会します。異常イベントには、パフォーマンス異常、リソースアラート、サービス状態の変更などが含まれる可能性があり、インスタンスの健全性を監視するのに役立ちます。
呼び出し説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法の詳細については、アクセスキーの管理をご参照ください。
リクエストパス
GET /api/v2/instances/{instanceId}/anomalyEvents
リクエストパラメータ
名前 |
型 |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| instanceId | string | はい | OB CloudデータベースインスタンスID。 | obcluster-***** |
| requestId | string | はい | 追跡用のリクエストID。 | dc302d76-66b5-48d8-ab53-a035******** |
| startTime | string | はい | 照会対象の異常イベントの開始時間(UTC時刻形式)。 | 2026-02-25 15:40:43+00:00 |
| endTime | string | はい | 照会対象の異常イベントの終了時間(UTC時刻形式)。 | 2026-02-26 10:40:43+00:00 |
| pageNumber | integer | いいえ | ページ番号。 | 1 |
| pageSize | integer | いいえ | ページサイズ。 | 10 |
| httpServletRequest | unknown | はい | Http servlet requestパラメータ。 | - |
実行結果
パラメータ名 |
型 |
説明 |
|---|---|---|
| data | object | 戻されるデータオブジェクト。 |
| data.total | integer | 異常イベントの総件数。 |
| data.list | array | 異常イベントリスト。 |
| data.list[].eventId | string | 異常イベントID。 |
| data.list[].eventType | string | 異常イベントタイプ。 |
| data.list[].eventLevel | string | 異常イベントレベル。 |
| data.list[].eventTime | string | 異常イベント発生時間。 |
| data.list[].eventDescription | string | 異常イベントの説明。 |
| data.list[].instanceId | string | 異常が発生したOB CloudデータベースインスタンスID。 |
| data.list[].instanceName | string | 例外が発生したOB Cloudデータベースインスタンス名。 |
| data.list[].region | string | インスタンスのリージョン。 |
| data.list[].suggestedAction | string | 推奨される操作。 |
| data.list[].status | string | イベント処理状態。 |
| message | string | リクエストに返されたメッセージ。 |
| requestId | string | リクエストID。 |
| server | string | リクエストを処理したサーバーアドレス。 |
| success | boolean | リクエストが成功したかどうか。 |
例
リクエスト例
curl -X GET \
'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/anomalyEvents?requestId={requestId}&startTime={startTime}&endTime={endTime}&pageNumber={pageNumber}&pageSize={pageSize}' \
-H 'Content-Type: application/json' \
-u '<Your AK:SK>'
レスポンス例
{
"data": {
"total": 2,
"list": [
{
"eventId": "xxxxxx",
"eventType": "CPU_USAGE_HIGH",
"eventLevel": "WARNING",
"eventTime": "2026-02-25 16:00:00+00:00",
"eventDescription": "OB CloudデータベースインスタンスのCPU使用率が80%を超え、5分間継続しています。",
"instanceId": "obcluster-*****",
"instanceName": "my-instance-01",
"region": "cn-hangzhou",
"suggestedAction": "業務負荷を確認するか、インスタンスの仕様アップグレードを検討することを推奨します。",
"status": "UNRESOLVED"
},
{
"eventId": "xxxxxx",
"eventType": "MEMORY_USAGE_HIGH",
"eventLevel": "CRITICAL",
"eventTime": "2026-02-26 09:30:00+00:00",
"eventDescription": "OB Cloudデータベースインスタンスのメモリ使用率が90%を超え、3分間継続しています。",
"instanceId": "obcluster-*****",
"instanceName": "my-instance-01",
"region": "cn-hangzhou",
"suggestedAction": "直ちにメモリ使用状況を確認し、クエリの最適化またはスケールアウトを行うことを推奨します。",
"status": "IN_PROGRESS"
}
]
},
"message": "Success",
"requestId": "xxxxxx",
"server": "xxx.xxx.x.xxx:xxxx",
"success": true
}