Oracle Cloud Infrastructure Documentation

Events Metrics

You can monitor performance of your rules by using metrics, alarms, and notifications. This topic describes the metrics emitted by the Indicator of the resource, service, or application that emits the metric. Provided in the metric definition. (Monitoring service.) Example: oci_computeagent oci_cloudevents (the Events service).

Resources: rules. Also measures data for events, which are not resources.

Prerequisites

IAM policies: To monitor resources, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.

Overview of the Events Service Metrics

You create rules that specify which events should be delivered to other services for processing. This delivery creates the automation in your tenancy. A rule identifies an event pattern to match and specifies other services to deliver matching events to. Metrics help you measure the success of the rules you create (in terms of pattern matching and delivery) and the quality and scope of the emitted events in your tenancy. For more information, see Overview of Events.

Available Metrics: oci_cloudevents

The metrics listed in the following table are automatically available for rules you create. You do not need to enable monitoring to get these metrics.

Each metric includes one or more of the following dimensions:

resourceID
The An Oracle-assigned unique ID called an Oracle Cloud Identifier (OCID). This ID is included as part of the resource's information in both the Console and API. of the rule or compartment to which the metric applies.
eventType
The type of event emitted by a resource.
resourceDisplayName
The name of the rule.
actionType
One or more of the following types of resources that receives an event from the Events service.
Metric Metric Display Name Unit Description Dimensions
PublishedEvents Published Events count Count of events emitted from all resources in a compartment.

eventType

resourceId

MatchedEvents Matched Events count Count of events matched by this rule.

resourceDisplayName

resourceId

DeliverySucceedEvents Delivered Events count Count of successful deliveries by this rule.

actionType

resourceDisplayName

resourceId

DeliveryFailedEvents Failed Deliveries count Count of failed deliveries by this rule.

Using the Console

To view default metric charts for a rule
To view default metric charts for a compartment

Using the API

Use the following APIs for monitoring: