Overview of Oracle Data Safe Events

Administrators can configure the Oracle Data Safe service to emit events in Oracle Cloud Infrastructure, which are structured messages that indicate changes in resources.

Rule Conditions

When you create a rule, you start by configuring a condition. The first condition specifies the event type(s) for which you want to be notified. If you want to set filters on the event types, you can add more conditions that specify attributes and tags.

Let's look at a simple example. Suppose you want to be notified when an audit profile is updated in Oracle Data Safe. To do this, in the event rule, you select the Update Audit Profile event type for the first condition. Because you are interested in a particular database, you add a second condition to the rule with a filter on the attribute targetId. For its value, you enter the OCID of your target database. Now, if a user updates the audit profile for your target database, you will be notified. The following screenshot shows you the Create Rule page in Oracle Cloud Infrastructure with these conditions configured.

Notification Text

Notification text is in JSON format. From the Create Rule page in Oracle Cloud Infrastructure, you can preview the text. Simply click the View example events (JSON) link and select an Oracle Data Safe event type. The following is an example for the Create Audit Archive retrieval - Begin event type:

{
  "eventType": "com.oraclecloud.datasafe.createarchiveretrieval.begin",
  "cloudEventsVersion": "0.1",
  "eventTypeVersion": "2.0",
  "source": "DataSafe",
  "eventTime": "2021-11-18T12:06:46.588Z",
  "contentType": "application/json",
  "data": {
    "compartmentId": "ocid1.tenancy.oc1..unique_ID",
    "compartmentName": "example-compartment",
    "resourceName": "auditArchiveRetrievals",
    "resourceId": "ocid1.coreservicesworkrequest.oc1..unique_ID",
    "availabilityDomain": "ad1",
    "additionalDetails": {
      "targetId": "ocid1.datasafetargetdatabase.oc1..unique_ID",
      "startDate": "2021-02-01T00:00:00.000Z",
      "endDate": "2021-05-01T00:00:00.000Z"
    }
  },
  "eventID": "unique_ID",
  "extensions": {
    "compartmentId": "ocid1.tenancy.oc1..unique_ID"
  }
}

Each event type has its own set of additional details, and some do not have any. In the example above, the additionalDetails node shows you target database name, start date, and end date.