• STATUS
  • DETAILS
  • REPORT
  • HUMAN

How to debug cron heartbeats with your AI

Connect Better Stack to your AI client once. After that, your agent can pull real-time status updates on your background tasks.

Ask AI about this page

Short answer

How can I use my AI to debug cron heartbeats?

Your agent pulls the current status of all heartbeats and then inspects the specific details of the failing node. This lets you pinpoint the exact moment a process stopped reporting. You'll get a clear view of which specific tasks are down and why.

Where your debugging efforts land.

Identify the source of failure.

The AI sorts heartbeat data into these actionable outcomes.

STATUS

Identify dead nodes

The AI scans all active heartbeats to find which ones haven't checked in. You get a list of exactly which processes are offline.

DETAILS

Inspect failure reasons

Your agent pulls deep data on a specific heartbeat. This shows you the last successful check-in and the specific error state.

REPORT

Summarize uptime

The AI aggregates heartbeat history to show you patterns in your background tasks. You'll see if a specific job fails every Tuesday at 4 AM.

HUMAN

Manual intervention

The AI flags critical failures that require you to jump into your terminal or server. It tells you which node needs your direct attention.

The workflow

What your AI does when a heartbeat fails.

The AI handles the data retrieval so you can focus on the fix.

  1. Scan all heartbeats

    The AI looks through your Better Stack account to find all registered heartbeats and their current health status.

    list_heartbeats

  2. Isolate the failure

    Once it finds a missing heartbeat, the AI pulls the specific metadata for that individual node.

    get_heartbeat

  3. Analyze the gap

    The AI compares the last successful check-in time against the expected interval to confirm a timeout.

    get_heartbeat

  4. Report the culprit

    The AI presents you with a clear summary of which specific task is failing and when it last worked.

    list_heartbeats

Try it

Copy these to start.

Use these prompts to begin your investigation.

Starting points

These are opening lines. Swap out the specific service names or heartbeat IDs to match your setup.

Better Stack Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_xq7kQqt3rPeZjz6W7YzsnYg5qqlmUHoAnFRvYBQj/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Better Stack capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "better-stack-1-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_xq7kQqt3rPeZjz6W7YzsnYg5qqlmUHoAnFRvYBQj/mcp"
    }
  }
}
Copy into chat04

  • List all my Better Stack heartbeats and tell me which ones are currently down.

  • Get the details for the heartbeat named 'production-db-sync' and tell me why it failed.

  • Check the status of all heartbeats and summarize any recent intermittent failures.

  • Find the heartbeat with ID 'hb_12345' and tell me the timestamp of its last successful check-in.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Better Stack once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can start debugging immediately in your preferred AI client.

Connect Better Stack to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix the broken cron job for me?

    No. The AI can only read heartbeat data to tell you what happened. You have to log into your server to fix the actual code or process.

  • 02

    Can the AI create new heartbeats in Better Stack?

    No. This MCP is designed for monitoring and debugging existing heartbeats using the available read tools.

  • 03

    Does the AI see my Better Stack API key?

    No. Your credentials are encrypted and managed by Vinkius. The AI only interacts with the data through the provided tools.

  • 04

    Can the AI delete a heartbeat if it's no longer needed?

    No. There are no tools provided to delete or modify heartbeat configurations.

  • 05

    How often does the AI check the status?

    The AI only checks the status when you ask it a question. It does not monitor your heartbeats in the background on its own.

  • More questions about Better Stack? See everything the Better Stack Connector can do

Connect Better Stack to Claude, Cursor, ChatGPT & more