Better Stack Connection
In this guide:
Introduction
In this guide, we’ll go over how to create the Better Stack Connection for BlinkMetrics. This will allow BlinkMetrics to pull data from Better Stack as a Source.
Authorizing Better Stack Connection
1. Go to the Connections Page
To create the Better Stack Connection, click on the Settings cog icon in the header > select the Connections menu item. This will open the Connections page. Next, click the Add Connection button.
2. Add Connection
From the Connection Stepper interface, select Better Stack in the Select Source tab. In the Set Up Credentials tab, you’ll see a few fields that we need to fill in. Open a new tab and go to the next step in the guide. Don’t close this tab, though; we’ll need to return to this BlinkMetrics page in Step 4 below.
3. Collect Better Stack API Token
To create a connection with BlinkMetrics, we’ll need to collect the API Token from your Better Stack account. Navigate the Better Stack account to copy the Personal Access Token:
- Select your Profile icon in the bottom-left corner > click on Settings menu item
- On the Settings page, click on the API Tokens list item in the sidebar
- Choose either the Global or Team-Based Tokens tab: Enter a Token name, click Create, and Copy the token
- In the case of Team-Based, select your team and Create the Uptime API Token
- In the case of Team-Based, select your team and Create the Uptime API Token
Global tokens can access all teams and solutions in Better Stack. The Team-based token allows you to limit the scope to a specific team and only the Uptime product.
Permissions Needed
Better Stack limits API token creation to Admins only. If you don’t see the option to generate API tokens, contact your Team admin.
- Admins: Create and View API Tokens
- Team Leads: View-Only API Tokens
- Other Roles: Cannot Create or View Tokens
Plan Needed
All of the Better Stack Subscription Plans have access to the API, including the free one.
4. Set Up Credentials in BlinkMetrics
Now that you’ve collected your API Token from Better Stack go back to the Set Up Credentials tab in BlinkMetrics:
- Paste in the Better Stack API Token to its respective field
- Enter a Connection Name; this is just for organizational purposes, and we recommend you provide details on which account it was connected to.
- Select the Privacy level for the connection (you can edit this later, too): Shared with Workspace, Private to Me, or Shared with Team.
When you’re done, click Finish.
5. Review Team Privacy and Save Connection
Once you complete the connection, you’ll be redirected back to the Better Stack Connections page. You can click the new listing to view the Connection detail page. From here, you can edit the following:
- Connection Name: Used for organizational purposes, each Source can have multiple Connections, so it’s helpful to see who authorized the Connection or which account it was connected to.
- API Token: If you need to update your Better Stack API Token, you can swap them here.
- Privacy: You can choose who it’s shared with: Shared with Workspace, Private to Me, or Shared with Team.
And that’s it! You can now use the Connection to pull data from the Better Stack Source. You’re done!
