How to set up Slack

This guide will provide step-by-step instructions on how to set up a Webhook in Slack, enabling you to easily view Fabric Metrics and Events. You can use the Slack Webhook URI Details in the following POST fabric/v4/streamSubscriptions request

curl -X POST
'https://api.equinix.com/fabric/v4/streamSubscriptions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <bearer_token>' \
--data '{
"type": "STREAM_SUBSCRIPTION",
"name": "<slack_subscription_name>",
"description": "<slack_subscription_desc>",
"stream": {
"uuid": "<stream_id>"
},
"sink": {
"uri": "<slack_webhook_uri>",
"type": "SLACK"
}
}'

Step-by-Step Instructions 

1. Create a Channel in Slack 

• To begin, log in to your Slack Workspace and follow the instructions in the Slack documentation to create a new channel (Refer to Slack Doc Create a channel ).

2. Create a Slack App for Incoming Webhooks

• On Slack’s App Page, click on Create New App option as described in the Slack documentation to create an Incoming Webhook App (Refer to Slack Doc Sending messages using incoming webhooks).
• In the Create an App Modal, select the From Scratch option and provide the necessary details for the app.

2.1 Name the App

• App Name: Enter a name for the incoming Webhook App.

2.2 Pick a workspace to develop your app in

• Workspace: Select the Slack Workspace for the Incoming Webhook App.

3. Enable the Configuration for the Incoming Webhooks

• Enable Incoming Webhooks Configuration for the Slack App that you have created.

3.1 Navigate to the Incoming Webhooks

• After creating an app, you are redirected to Basic Information Under the setting section.
• Navigate to Incoming Webhooks under the Feature Section on the left navigation.

3.2 Configure the Incoming Webhooks

• Toggle on Active Incoming Webhooks
• Select Add New Webhook to Workspace
• Select the channel to enable the Incoming Webhooks then click allow.

4. Save the Slack Webhook URL

• Ensure that URL generated during this process are saved securely. The URL is required for further integration or data ingestion processes.

4.1 Copy the Webook URL

• Once the setup is complete, a URL value will be generated.
• Copy this URL to your clipboard, as it will be needed later for the POST streamSubscription API in Stream Observability.

4.2 Star receiving Fabric events and metrics in the Slack Channel