Help Desk

Submit a ticket My Tickets
Welcome
Login

Slack

Overview

OneCloud’s Slack integration provides a nice alternative to email notifications with daily, weekly, and monthly reports about Chain execution status in a particular OneCloud Environment. For users that subscribe to a OneCloud Slack channel, they are provided with updates that can be helpful in managing the health of their Chain runs. Each report includes the total number of Chain runs, as well as metrics regarding how many Chains succeeded and failed. 

Setup

It is easy to set up the integration between Slack and OneCloud.

Step 1:

Navigate to the administration section, and select Integrations –> Slack.

Step 2:

Click the Add to Slack button and you will be prompted to add the OneCloud Slack App to a Slack Workspace.

Step 3:

Once prompted by Slack to add the OneCloud App, a list of permissions will be displayed that the OneCloud app requires. Click Authorize to establish the required permissions. 

Note about personal information

OneCloud will never use personal information in Slack. The permissions that are required are based on the ability to post messages to Slack channels and track if a Slack user has been linked to OneCloud.

Reports

A part of the Slack integration is that it allows OneCloud users to get customized reports about their OneCloud operating environment(s). Each report consists of three parts: 

  • Environment - The OneCloud Environment that a report focuses on.
  • Slack Channel - The Slack channel to send the report to.
  • Frequency - Set the frequency of receiving the report.

To set up these reports, open up the OneCloud Admin panel, select Integrations, and then select Slack

Administrative access is required

Note that the user ID must belong to the OneCloud administrative group to access these settings.

Slash Commands

Slash commands are a powerful feature of Slack and OneCloud offers a unique set of commands that can be used. For more information about slash commands, please read the Slack documentation

Here are the commands supported by OneCloud:

Help Commands

This command will show the available commands that can be used within Slack. 

->/onecloud help 

Execute Commands

This command executes a Chain from within Slack. If the Chain ID or Chain name are known, simply add this information after the `execute` command. If the exact Chain ID or name is not provided, then a list of Chains that match the criteria will be returned. To execute a particular Chain, simply press the Execute button to start the Chain. 

/onecloud execute (ID or name) 

Live feedback!

After a Chain begins to execute, a confirmation message will be displayed. Upon completion, a message will be posted to the same Slack channel that a particular Chain ran and with details about the Chains status (success, warning, or error). 

Explicitly execute a Chain

To explicitly execute a Chain, please use this syntax:

Workspace :: Environment :: Chain name

Permissions still apply!

When running Chains from Slack, the user that is trying to run a Chain will only be able to see and execute Chains that they have access to.

What's Next?

> Configuring Approvals

B
Brian is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.