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.
It is easy to set up the integration between Slack and OneCloud.
Navigate to the administration section, and select Integrations –> Slack.
Click the Add to Slack button and you will be prompted to add the OneCloud Slack App to a Slack Workspace.
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.
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 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:
This command will show the available commands that can be used within Slack.
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)
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.