Events view

The Events view allows users to see what is happening in Abiquo

Introduction to events view

The Events view allows users to display information about what is happening in the platform. The events describe actions on entities in the platform. The Events from this view also display on the user's dashboard, and VM events display within the VM. Users can also access events through the REST API and the streaming API. Users can filter events by entity and action and by date.

Display events

To open the Events view, click on the events icon on the main menu bar.

To add new events as they arrive, select the Update automatically checkbox. Otherwise, you must refresh the list manually.

To display the event details in the panel below the Event list, double-click on an Event.

Some users may not be allowed to view events. If the events you expected to display do not appear in Events view, check with your system administrator.

Configure display of events

Event viewing can be restricted using privileges assigned to user roles.

To turn off the display of the Events icon on the main menu and to prevent the user from accessing the Events view, remove all event privileges from the user role.

To allow users to only display events from their own tenant, assign the Display all events for current enterprise to the user role. This the default privilege for the cloud user and enterprise admin roles.

If an administrator can switch enterprises, to enable them to view events for all enterprises, assign the Display all events privilege. This is the default privilege for the cloud admin role.

Privilege: Display all events for current enterprise, Display all events, Allow user to switch enterprises

Event attributes

An event in the platform has the following attributes:

Attribute	Description
Entity	The system object that is the source of the event or error. For example, it could be a VIRTUAL_APPLIANCE for a group of virtual machines.
Entity name	The name of the system object that is the source of the event or error, for example, myVirtualAppliance.
Action	The action that generated the event, for example, DELETE. See Events Table
Performed by	The user who performed the Action, for example, admin.
Severity	The severity of the event. Can be INFO, WARN or ERROR
Date/time	The date and time when the event was generated.
Message	Additional information about the event. See Events Table for more details. Note for administrator: The traces displayed in Events view are also found in the Logs, such as catalina.out, which are documented in the Troubleshooting section of the Abiquo Administrator's Guide.
Context	The identifier of a group of related events. This attribute is in the event detail but not in the event list.

Event context

When you view the event detail, the platform will display the Context of the event. The context is an ID that the platform assigns to each event in a group of related events. For example, if you undeploy a virtual appliance, the platform will create events for the undeploy of each VM, the destruction of the related hard disks, and the release of the NICs. And the platform will assign the context ID to each of these events.

To display all the events related to an event, select the Event from the list, from the details view, copy the Context ID and filter by Context.

Filter events

To make it easier to find a specific event, use the filter tool.

Click the filter button at the top right of Events view.
Enter your filter criteria as described in the table below and click Accept.

To remove the filter, click Clear at the bottom of the popup.

When events are filtered, the text (events filtered) will be displayed next to the filter button.

Event field	Description
Entity	Pull-down list of entities
Action	Pull-down list of actions
Entity name	The name of the entity. The Name field may contain the UUID or the friendly name of the entity. For alarms, the Entity name field contains the UUID of the alarm. To filter alarm events by name, enter the friendly name of the alarm in the Message field of the filter.
Severity	Pull-down list of event severity. See Events severity table
User	The name of the user who performed the action
Enterprise	The tenant that the event occurred in
Date from	Calendar selection for start date in format YYYY/MM/DD
Date to	Calendar selection for end date in format YYYY/MM/DD
Context	The platform assigns the same context ID to a group of related entities
Message	The message field will contain the details of the event, including the friendly name. See Events table

Filter events admin example

To filter alarm events by name, enter the friendly name of the alarm in the "Message" field of the filter. Note that the Name field contains the UUID of the alarm.

To display all events related to an event, select the event, copy the context ID and filter by context.

Severity table

Events on the cloud platform are classified into three severity categories: info, warning and error.

Severity	Description
INFO	General information events for the user as part of the normal use of the platform
WARNING	Warning about an abnormal situation that does not block normal use of the platform
ERROR	Error that blocks the normal use of the platform

Events table

For a reference of all the actions that you can perform on each entity and the events that they can generate on the platform, see the Events table. For example, for the Action plan entity, you can perform the Create, Modify and Delete actions, and the platform will also generate events you run an action plan and it performs action on other entities, such as VMs.

Event streaming

The platform streams events using the Abiquo Outbound API. The format of the streamed events is described at Trace entity.