基本数据库服务的事件类型

基本数据库服务资源发出事件,这些事件是指示资源更改的结构化消息。

有关 Oracle Cloud Infrastructure Events 的更多信息,请参阅事件概述。您可以订阅事件,在使用 Oracle Notification 服务时会收到通知,请参阅通知概览。

先决条件

要接收数据库和数据库系统的事件,必须满足以下先决条件。

数据库事件的类型

以下是数据库系统中的数据库发出的事件类型:

友好名称 事件类型
数据库 - 自动备份开始 com.oraclecloud.databaseservice.automaticbackupdatabase.begin
数据库 - 自动备份结束 com.oraclecloud.databaseservice.automaticbackupdatabase.end
数据库 - 创建备份开始 com.oraclecloud.databaseservice.backupdatabase.begin
数据库 - 创建备份结束 com.oraclecloud.databaseservice.backupdatabase.end
数据库 - 关键 com.oraclecloud.databaseservice.database.critical
数据库 - 删除备份开始 com.oraclecloud.databaseservice.deletebackup.begin
数据库 - 删除备份结束 com.oraclecloud.databaseservice.deletebackup.end
数据库 - 信息 com.oraclecloud.databaseservice.database.information
数据库 - 迁移至 KMS 密钥开始 com.oraclecloud.databaseservice.migratedatabasekmskey.begin
数据库 - 迁移到 KMS 密钥结束 com.oraclecloud.databaseservice.migratedatabasekmskey.end
数据库 - 移动开始 com.oraclecloud.databaseservice.movedatabase.begin
数据库 - 移动结束 com.oraclecloud.databaseservice.movedatabase.end
数据库 - 恢复开始 com.oraclecloud.databaseservice.restoredatabase.begin
数据库 - 恢复结束 com.oraclecloud.databaseservice.restoredatabase.end
数据库 - 轮换 KMS 密钥开始 com.oraclecloud.databaseservice.rotatedatabasekmskey.begin
数据库 - 轮换 KMS 密钥结束 com.oraclecloud.databaseservice.rotatedatabasekmskey.end
数据库 - 终止开始 com.oraclecloud.databaseservice.database.terminate.begin
数据库 - 终止终止日期 com.oraclecloud.databaseservice.database.terminate.end
数据库 - 更新开始 com.oraclecloud.databaseservice.updatedatabase.begin
数据库 - 更新结束 com.oraclecloud.databaseservice.updatedatabase.end
数据库 - 升级开始 com.oraclecloud.databaseservice.upgradedatabase.begin
数据库 - 升级结束 com.oraclecloud.databaseservice.upgradedatabase.end

示例 - 数据库示例事件

这是数据库的参考事件。

{
    "eventType" : "com.oraclecloud.databaseservice.backupdatabase.begin",
    "cloudEventsVersion" : "0.1",
    "eventTypeVersion" : "2.0",
    "source" : "DatabaseService",
    "eventTime" : "2020-01-08T17:31:43.666Z",
    "contentType" : "application/json",
    "data" : {
        "compartmentId" : "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "example_compartment_name",
        "resourceName": "my_backup",
        "resourceId": "ocid1.dbbckup.oc1.<unique_ID>",
        "availabilityDomain": "<availability_domain>",
        "additionalDetails" : {
            "timeCreated" : "2020-01-08T17:31:44Z",
            "lifecycleState" : "CREATING",
            "dbSystemId" : "ocid1.dbsystem.oc1.<unique_ID>",
            "dbHomeId" : ocid1.dbhome.oc1.<unique_ID>",
            "dbUniqueName" : DB1115_iad1dv",
            "dbVersion" : "11.2.0.4.190716",
            "databaseEdition" : "ENTERPRISE_EDITION_HIGH_PERFORMANCE",
            "autoBackupsEnabled" : "false",
            "backupType" : "FULL",
            "databaseId" : "ocid1.database.oc1.<unique_ID>",
        },
        "definedTags" : {
            "My_example_tag_name" :
                { "Example_key" : "Example_value" }
        },
    },
    "eventID": "<unique_ID>",
    "extensions" : {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    }
}

数据库信息事件详细信息

com.oraclecloud.databaseservice.database.information 事件在数据库信息事件有效负载的 additionalDetails 部分中提供有关多种类型信息的详细信息。

下表列出了数据库信息事件的子类型。

EventName (in additionalDetails) 说明
AVAILABILITY.DB_GUEST.CDB_INSTANCE.DOWN_CLEARED 在确定 CDB 关闭事件已清除后,将创建类型为 INFORMATION 的事件。
HEALTH.DB_CLUSTER.CDB.BACKUP_FAILURE_CLEARED 在确定备份失败的事件已清除后,将创建类型为 INFORMATION 的事件。

数据库严重事件详细信息

com.oraclecloud.databaseservice.database.critical 事件在数据库严重事件有效负载的 additionalDetails 部分中提供有关几种类型的严重条件和错误的详细信息。

下表列出了数据库严重事件的子类型。

EventName (in additionalDetails) 说明
AVAILABILITY.DB_GUEST.CDB_INSTANCE.DOWN 数据库实例关闭时将创建 DOWN 事件。当数据库实例因用户操作(例如使用 SQL*Plus (sqlplus) 或 Server Control Utility (srvctl) 命令)或使用这些命令的任何 Oracle Cloud 维护操作(例如执行数据库主目录软件更新)而关闭时,该事件属于 INFORMATION 类型。当数据库实例意外关闭时,事件的类型为 CRITICAL。启动数据库实例时会创建相应的 DOWN_CLEARED 事件。
HEALTH.DB_CLUSTER.CDB.ARCHIVER_HANG 如果 CDB 无法归档活动的联机重做日志或无法以足够快的速度归档活动的联机重做日志到日志归档目标,则会创建类型为 CRITICAL 的事件。
HEALTH.DB_CLUSTER.CDB.DATABASE_HANG 当进程或会话在 CDB 中变得无响应时,将创建类型为 CRITICAL 的事件。
HEALTH.DB_CLUSTER.CDB.BACKUP_FAILURE 如果 v$rman_status 视图中报告了状态为“失败”的 CDB 备份,则会创建类型为 CRITICAL 的事件。
HEALTH.DB_CLUSTER.CDB.CORRUPTION 在主数据库或备用数据库中检测到数据库损坏。对于指示物理块损坏、逻辑块损坏或丢失写入导致的逻辑块损坏的任何特定错误,将解析数据库 alert.log。

示例 - 数据库关键示例事件

“Database Critical(数据库严重)”、“DB Node Critical(数据库节点严重)”和“DB System Critical(数据库系统严重)”事件源自数据层,并在有效负载的 additionalDetails 部分中包含有关严重状况的详细信息。有关这些事件子类型的详细信息,请参见前面的表。

以下是数据库系统、数据库系统节点和数据库的引用“关键”数据层事件。

{
    "eventType": "com.oraclecloud.databaseservice.database.critical",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "source": "DataPlane",
    "eventTime": "2020-11-10T19:52:15Z",
    "contentType": "application/json",
    "data": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "VMDBSI-Dev",
        "resourceName": "DB0422_iad3x7",
        "resourceId": "ocid1.database.oc1.iad.<unique_ID>",
        "availabilityDomain": "zvXp:US-ASHBURN-AD-3",
        "additionalDetails": {
            "serviceType": "dbcs",
            "hostName": "singlenodegi-sales",
            "component": "cdb",
            "instanceName": "db0422",
            "dbName": "db0422_iad3x7",
            "description": "Database : DB0422_iad3x7 Instance : DB0422, status is offline",
            "eventName": "AVAILABILITY.DB_GUEST.CDB_INSTANCE.DOWN",
            "dbSystemId": "ocid1.dbsystem.oc1.iad.<unique_ID>",
            "status": "offline"
        }
    },
    "eventID": "91653791-7aab-45dd-b57f-e2e9013acdb9",
    extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    }
}

数据库系统事件类型

以下是数据库系统发出的事件类型。

友好名称 事件类型
数据库系统 - 更改区间开始 com.oraclecloud.databaseservice.changedbsystemcompartment.begin
数据库系统 - 更改区间结束 com.oraclecloud.databaseservice.changedbsystemcompartment.end
数据库系统 - 创建开始 com.oraclecloud.databaseservice.launchdbsystem.begin
数据库系统 - 创建结束 com.oraclecloud.databaseservice.launchdbsystem.end
数据库系统 - 严重 com.oraclecloud.databaseservice.dbsystem.critical
数据库系统 - 信息 com.oraclecloud.databaseservice.dbsystem.information
数据库系统 - 终止开始 com.oraclecloud.databaseservice.terminatedbsystem.begin
数据库系统 - 终止终止日期 com.oraclecloud.databaseservice.terminatedbsystem.end
数据库系统 - 更新 IORM 开始 com.oraclecloud.databaseservice.updateiormconfig.begin
数据库系统 - 更新 IORM 结束 com.oraclecloud.databaseservice.updateiormconfig.end

示例 - 数据库系统示例事件

这是数据库系统的参考事件。

{
    "cloudEventsVersion": "0.1",
    "contentType": "application/json",
    "data": {
        "additionalDetails": {
            "cpuCoreCount": 1,
            "dataStoragePercentage": 80,
            "dataStorageSizeInGBs": 256,
            "exadataIormConfig": "null",
            "licenseType": "LICENSE_INCLUDED",
            "lifecycleMessage": null,
            "lifecycleState": "PROVISIONING",
            "nsgIds": "null",
            "patchHistoryEntries": "null",
            "sshPublicKeys": "...",
            "version": null
        },
        "availabilityDomain": "XXIT:US-ASHBURN-AD-1",
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "example_compartment_name",
        "resourceId": "ocid1.dbsystem.oc1.iad.<unique_ID>",
        "resourceName": "myDBsystem"
    },
    "eventID": "0c1f15b1-4bf2-4f27-8a78-a48d446aeb6f",
    "eventTime": "2019-10-25T20:30:46.836Z",
    "eventType": "com.oraclecloud.databaseservice.launchdbsystem.begin",
    "eventTypeVersion": "2.0",
    "extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    },
    "source": "DatabaseService"
}

数据库系统信息事件详细信息

com.oraclecloud.databaseservice.dbsystem.information 事件在信息事件有效负载的 additionalDetails 部分中提供有关信息的详细信息。

下表记录了数据库系统信息事件的子类型。

EventName (in additionalDetails) 说明
HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE 当 ASM 磁盘组空间使用量低于 90% 时,将创建类型为 INFORMATION 的事件。

数据库系统严重事件详细信息

com.oraclecloud.databaseservice.dbsystem.critical 事件在严重事件有效负载的 additionalDetails 部分中提供有关严重条件和错误的详细信息。

下表记录了数据库系统关键事件的子类型。

EventName (in additionalDetails) 说明
HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE 当 ASM 磁盘组达到 90% 或更高的空间使用率时,将创建类型为 CRITICAL 的事件。

有关严重事件的 JSON 示例,请参阅示例 - 数据库严重示例事件。

数据库节点事件类型

下表列出了数据库节点发出的事件类型。

友好名称 事件类型
数据库节点 - 更新开始 com.oraclecloud.databaseservice.dbnodeaction.begin
数据库节点 - 更新结束 com.oraclecloud.databaseservice.dbnodeaction.end
数据库节点 - 严重 com.oraclecloud.databaseservice.dbnode.critical
数据库节点 - 信息 com.oraclecloud.databaseservice.dbnode.information

示例 - 数据库系统节点示例事件

这是数据库系统节点的引用事件。

{
    "cloudEventsVersion": "0.1",
    "eventID": "<unique_ID>",
    "eventType": "com.oraclecloud.databaseservice.dbnodeaction.begin",
    "source": "databaseservice",
    "eventTypeVersion": "2.0",
    "eventTime": "2019-07-29T04:43:24Z",
    "contentType": "application/json",
    "extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    },
    "data": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "example_compartment",
        "resourceName": "",
        "resourceId": "ocid1.dbnode.oc1.phx.<unique_ID>",
        "availabilityDomain": "TGjA:PHX-AD-2",
        "freeFormTags": null,
        "definedTags": null,
        "additionalDetails": {
            "cpuCoreCount": null,
            "lifecycleState": "STARTING",
            "dataStorageSizeInTBs": null,
            "timeCreated": "2019-06-13T04:31:05.190Z",
            "timeUpdated": "2019-07-29T04:43:06.455Z",
            "hostName": "ora18c",
            "lifecycleDetails": null,
            "dbSystemId": "ocid1.dbsystem.oc1.phx.<unique_ID>",
            "dbHostId": "DbHost-<unique_ID>",
            "nodeNumber": null
        }
    }
}

数据库节点信息事件详细信息

com.oraclecloud.databaseservice.dbnode.information 事件在数据库节点信息事件有效负载的 additionalDetails 部分中提供有关多种类型信息的详细信息。

下表记录了数据库节点信息事件的子类型。

EventName (in additionalDetails) 说明
AVAILABILITY.DB_CLUSTER.SCAN_LISTENER.DOWN_CLEARED 在确定已关闭 SCAN 监听程序的事件已清除后,将创建类型为 INFORMATION 的事件。
AVAILABILITY.DB_GUEST.CLIENT_LISTENER.DOWN_CLEARED 在确定客户端监听程序关闭的事件已清除后,将创建类型为 INFORMATION 的事件。
AVAILABILITY.DB_GUEST.CRS_INSTANCE.DOWN_CLEARED 在确定 CRS 关闭事件已清除后,将创建类型为 INFORMATION 的事件。
HEALTH.DB_GUEST.FILESYSTEM.FREE_SPACE 当 VM 来宾文件系统的空闲空间增加超过 10% 时,将创建类型为 INFORMATION 的事件。

数据库节点严重事件详细信息

com.oraclecloud.databaseservice.dbnode.critical 事件在数据库节点关键事件有效负载的 additionalDetails 部分中提供有关几种关键条件类型的详细信息。

下表记录了数据库节点严重事件的子类型。

EventName (in additionalDetails) 说明
AVAILABILITY.DB_CLUSTER.SCAN_LISTENER.DOWN 当 SCAN 监听程序关闭时,将创建 DOWN 事件。当 SCAN 监听程序因用户操作(例如使用服务器控制实用程序 (srvctl) 或监听程序控制 (lsnrctl) 命令)或任何使用这些命令的 Oracle Cloud 维护操作(例如执行网格基础结构软件更新)而关闭时,该事件的类型为 INFORMATION。当 SCAN 监听程序意外关闭时,事件的类型为 CRITICAL。启动 SCAN 监听程序时将创建相应的 DOWN_CLEARED 事件。
每个集群有三个 SCAN 监听程序,称为 LISTENER_SCAN[1,2,3]。
AVAILABILITY.DB_GUEST.CLIENT_LISTENER.DOWN 当客户机监听程序关闭时,将创建 DOWN 事件。当客户机监听程序因用户操作(例如使用服务器控制实用程序 (srvctl) 或监听程序控制 (lsnrctl) 命令)或任何使用这些命令的 Oracle Cloud 维护操作(例如执行网格基础结构软件更新)而关闭时,事件的类型为 INFORMATION。当客户机监听程序意外关闭时,事件属于 CRITICAL 类型。启动客户机监听程序时将创建相应的 DOWN_CLEARED 事件。
每个节点都有一个客户机监听程序,每个监听程序名为 LISTENER。
AVAILABILITY.DB_GUEST.CRS_INSTANCE.DOWN 当检测到集群就绪服务 (Cluster Ready Service,CRS) 关闭时,将创建类型为 CRITICAL 的事件。
AVAILABILITY.DB_GUEST.CRS_INSTANCE.EVICTION 当群集就绪服务 (Cluster Ready Service,CRS) 将节点从群集中清除时,将创建 CRITICAL 类型的事件。
HEALTH.DB_GUEST.FILESYSTEM.FREE_SPACE VM 来宾文件系统空闲空间低于操作系统 df(1) 命令确定的 10% 空闲空间时,将报告此事件:
/
/u01
/u02
/var
/tmp

有关严重事件的 JSON 示例,请参阅示例 - 数据库严重示例事件。

Oracle Database 主目录事件类型

下表列出了 Oracle Database 主目录发出的事件类型。

友好名称 事件类型
数据库主目录 - 创建开始 com.oraclecloud.databaseservice.createdbhome.begin
数据库主目录 - 创建结束 com.oraclecloud.databaseservice.createdbhome.end
数据库主目录 - 补丁程序开始 com.oraclecloud.databaseservice.patchdbhome.begin
数据库主目录 - 补丁程序结束 com.oraclecloud.databaseservice.patchdbhome.end
数据库主目录 - 终止开始 com.oraclecloud.databaseservice.deletedbhome.begin
数据库主目录 - 终止结束 com.oraclecloud.databaseservice.deletedbhome.end
数据库主目录 - 更新开始 com.oraclecloud.databaseservice.updatedbhome.begin
数据库主目录 - 更新结束 com.oraclecloud.databaseservice.updatedbhome.end

示例 - Oracle Database 主目录示例事件

这是数据库主目录的引用事件。

{
    "cloudEventsVersion": "0.1",
    "eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
    "eventType": "com.oraclecloud.databaseservice.createdbhome.begin",
    "source": "databaseservice",
    "eventTypeVersion": "2.0",
    "eventTime": "2019-08-29T21:16:04Z",
    "contentType": "application/json",
    "extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    },
    "data": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "example_compartment",
        "resourceName": "my_dbhome",
        "resourceId": "DbHome-unique_ID",
        "availabilityDomain": "all",
        "freeFormTags": {},
        "definedTags": {},
        "additionalDetails": {
            "id": "ocid1.id.oc1.<unique_ID>",
            "lifecycleState": "PROVISIONING",
            "timeCreated": "2019-08-29T12:00:00.000Z",
            "timeUpdated": "2019-08-29T12:30:00.000Z",
            "lifecycleDetails": "detail message",
            "dbSystemId": "DbSystem-unique_ID",
            "dbVersion": "19.0.0.0",
            "recordVersion": 4,
            "displayName": "example_display_name"
        }
    }
}

可插入数据库事件类型

下表列出了可插入数据库发出的事件类型。

友好名称 事件类型
可插入数据库 - 创建开始 com.oraclecloud.databaseservice.createpluggabledatabase.begin
可插入数据库 - 创建结束 com.oraclecloud.databaseservice.createpluggabledatabase.end
可插入数据库 - 删除开始 com.oraclecloud.databaseservice.deletepluggabledatabase.begin
可插入数据库 - 删除结束 com.oraclecloud.databaseservice.deletepluggabledatabase.end
可插入数据库 - 本地克隆开始 com.oraclecloud.databaseservice.localclonepluggabledatabase.begin
可插入数据库 - 本地克隆结束 com.oraclecloud.databaseservice.localclonepluggabledatabase.end
可插入数据库 - 远程克隆开始 com.oraclecloud.databaseservice.remoteclonepluggabledatabase.begin
可插入数据库 - 远程克隆结束 com.oraclecloud.databaseservice.remoteclonepluggabledatabase.end
启动可插入的数据库 - 开始 com.oraclecloud.databaseservice.startpluggabledatabase.begin
启动可插入的数据库 - 结束 com.oraclecloud.databaseservice.startpluggabledatabase.end
停止可插入数据库 - 开始 com.oraclecloud.databaseservice.stoppluggabledatabase.begin
停止可插入数据库 - 结束 com.oraclecloud.databaseservice.stoppluggabledatabase.end

示例 - 可插入数据库示例事件

这是可插入数据库 (pluggable database,PDB) 的引用事件。

{
    "eventID": "unique_id",
    "eventTime": "2021-03-23T00:49:14.123Z",
    "extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    },
    "eventType": "com.oraclecloud.databaseservice.remoteclonepluggabledatabase.begin",
    "eventTypeVersion": "2.0",
    "cloudEventsVersion": "0.1",
    "source": "databaseservice",
    "contentType": "application/json",
    "definedTags": {},
    "data": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "MyCompartment",
        "resourceName": "11092020_PKS_PDB1",
        "resourceId": "ocid1.pluggabledatabases.oc1.phx.<unique_ID>",
        "availabilityDomain": "XXIT:PHX-AD-1",
        "freeFormTags": {},
        "definedTags": {},
        "additionalDetails": {
            "id": "ocid1.pluggabledatabases.oc1.phx.<unique_ID>",
            "timeCreated": "2021-03-13T21:15:59.000Z",
            "timeUpdated": "2021-03-13T21:15:59.000Z",
            "databaseId": "ocid1.database.oc1.<unique_ID>",
            "lifecycleState": "AVAILABLE",
            "lifecycleDetails": "Pluggable Database is available",
            "displayName": "Pluggable Database - Remote Clone Begin"
        }
    }
}

Data Guard 关联事件类型

下表列出了 Data Guard 关联发出的事件类型。

友好名称 事件类型
更改保护模式开始 com.oraclecloud.databaseservice.changeprotectionmode.begin
更改保护模式结束 com.oraclecloud.databaseservice.changeprotectionmode.end
Data Guard 关联 - 创建开始 com.oraclecloud.databaseservice.createdataguardassociation.begin
Data Guard 关联 - 创建结束 com.oraclecloud.databaseservice.createdataguardassociation.end
Data Guard 关联 - 故障转移开始 com.oraclecloud.databaseservice.failoverdataguardassociation.begin
Data Guard 关联 - 故障转移结束 com.oraclecloud.databaseservice.failoverdataguardassociation.end
Data Guard 关联 - 恢复开始 com.oraclecloud.databaseservice.reinstatedataguardassociation.begin
Data Guard 关联 - 恢复结束 com.oraclecloud.databaseservice.reinstatedataguardassociation.end
Data Guard 关联 - 切换开始 com.oraclecloud.databaseservice.switchoverdataguardassociation.begin
Data Guard 关联 - 切换结束 com.oraclecloud.databaseservice.switchoverdataguardassociation.end

示例 - Data Guard 关联示例事件

这是 Data Guard 关联的引用事件。

{
    "cloudEventsVersion": "0.1",
    "contentType": "application/json",
    "data": {
        "additionalDetails": {
            "ApplyLag": null,
            "DGConfigId": "7e8eff2b-a4cd-474a-abd5-940b05c0b1fd",
            "DGConfigState": "null",
            "DatabaseId": "ocid1.database.oc1.iad.<unique_ID>",
            "DbHomeId": "ocid1.dbhome.oc1.iad.<unique_ID>",
            "DbSystemId": "ocid1.dbsystem.oc1.iad.<unique_ID>",
            "LastSyncedTime": null,
            "SyncState": "null",
            "dcsDgUpdateTimestamp": null,
            "lastUpdatedIdentifier": null,
            "lifeCycleMessage": null,
            "lifecycleState": "PROVISIONING",
            "timeCreated": "2019-10-25T21:42:19.041Z",
            "timeUpdated": "2019-10-25T21:42:19.041Z"
        },
        "availabilityDomain": "XXIT:US-ASHBURN-AD-1",
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>",
        "compartmentName": "example_compartment",
        "resourceId": "ocid1.dgassociation.oc1.iad.<unique_ID>"
    },
    "eventID": "5b8b7fbf-2e9a-4730-9761-e52715b7bc79",
    "eventTime": "2019-10-25T21:42:16.579Z",
    "eventType": "com.oraclecloud.databaseservice.createdataguardassociation.begin",
    "eventTypeVersion": "2.0",
    "extensions": {
        "compartmentId": "ocid1.compartment.oc1.<unique_ID>"
    },
    "source": "DatabaseService"
}