OS Management Events

You can create automation based on state changes for your Oracle Cloud Infrastructure resources by using event types, rules, and actions. For more information, see Overview of Events.

Note

Oracle Autonomous Linux provides instance monitoring and captures events to help quickly identify and debug anomalies, errors, and failures in the operating system. These events are a key feature of the Autonomous Linux service and are unrelated to the Events service. For more information about Autonomous Linux events, see Understanding Autonomous Linux Events.

OS Management resources that emit events:

Managed Instance Event Types
Managed Instance Group Event Types
Scheduled Job Event Types
Software Source Event Types

Events are also emitted for other OS Management service resources, such as Errata and WorkRequest resources. Event schemas, however, are not defined for these resources because only list and get operations can be performed on them.

Managed Instance Event Types

These are the event types that the managed instance resource emits:


Friendly Name	Event Type
Attach Child Software Source	`com.oraclecloud.osms.attachchildsoftwaresourcetomanagedinstance`
Attach Parent Software Source	`com.oraclecloud.osms.attachparentsoftwaresourcetomanagedinstance`
Detach Child Software Source	`com.oraclecloud.osms.detachchildsoftwaresourcefrommanagedinstance`
Detach Parent Software Source	`com.oraclecloud.osms.detachparentsoftwaresourcefrommanagedinstance`
Install All Package Updates	`com.oraclecloud.osms.installallpackageupdatesonmanagedinstance`
Install Package	`com.oraclecloud.osms.installpackageonmanagedinstance`
Install Package Update	`com.oraclecloud.osms.installpackageupdateonmanagedinstance`
Remove Package	`com.oraclecloud.osms.removepackagefrommanagedinstance`

Managed Instance Example

This is a reference event for managed instance:


{
    "eventType": "com.oraclecloud.osms.installallpackageupdatesonmanagedinstance",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "eventID": "<unique_ID>",
    "source": "OSMS",
    "eventTime": "2019-10-16T19:16:38.543Z",
    "contentType": "application/json",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>"
    },
    "data": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
      "compartmentName": "example_compartment",
      "resourceName": "example_name",
      "resourceId": "ocid1.instance.oc1.phx.<unique_ID>",
      "availabilityDomain": "<availability_domain>",
      "additionalDetails": {
        "softwarePackageName": "example_packageName"
      }
    }
  },

Managed Instance Group Event Types

These are the event types that managed instance group resource emits:


Friendly Name	Event Type
Attach Managed Instance	`com.oraclecloud.osms.attachmanagedinstancetomanagedinstancegroup`
Change Compartment	`com.oraclecloud.osms.changemanagedinstancegroupcompartment`
Create	`com.oraclecloud.osms.createmanagedinstancegroup`
Delete	`com.oraclecloud.osms.deletemanagedinstancegroup`
Detach Managed Instance	`com.oraclecloud.osms.detachmanagedinstancefrommanagedinstancegroup`
Update	`com.oraclecloud.osms.updatemanagedinstancegroup`

Managed Instance Group Example

This is a reference event for managed instance groups:


{
    "eventType": "com.oraclecloud.osms.createmanagedinstancegroup",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "eventID": "<unique_ID>",
    "source": "OSMS",
    "eventTime": "2019-10-16T19:16:38.543Z",
    "contentType": "application/json",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>"
    },
    "data": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>D",
      "compartmentName": "example_compartment",
      "resourceName": "example_name",
      "resourceId": "ocid1.osmsmanagedinstancegroup.realm_name.<unique_ID>",
      "availabilityDomain": "<availability_domain>",
      "freeFormTags": {
        "example_tag": "value"
      },
      "definedTags": {
        "example_tag": {
          "example_tag": "value"
        }
      }
    }
  },

Scheduled Job Event Types

These are the event types that the scheduled job resource emits:


Friendly Name	Event Type
Change Compartment	`com.oraclecloud.osms.changescheduledjobcompartment`
Create	`com.oraclecloud.osms.createscheduledjob`
Delete	`com.oraclecloud.osms.deletescheduledjob`
Run Now	`com.oraclecloud.osms.runscheduledjobnow`
Skip Next Execution	`com.oraclecloud.osms.skipnextscheduledjobexecution`
Update	`com.oraclecloud.osms.updatescheduledjob`

Scheduled Job Example

This is a reference event for scheduled jobs:


{
    "eventType": "com.oraclecloud.osms.createscheduledjob",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "eventID": "<unique_ID>",
    "source": "OSMS",
    "eventTime": "2019-10-16T19:16:38.543Z",
    "contentType": "application/json",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>"
    },
    "data": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
      "compartmentName": "example_compartment",
      "resourceName": "example_name",
      "resourceId": "ocid1.osmsscheduledjob.realm_name.<unique_ID>",
      "availabilityDomain": "<availability_domain>",
      "freeFormTags": {
        "example_tag": "value"
      },
      "definedTags": {
        "example_tag": {
          "example_tag": "value"
        }
      }
    }
  },

Software Source Event Types

These are the event types that the software source resource emits:


Friendly Name	Event Type
Add Packages	`com.oraclecloud.osms.addpackagestosoftwaresource`
Change Compartment	`com.oraclecloud.osms.changesoftwaresourcecompartment`
Create	`com.oraclecloud.osms.createsoftwaresource`
Delete	`com.oraclecloud.osms.deletesoftwaresource`
Remove Packages	`com.oraclecloud.osms.removepackagesfromsoftwaresource`
Update	`com.oraclecloud.osms.updatesoftwaresource`

Software Source Example

This is a reference event for software sources:


{
    "eventType": "com.oraclecloud.osms.updatesoftwaresource",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "eventID": "<unique_ID>",
    "source": "OSMS",
    "eventTime": "2019-10-17T13:35:50.676Z",
    "contentType": "application/json",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>"
    },
    "data": {
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
      "compartmentName": "example_compartment",
      "resourceName": "Test Software Source",
      "resourceId": "ocid1.osmssoftwaresource.realm_name.<unique_ID>",
      "availabilityDomain": "<availability_domain>",
      "freeFormTags": {
        "test_tag_2": "testgroup"
      },
      "definedTags": {
        "osms_tag_test": {
          "test_tag_2": "testgroup"
        }
      }
    }
  },

Oracle Cloud Infrastructure Documentation