Skip to content

Destinations

A destination specifies the target of an action, the receiving application of a one-way message (a notification). Zenoss Cloud supports the following destinations:

  • Public channels in Slack workspaces

  • Any application that supports webhooks

  • Email addresses

Destinations cannot initiate actions. Only rules can initiate actions. A destination may be used in any number of rules. Your user account must have the Manager role to create and manage destinations in the Zenoss Cloud interface.

To use a Slack channel in a destination, first install the Zenoss Slack app:

Add to Slack

Note

Slack and Webhook destinations receive the customized message defined in a rule, while email destinations receive the message defined in the Subject and Message body fields of a destination.

Adding a destination

You can add a destination through the Zenoss Cloud interface on the DESTINATIONS tab of the ADMIN > Actions page. You can also use the Zenoss API to create a destination.

When you add a destination with the ADD DESTINATION dialog, you first select the destination type and then specify the destination itself. When you are finished, you can test the destination or just save it.

The following tables describe the fields you can use to specify a destination.

Field Required? Description
Destination name Yes

A unique, short identifier for the destination.

The name of a destination cannot be changed after the ADD DESTINATION dialog is saved.

Destination description No Additional text to further describe the destination.
Destination type Yes

The type to create (Slack, Webhook, or Email).

Tags No A list of arbitrary terms to associate with the destination.

Field Required? Description
Send email to Yes One email address.
Subject No

Text for the subject line of the email message.

Zenoss Cloud populates this field with commonly-used content and templates, which you can change.

Message body No

Text for the body of the email message.

Zenoss Cloud populates this field with commonly-used content and templates, which you can change.

Field Required? Description
Token Yes

Select the GET TOKEN control to fill this field with the required bot token.

To use a Slack channel in a destination, first install the "Zenoss" Slack app in your workspace.

Channel name Yes

The name of a public channel in your Slack workspace.

Channel names that start with the number sign character are not accepted.

Notification color No

The color to use in messages sent to the channel.

The color is applied to a vertical bar accompanying the message block.

Field Required? Description
URL Yes

The URL of a webhook receiver.

Zenoss Cloud uses POST to send a JSON message to the receiver.