> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superlog.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Better Stack

> Connect Better Stack so automations can read incidents, monitors, logs, and errors, and start when an incident begins.

Better Stack starts automations when an incident starts, and gives automations its incidents, monitors, on-call schedules, logs, metrics, and errors.

## Connect Better Stack

**1. Create a token**

In Better Stack, open [API tokens](https://betterstack.com/settings/global-api-tokens) and create a token under **Global API tokens**. Read-only access is enough for investigations.

**2. Connect**

In Superlog, open **Integrations** and click **Add** on Better Stack. Paste the **API token** and click **Connect Better Stack**.

## Start automations from incidents

**1. Add the trigger**

In the automation editor, click **Add trigger** and choose **Better Stack → Incident started**. Click **Set up Better Stack webhook**.

**2. Add the webhook**

In Better Stack, open **Integrations → Exporting data** and add an **Incident webhook** under outgoing webhooks. Use the webhook URL from Superlog and turn on the **Incident started** event.

**3. Set authentication**

Set basic authentication to the username and password from Superlog. Keep the default request body.

Each new incident starts the automation once. Acknowledged and resolved incidents are ignored.

## Limits

* What automations can do is limited to the permissions on your token.
* Findings do not read Better Stack.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.