JAMS v7.1 introduces the new Slack Integration.
In this Article
- Installing Slack Integration
- Configuring Slack Integration
- Slack Events in JAMS
- Creating a Slack Event
- Viewing the Slack Event
Installing Slack Integration
- On the JAMS Server, navigate to "C:\Program Files\MVPSI\JAMS\Scheduler" by default and right click JAMSDBA.exe and select "Run an administrator".
Note: The above path may be different if JAMS was installed on a different drive.
2. Type LOAD/Assembly=SlackIntegration
, then select Enter. The Slack Integration will be installed.
Note: When upgrading JAMS versions, the Load/Assembly step must be repeated to update Slack property definitions.
Configuring Slack Integration
- Launch the JAMS Client, then navigate to the Integrations tab using the Configuration Shortcut.
- Select the integrations Tab
- From the Integration tab, enter the SLACK API Token, also known as the Slack API Key and the Slack URL if different from the default. Select "Save"
NOTE: The Slack Legacy Token API Key is required.
Slack Events in JAMS
After configuring the Slack Integration, Slack Events can be created within any JAMS Folder or Job.
Slack Event Properties
Property | Description |
---|---|
Status | |
Enabled | Used to enable or disable the Event Handler. |
Slack | |
Slack Channel | The name of the Slack Channel that should receive the event. |
Severity | The severity of the configured event. |
Message | A summary of the event that may contain object references in {} curly braces, such as {JAMS.JobName}. |
Include Link to Entry | Determines whether the Slack message should include a link to the Entry's details. Opens in the JAMS Web Client. |
Events | |
Entry Success | Defines whether the event should be triggered when the entry completes with a successful completion severity. |
Entry Informational | Defines whether the event should be triggered when the entry completes with an informational completion severity. |
Entry Warning | Defines whether the event should be triggered when the entry completes with a warning completion severity. |
Entry Error | Defines whether the event should be triggered when the entry completes with an error completion severity. |
Entry Fatal | Defines whether the event should be triggered when the entry completes with a fatal completion severity. |
Entry Started | Defines whether the event should be triggered when the Job has started executing. |
Normal Event | Defines whether the event should be triggered when a normal event occurs. |
Low Event | Defines whether the event should be triggered when a low event occurs. |
Moderate Event | Defines whether the event should be triggered when a moderate event occurs. |
High Event | Defines whether the event should be triggered when a high event occurs. |
Urgent Event | Defines whether the event should be triggered when an urgent event occurs. |
Critical Event | Defines whether the event should be triggered when a critical event occurs. |
Creating a Slack Event
- From the Job's properties, select the Schedule tab.
- Select the Add icon to view the available menu options. Select "When an event occurs..." then choose "send a Slack Alert..."
- From the When an event occurs window, scroll to the Slack fields. The Slack Channel, Severity, Message, and Include link to Entry fields must be completed:
Slack Channel - Enter the name of the slack Channel that is to receive the alert.
Severity - Choose the Severity Level from a scale of 1 to 5
Message - Enter the Message to be included within the Slack alert. (In order to send an alert to the Slack Channel, a message must be entered)
Include link to Entry - Select the check box to include a link to the JAMS Entry within the Slack Alert
Finish - Select "Finish" after completing the fields outlined above.
Note: The JAMS Scheduler Service must be restarted to ensure the Slack configuration is completed:
Viewing the Slack Event
With the Slack Event configured, JAMS will send a message to the defined Slack channel when the configured Event occurs. JAMS will also send updates to the Event's thread in Slack when there are changes to the event, such as a restart.
An example of this can be seen in the screenshot below.
NOTE: If end-users have a local instance of JAMS, clicking the Link to the Entry may open a JAMS Entry on the local machine instead of the intended entry caused by the Slack Event.
Additional Information
- Visit the Slack Help Center to learn more about Creating and Regenerating API Tokens needed for the Slack API Key within JAMS.
Comments