Subscribing to notifications

Overview

This topic explains how to subscribe to notifications in Slack channels. You can receive notifications when resources are created, updated, deleted, or are ready for removal.

It can be useful to let an entire channel know when a flag changes or is ready to remove. You can receive notifications when someone toggles a flag’s targeting on or off, when someone creates new resources in a certain environment, and when flags are ready for removal from your codebase.

Subscribe to notifications

You can subscribe to updates for flags, metrics, projects, or environments. When someone updates a resource or when an alert is triggered, either directly in LaunchDarkly or through the Slack app, LaunchDarkly sends a notification to all channels subscribed to updates for that resource. Subscriptions must have a project, and can optionally include parameters like a specific environment, flag name, status, or tag that will filter the notifications you receive.

There are two ways to create a subscription to flag notifications: the Slack modal workflow or the /launchdarkly subscribe command. Subscriptions created through the modal must specify a project and environment.

Subscribe using the modal

To subscribe using the modal:

1. Open the Slack channel you want notifications in.

• After you set up the Slack app, you can subscribe to notifications in any public Slack channel.
• If you want notifications in a private Slack channel, you must add the Slack app to the channel explicitly. Click the Integrations tab in the private channel. Then select Add app.

2. Type /launchdarkly subscribe in your Slack client’s text bar and press Enter. The “Create subscription” dialog appears.

3. Select the project and environment you’d like to receive notifications for.
4. (Optional) You can further refine your subscription defining specific flag, status, action, or tag. You can use * as a wildcard in your flag key. You’ll only receive updates for flags that match these parameters.

4. Click Preview to view the list of flags that your parameters include.
5. Click Create subscription to subscribe the channel to flag notifications. A confirmation message appears in the channel after you close the dialog.

Subscribe using the command

There are two ways to subscribe to updates using the command: with keyword arguments (recommended), or with positional arguments. To view more information and examples of the subscribe command, run /launchdarkly help subscribe in a channel that the LaunchDarkly bot is in.

Subscribe with keyword arguments

You can use keyword arguments to create a subscription with any combination of parameters. At least one parameter is required.

Here’s how:

1. Open the Slack channel you want notifications in.

• After you set up the Slack app, you can subscribe to notifications in any public Slack channel.
• If you want notifications in a private Slack channel, you must add the Slack app to the channel explicitly. Click the Integrations tab in the private channel. Then select Add app.

2. Run /launchdarkly subscribe and pass in any combination of the following arguments:
   • -p or --project=
   • -e or --environment=
   • -f or --flag_key=
   • -s or --status=
   • -a or --action=
   • -t or --tag=
3. Press Enter.

For example, the following command creates a subscription for all flags in the qa environment of the chatbot project, with status active and tag production:

$
/launchdarkly subscribe -p chatbot -e qa -s active -t production

Subscribe with positional arguments

You can use positional arguments to create a subscription for a single flag. You must provide all three arguments.

Here’s how:

1. Open the Slack channel you want notifications in.

• After you set up the Slack app, you can subscribe to notifications in any public Slack channel.
• If you want notifications in a private Slack channel, you must add the Slack app to the channel explicitly. Click the Integrations tab in the private channel. Then select Add app.

2. Run /launchdarkly subscribe and provide in order the project, environment, and flag key of the flag you would like to subscribe to.
3. Press Enter.

For example, the following command creates a subscription for the chat-response flag in the qa environment of the chatbot project:

$
/launchdarkly subscribe chatbot qa chat-response

Manage subscriptions

You can view and remove subscriptions in a Slack channel using the /launchdarkly list command:

1. Open the Slack channel where you would like to remove notifications.
2. Type /launchdarkly list and press Enter. A list of subscriptions for the channel appears.
3. Locate the subscription you wish to remove from the channel.
4. Click Remove.

Notification information

Flag notifications include the following information:

• The name of the person who made the change
• The name of the flag
• The environment, project, and key of the flag
• A comment about the change, if applicable

To display additional information about the flag change, click View details.

The table below explains the different subscription parameters:

Receive approval request notifications

If your organization uses release management tools and the Slack app, you receive a direct message in Slack when someone requests an approval from you, or when an approval request you made is approved, denied, or receives a comment.

You cannot interact with an approval from these notifications. They are indicators that you should log into LaunchDarkly and review your approval requests.

To learn more about approval requests, read Approvals.