Skip to content

Notifications

notifications-menu

The notification page displays the list of notifications configured. It is accessible from the left menu. A notification is a message sent to an external system when a test reaches a particular status referred to as an Event.

Tip

Notifications can be used along with scheduled tests to keep track of automated tests.


Notifications page

notifications-list

There are 4 types of notification available:


Here's an example notification for a test start and end:

demo@octoperf.com - TEST_STARTED demo, with 100 concurrent users, for 10 min, in regions Paris
demo@octoperf.com - TEST_ENDED demo ended with status: FINISHED
Hits = 36146.00 hits, Errors = 5.00 errors, % Errors = 0.01 % errors, Avg Elapsed = 1.71 sec, Total Throughput = 138.15 MB,  Alarms: [WARNING]

As you can see you also get basic statistics along with the TEST_ENDED message.

Notification list

notifications-list

This list shows all the existing notifications in this workspace.

Info

The search functions are detailed in this section of the navigation page.


Icon Action Description
create-new Create new notification This will create a new notification in the current workspace.
delete Delete notification Lets you remove a Workspace in one click. All the projects of the workspace are also removed. This operation cannot be reverted so proceed with caution.

Add a Notification

Create-notification

You can select the notification type from this menu. Further instructions on each notification type can be found below:


Warning

Once selected the notification type cannot be changed.

Edit a Notification

Email

The email notification will simply send a direct mail on every event that triggers it.

Slack integration

If you want to receive a PDF report with your email you can activate the option and configure the report options.

Slack

You will need to configure an incoming webhook in slack. The procedure can be found in their documentation.

Slack integration

For this example we have:

  • The Token given by slack during the webhook creation T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX,
  • The user that created the webhook is named Demo,
  • Has an #octoperf channel and Demo can post into it.

Note

The token is considered a secret and as such is not displayed in our UI.

Microsoft Teams

You need to configure an incoming webhook in Microsoft Teams. The procedure can be found in their documentation.

MS integration

To create the notification in OctoPerf, simply provide the Teams Webhook URL.

Jira

To configure a Jira notification you will need to provide the following information:

  • The Jira URL,
  • The E-mail used to register to Jira,
  • Your Jira API token.

JIRA integration

Next, you will have to select:

  • The board (your project),
  • The column that contains the issues relevant to your load test,
  • If the issues will stay in the same column or moved to another one after the test is over.

JIRA integration

HTTP

Slack integration

The HTTP Notification allows you to send the notification to any API or compatible Webhook. It is possible to pass custom headers in order to send authentication information.

Events

The events define what events are sent for each configuration:

Event Description
Test started The test has been launched. Note that this event only logs that a test has been queued for startup, not that is successfully started.
Test ended The test has stopped. There can be a number of reasons for a test to stop, check our dedicated Test status page for more info.
Test error The test was unable to launch, usually because an on premise load generator is down. Check the test logs for more info.
Test passed The test has finished with no critical alert.
Test failed The test has finished but a monitoring alert triggered, an SLA triggered or the error rate was higher than octoperf.notifications.max-percent-errors (5% is the default on the SaaS platform).

Filters

notification-filter

Filter the tests that will trigger notifications based on:

  • Test duration,
  • Number of concurrent users,
  • Scenario name.

This setting is a good way to target notifications on a specific type of test.


Remove a notification

remove-notification

You can remove one or several notifications using the list.

Warning

Notifications cannot be restored, be careful when removing them.

Test notification

When you click the test button, a dummy notification is sent:

dummy-notification

If you do not receive it, double check your notification configuration.