Skip to content

Actions

The Zenoss Cloud action service provides tools for responding automatically to changes (events) in your environment.

Note

The action service is in Beta release and might not be available in your Zenoss Cloud environment. For more information, please contact your Zenoss representative.

You configure the action service to send one-way messages (notifications) when conditions match the criteria you specify.

  • A trigger is a query that specifies the criteria for initiating actions.

    Queries can range from simple comparisons ("event status equal to open") to complex series of comparisons with subordinate clauses.

  • The target of an action (recipient of a notification) is a destination.

    Destinations include channels in Slack workspaces, webhooks, and email addresses.

  • A rule combines one or more triggers with one or more destinations and a customized message.

    When conditions match any trigger in a rule, Zenoss Cloud sends a message to all the destinations in the rule. Only rules can initiate actions.

Note

This feature is independent of the Collection Zone triggers and notifications features.

The following diagram shows an example set of relationships among triggers, destinations, and rules.

  • Rule A combines Trigger 1, Trigger 2, and Destination 1.
  • Rule B combines Trigger 2, Trigger 3, Destination 1, Destination 2, and Destination 3.

Managing actions

The ADMIN > Actions page provides tools for for creating and managing triggers, destinations, and rules. In addition, you can review the history of actions for any time range in your data retention period.

Users with the Manager role can view the page and create and manage actions. The actions service of the Zenoss API includes resources for creating and managing triggers, destinations, and rules, as well.

Managing rules, triggers, and destinations

Each of the tabs on the ADMIN > Actions page displays a table. You can add, edit, and delete entries on the RULES, TRIGGERS, and DESTINATIONS tabs.

  • To view the specifications of an entry, select the eye icon in the Actions column.

  • To clone, edit, or delete an entry, select the menu control (three vertical dots in the Actions column) and then select an option.

  • To filter entries, enter a search term at the top of a column.

  • To configure the rows per page and navigate the pages, use the controls at the bottom-right side of the page.

For more information about adding entries, see the following pages:

Managing action history

The HISTORY tab on the ADMIN > Actions page displays the action service log in a table.

The default time range is the past 24 hours, but you can change it to any range within your data retention period.

The history table works just like the tables on the other tabs:

  • To view the details of an entry, select the eye icon in the Actions column.
  • To filter entries, enter a search term at the top of a column.
  • To configure the rows per page and navigate the pages, use the controls at the bottom-right side of the page.

Entries cannot be deleted; the history table is read-only.