Abiquo 6.0

Skip to end of metadata
Go to start of metadata

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.

ActionThe action that generated the event, for example, DELETE. See Events Table

Performed by

The user who performed the Action, for example, admin.

SeverityThe 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.

ContextThe 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.
  1. Click the filter button  at the top right of Events view. 
  2. 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 fieldDescription
EntityPull-down list of entities
ActionPull-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.

SeverityPull-down list of event severity. See Events severity table
UserThe name of the user who performed the action
EnterpriseThe tenant that the event occurred in
Date fromCalendar selection for start date in format YYYY/MM/DD
Date toCalendar selection for end date in format YYYY/MM/DD
ContextThe platform assigns the same context ID to a group of related entities
MessageThe 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.

  • No labels