Slack Integration

XTC’s ability to send notifications about specific events via Slack

XTC can integrate with Slack to send notifications about certain system event to public channels. Notifications include state changes for load tests or monitoring events.

Configuration

Slack notifications can be configured either at the organization or project level.

To configure Slack integration on org level, your account must at least have the role of an organization administrator within the organization.

To configure Slack integration on project level, your account must at least have the role of a project administrator within the project.

Default configuration values at the organization level: message sending is disabled, the integration is not configured and no target channels are set. Threads and compact messages are disabled.

Organization-level configuration values take effect in all the organization’s projects unless explicitly overridden. Overriding occurs at a value level, i.e. not setting a specific configuration value at the project level will leave the corresponding value of the organization’s config in place.

An integration config of a project with the “Send messages” overriden and all other values inherited from the surrounding organization.

Configuration Values

Clicking the edit button on the Slack configuration opens the configuration form for setting up or removing the integration and editing its settings:

The Slack integration config form

Send messages

The Slack integration will not send any messages unless enabled. If a project has a configuration, this value will always override the organization’s setting, i.e. projects with this set to “Disabled” will not send messages even if their containing organization has the integration enabled.

Set Up Slack Integration

This will forward the browser to Slack to initiate the integration process. If your Slack user has the appropriate permissions within the Slack workspace you will be presented with a screen to confirm the installation of XTC in your workspace. Upon confirmation you will be redirected back to the configuration overview where Slack Integration now should have changed to “Done” and and the Slack Workspace should contain the name of the Slack workspace you just installed XTC to.

Slack integration installed into a workspace named “XTC-Test-Workspace”

When an integration is set up on the project level it will override any inherited values from the surrounding organization.

Remove Slack Integration

Removing the integration from your organization or project will remove all necessary integration data. In order to re-enable the integration again, you might have to repeat the setup process, potentially including any confirmation process within Slack.

Target Channels

The channels to send messages to. Separate multiple channels using spaces. This value will override inherited values only if it is non-empty.

Message Grouping / Compact View

As the default message style takes up quite some space in the Slack channel, it might be desirable to get a more compact message view. This can be achieved by choosing the Compact Message View and/or by Grouping related messages into threads (e.g. all messages about the status of one load test).

Default message format with thread for subsequent messages about the same load test.

A message in compact format.

Send Test Message

If a complete configuration (i.e. integration data and target channels) is available (inherited or configured directly), admins can send a test message to check for a correct setup. Please check in your Slack client whether the message arrived as expected. If not please re-check the configured values.

Notification Events

Once configured XTC will send notifications for the following events:

Load Tests

  • Start A user started a load test from the UI.
  • Running The setup phase is complete; the actual test run starts.
  • Finished The test run is done.
  • Aborted The test run has been aborted by a user.
  • Error The load test failed at any step.
  • Report Available The final report for the test is available.

Additionally XTC will also send notifications when intermediate reports become available.

Monitoring

If a scenario is configured to notify via Slack, XTC will send notifications the same way it would send e-mails or text messages.

Last modified June 22, 2022