All Products
Search
Document Center

EventBridge:Analysis of events in the system event bus

Last Updated:Jul 30, 2024

This topic describes how to query and analyze Alibaba Cloud service events in the EventBridge console.

Before you start

Activate EventBridge and grant permissions to a RAM user

Limits

You can query only event schemas in the OpenAPI 3.0 format.

Enable the event analysis feature

  1. Log on to the EventBridge console. In the left-side navigation pane, click Event Buses.

  2. In the top navigation bar, select a region.

  3. On the Event Buses page, find the default event bus with the System Event Bus tag and click Details in the Actions column.

  4. In the Basic Information section of the Event Bus Overview page, turn on Event Analysis.

  5. In the Note message, click OK. On the EventBridge Event Analysis Invitational Preview Application page, enter application information for the invitational preview and click Submit.

Query and analyze events

  1. Log on to the EventBridge console. In the left-side navigation pane, choose Event Center > Event Analysis.

  2. In the top navigation bar, select a region.

  3. On the Event Analysis page, configure the parameters that are described in the following table and click Query.

    Event Analysis page

    Parameter

    Required

    Description

    Event Bus

    Yes

    The name of the event bus whose events you want to query.

    Schema

    Yes

    The schema of the event type to be queried. For more information about the types of Alibaba Cloud service events, see Alibaba Cloud service event sources.

    Key-value Match

    No

    The key-value pair that is used to match events. You can specify one or more key-value pairs. Conditional expressions support the following operators:

    • =: If you use = as the operator, you must specify the value of the field. In this case, all events that meet the key = value condition are queried.

    • !=: If you use != as the operator, you must specify the value of the field. In this case, all events that meet the key != value condition are queried.

    • exists: All events that meet the key exists condition are queried.

    • does-not-exist: All events that meet the key does-not-exist condition are queried.

    Note

    You can also select AND or OR to the right of the Key-value Match parameter to specify the relationship between multiple key-value pairs.

    Aggregate Function

    No

    The aggregate function that is used for data visualization. If you want to view the query results in charts, you must set the Aggregate Function parameter. You can select one or more aggregate functions. An aggregate function corresponds to a line chart.

    Grouped By

    No

    The name of the field based on which events are grouped. If you want to group the queried events, enter a field that specifies an event property. You can enter one or more fields.

    Ordered By

    No

    The name of the field based on which events are sorted. Events can be sorted in ascending or descending order based on the aggregate functions specified by the Aggregate Function parameter. You can enter one or more fields.

    Time Range

    No

    The time range to query the events.

    Number of Events

    No

    The maximum number of events to be queried.

    After the preceding steps are performed, you can view the query results on the Aggregate Function and Table tabs of the Event Analysis page.

View the query results

You can view the query results on the Aggregate Function and Table tabs.

  • Aggregate Function

    The Aggregate Function tab displays the query results in charts. The query results are displayed only when you set the Aggregate Function parameter. The ordinate indicates the value and unit, and the abscissa indicates the time, as shown in the following figure. The lines of different colors in the charts represent different resource items of Alibaba Cloud services. For example, if events of Container Service for Kubernetes (ACK) are queried, the lines of different colors represent Deployments, ReplicaSets, and StatefulSets of ACK. For more information, see Concepts.

    Aggregate Function tab

  • Table

    The Table tab displays the query results in a table. The query results are displayed only when you set the Ordered By parameter. The table contains critical information such as the ID of each event, the name of the event bus, and the time when each event is published, as shown in the following figure. You can view the details of an event, and the trace of the event in the EventBridge console. For more information, see Overview.

    Table tab