Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Sign up for Better Stack: Create a free account at https://betterstack.com and add at least one uptime monitor or heartbeat so the API returns data.
  2. Create an API token: In Better Stack go to API tokens. Use a global API token, or create a team-scoped token in the ‘Uptime API tokens’ section.
  3. Set the environment variable: Add the token to your .env as BETTERSTACK_API_TOKEN=…
  4. Verify access: Run List Monitors.
  • This connector covers the Uptime API (uptime.betterstack.com) only - the Telemetry/Logs API uses a different token and host and is not included
  • Responses follow JSON:API: items are under data[] with attributes, pagination links under pagination
  • Incidents use the newer /api/v3 path; monitors and heartbeats use /api/v2
Provider API reference: https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/

Tools

Example prompts

  • List my Better Stack monitors and flag any that are not in the ‘up’ status, plus any unresolved incidents.
  • Get the availability summary for my main Better Stack monitor over the last 30 days.