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

# Better Stack

> Monitor logs, incidents, and uptime with Better Stack — track reliability, manage alerts, and resolve issues from Mantle

Connect your Better Stack API key and let your AI agents monitor uptime, track incidents, search logs, and manage status
pages — keeping your team on top of reliability without leaving Mantle.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Uptime monitoring" icon="signal">
    List monitors, check availability, view response times, and manage heartbeats from chat.
  </Card>

  <Card title="Incident management" icon="triangle-exclamation">
    Create, acknowledge, escalate, and resolve incidents. Add comments and track timelines.
  </Card>

  <Card title="On-call scheduling" icon="clock">
    View on-call schedules, manage escalation policies, and check who's currently on call.
  </Card>

  <Card title="Status pages" icon="browser">
    Manage status pages, publish incident reports, and keep your users informed about service health.
  </Card>
</CardGroup>

***

## Connect Better Stack

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Better Stack**.
  </Step>

  <Step title="Get your API key">
    Log in at [betterstack.com](https://betterstack.com), go to your account settings, and copy your API token.
  </Step>

  <Step title="Paste and connect">Paste the key into the **API Key** field and click **Connect**.</Step>
</Steps>

***

## Agent tools

Add Better Stack tools to agents that need them. Their access is limited by the connected key and selected tools.

### Monitors & Heartbeats

| Tool               | Description                               |
| ------------------ | ----------------------------------------- |
| List monitors      | List all uptime monitors                  |
| Get monitor        | Retrieve details of a specific monitor    |
| Create monitor     | Create a new uptime monitor               |
| Get availability   | Check a monitor's availability percentage |
| Get response times | View response time data for a monitor     |
| List heartbeats    | List all heartbeat monitors               |
| Get heartbeat      | Check the status of a heartbeat monitor   |

### Incidents

| Tool                 | Description                                |
| -------------------- | ------------------------------------------ |
| List incidents       | List all incidents with status filters     |
| Create incident      | Create a new incident manually             |
| Acknowledge incident | Mark an incident as acknowledged           |
| Resolve incident     | Resolve an open incident                   |
| Escalate incident    | Escalate an incident to the next responder |
| Add incident comment | Post a comment on an incident timeline     |

### On-Call & Escalation

| Tool                     | Description                             |
| ------------------------ | --------------------------------------- |
| List on-call schedules   | View all on-call schedules              |
| Get on-call schedule     | Retrieve details of a specific schedule |
| List escalation policies | View all escalation policies            |
| Get escalation policy    | Retrieve details of a specific policy   |

### Status Pages

| Tool                 | Description                                 |
| -------------------- | ------------------------------------------- |
| List status pages    | List all status pages                       |
| Get status page      | Retrieve status page details and resources  |
| Create status report | Publish an incident report on a status page |
| Create status update | Add a status update to an existing report   |

***

## Triggers

<Note>
  Automated triggers for Better Stack are not yet available. Triggers will be added in a future update — check back
  soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Quick uptime check from chat">
    Ask "Is our API up?" and the agent checks the relevant monitors, returns availability percentages and response
    times, and flags any active incidents.
  </Accordion>

  <Accordion title="Incident response from Mantle">
    When an alert fires, use your agent to acknowledge the incident, post an update to the status page, and escalate to
    the on-call engineer — all from a single chat conversation.
  </Accordion>

  <Accordion title="Weekly reliability report">
    An agent fetches uptime percentages, incident counts, and mean time to resolution for the past week, then posts a
    formatted summary to your #engineering channel.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="My API key isn't working">
    Verify the token was copied from your Better Stack account settings. Make sure the token has access to both the
    Uptime and Logs products if you need both.
  </Accordion>

  <Accordion title="Monitors not showing up">
    Check that the API token belongs to the team that owns the monitors. Better Stack API tokens are scoped to a
    specific team — monitors from other teams won't appear.
  </Accordion>

  <Accordion title="Incident actions fail">
    Some incident actions (acknowledge, resolve, escalate) require specific permissions. Verify the API token has write
    access and the incident is in a state that allows the action.
  </Accordion>

  <Accordion title="Status page updates aren't visible">
    Updates may take a moment to propagate to your public status page. Verify the status page is published and the
    report is associated with the correct status page.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>