---
title: "Better Stack integration for LuumenAI"
url: "https://www.luumen.ai/integrations/better-stack/"
entity: SoftwareIntegration
category: "Incident response"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Better Stack integration for LuumenAI

Read monitors, heartbeats, and on-call state; file incidents after you approve

## What LuumenAI can do with Better Stack

LuumenAI connects to Better Stack with an API token and exposes 117 tools (59 read-only · 40 write · 18 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 117 tools (59 read-only · 40 write · 18 destructive)
- Plan: available on all plans
- Category: Incident response

## About Better Stack with LuumenAI

Connect Better Stack and Luumen can read your monitors, heartbeat checks, availability summaries, response times, escalation policies, and on-call schedules while you work in the terminal. Changes like creating an incident, adding a comment, or acknowledging an alert are previewed first and, by default, wait for your approval.

## Example tools

Read-only (59 in total):

- `BETTER_STACK_GET_ESCALATION_POLICY` — Get a single escalation policy by its ID.
- `BETTER_STACK_GET_HEARTBEAT` — Get a single heartbeat by ID.
- `BETTER_STACK_GET_HEARTBEAT_AVAILABILITY` — Retrieve availability summary for a specific heartbeat.
- `BETTER_STACK_GET_HEARTBEAT_GROUP` — Get a single heartbeat group by ID.
- `BETTER_STACK_GET_INCIDENT_COMMENT` — Get a single comment from an incident.
- `BETTER_STACK_GET_MONITOR` — Get a single monitor.
- `BETTER_STACK_GET_MONITOR_AVAILABILITY` — Return an availability summary for a specific monitor.
- `BETTER_STACK_GET_MONITOR_GROUPS` — Get a single monitor group by ID.

Write and destructive (58 in total, approval required by default):

- `BETTER_STACK_ACKNOWLEDGE_INCIDENT` — Acknowledge an ongoing incident.
- `BETTER_STACK_CREATE_ESCALATION_POLICY` — Creates a new escalation policy for incident management.
- `BETTER_STACK_CREATE_HEARTBEAT` — Create a new heartbeat monitor for cron jobs and scheduled tasks.
- `BETTER_STACK_CREATE_HEARTBEAT_GROUP` — Create a new heartbeat group.
- `BETTER_STACK_CREATE_INCIDENT` — Create a new incident and alert the on-call person.
- `BETTER_STACK_CREATE_INCIDENT_COMMENT` — Create a new comment on an incident.
- `BETTER_STACK_CREATE_METADATA` — Create or update a metadata record for a resource.
- `BETTER_STACK_CREATE_MONITOR` — Create a new uptime monitor for a URL or service.

## Frequently asked questions

### How does LuumenAI connect to Better Stack?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Better Stack on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 18 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Better Stack — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/better-stack/