A notification destination determines where an alert is sent once it’s triggered. Lightstep Observability has built-in capability to set the following integrations destinations:
If you want alerts sent to a different app, you can use Webhooks. Lightstep offers a number of templates for popular destinations to get you started.
Once you create a notification destination, you can test it by sending a test alert.
You can also create and manage notification destinations using our Public API.
Create a PagerDuty notification destination
PagerDuty alerts create a new incident in PagerDuty, and the resolution of the alert in Lightstep Observability resolves the PagerDuty incident.
To create a PagerDuty destination:
-
From the navigation bar, click Alerts.
The Alerts view shows a list of all current alerts.
-
Click the Notification destinations tab, click Create a destination and choose PagerDuty.
You’re redirected to PagerDuty. PagerDuty asks you to authorize Lightstep to trigger, acknowledge, and resolve incidents.
-
Enter your credentials and click Authorize Integration. Select an existing service with a Lightstep Observability integration or create a new PagerDuty service with an integration. Follow the prompts to configure PagerDuty.
Once configured in PagerDuty, the PagerDuty service is listed as a destination in Lightstep Observability.
You can test that destination is correctly configured by sending a test alert.
Create a Slack notification destination
When you define Slack as a destination, the alert is sent to a specific channel or person in a Slack workspace. If you want all your workspace’s Slack channels to be enabled for destinations, then you can integrate Slack to provide that authorization.
The Slack message shows information about the alert with links back into Lightstep to begin your investigation. Alerts when the threshold is violated and notification when it’s resolved are sent to the Slack channel.
You can also customize the Slack payload using the webhook template.
You must have Admin privileges for your Slack workspace to create a Slack destination.
To create a Slack notification destination:
-
From the navigation bar, click Alerts.
The Alerts view shows a list of all current alerts.
-
Click the Notification destinations tab, click Create a destination and choose Slack.
You’re redirected to Slack. Slack asks you to sign into the workspace you want to post the alert to.
-
Enter your workspace name and click Continue.
An authorization page displays asking to authorize Lightstep to post to your Slack Workspace.
-
Select the channel that should receive the alert and click Install.
The channel is added as a notification destination. You can test that your destination is correctly configured by sending a test alert.
Add a Slack workspace integration
If you are using the Public API to create a notification destination, or you want to send Lightstep alerts to multiple Slack channels in your workspace without creating a destination per channel, you must first enable the Slack workspace integration.
To integrate your Slack workspace:
- In Lightstep Observability, in the left-hand navigation bar, click Account and choose Account Settings.
- Scroll to the Slack integration table. In the Send alerts and warnings to Slack, click the Enable Slack button.
Be sure to select the first integration in the table. The second integration allows you to display previews when sharing Lightstep Observability links in Slack.
To remove the integration, click the Revoke button.
Create a BigPanda notification destination
Alerts with a BigPanda destination result in a new incident in BigPanda. When the alert is resolved, the incident is moved to the Resolved folder in BigPanda.
To create a BigPanda destination, you’ll need a BigPanda Bearer token and App key, generated from the Integrations tab in BigPanda.
To generate the BigPanda App key and Bearer token:
-
In BigPanda, click the Integrations tab and click New Integration.
-
On the Create a New Integration page, choose REST API.
-
For Step 1, enter a name for the integration and click Generate App Key.
Your App key and Bearer token are generated. You’ll need these to configure the destination in Lightstep Observability.
To create a BigPanda destination:
-
In Lightstep Observability, from the navigation bar, click Alerts.
The Alerts view shows a list of all current alerts.
-
Click the Notification destinations tab, click Create a destination and choose BigPanda.
-
Enter a name for the destination and paste in the Bearer token and App key. You can add optional header content if needed. Click Save.
BigPanda is listed as a destination in Lightstep Observability.
You can test that destination is correctly configured by sending a test alert.
Test a notification destination
Once you create a notification destination, you can test that it’s configured properly. Lightstep Observability sends a test message without any specific alert information.
To test a notification destination:
- From the navigation bar, click Alerts and click the Notification destinations tab.
-
In the list of destinations, click Test for the appropriate destination.
Lightstep Observability sends a test message.
Delete a notification destination
You can delete notification destination from the Notification destinations tab.
To delete a notification destination:
- From the navigation bar, click Monitoring and click the Notification destinations tab.
- Click Delete for the appropriate destination.