• TRIAGE
  • ANALYSIS
  • RECOVERY
  • HUMAN

How to troubleshoot upstream health with your AI

Connect Apache APISIX to your AI client to monitor backend status. Once connected, your agent can pull real-time health data to find why traffic is failing.

Ask AI about this page

Short answer

How do I troubleshoot upstream health with my AI?

Your AI pulls healthcheck data and upstream configurations from Apache APISIX to identify failing nodes. It compares active service endpoints against known healthy states to pinpoint exactly where traffic is dropping. You get a clear view of which backend nodes are down and why.

Troubleshooting outcomes

Where your health data lands.

The AI organizes its findings into these specific categories.

TRIAGE

Failed node identification

The AI uses healthcheck data to flag specific backend nodes that are unresponsive. You get a list of exactly which IPs or hostnames are failing.

ANALYSIS

Configuration mismatches

Your agent compares current upstream settings against the expected service structure. This reveals if a routing error is causing the failure.

RECOVERY

Actionable health reports

The AI summarizes the health status of all service endpoints. You receive a clean breakdown of healthy versus unhealthy targets.

HUMAN

Manual intervention needed

The AI identifies the root cause but cannot restart services or change your APISIX config. You decide when to trigger a manual failover.

The workflow

What your AI does when a failure occurs.

The AI moves from broad discovery to specific health inspection.

  1. Map the environment

    The AI starts by pulling a full list of all configured upstreams to understand your current topology.

    list_upstreams

  2. Inspect specific targets

    Once it finds a suspicious group, the AI pulls the detailed configuration for that specific upstream.

    get_upstream

  3. Check node status

    The AI runs healthchecks to see which specific backend nodes are currently passing or failing.

    get_control_healthcheck

  4. Verify resource health

    The agent looks deeper into the health of individual resources to confirm if the failure is localized.

    get_control_resource_healthcheck

Try it

Copy these to start.

Use these prompts to begin your investigation.

Starting points

Replace the bracketed text with your actual upstream names or service IDs.

Apache APISIX Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_uvuQ6vDEh3EK8RpcSSCqKlnF1NufI3SlkBIczBCN/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 — Apache APISIX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "apache-apisix-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_uvuQ6vDEh3EK8RpcSSCqKlnF1NufI3SlkBIczBCN/mcp"
    }
  }
}
Copy into chat04

  • List all my upstreams in Apache APISIX and tell me if any look misconfigured.

  • Check the health of the 'payment-service' upstream and tell me which nodes are down.

  • Show me the healthcheck status for all my current service endpoints.

  • I'm seeing traffic errors. Can you check the health of my upstreams and find the failing nodes?

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

Start here

Connect Apache APISIX once, then ask.

Just enter your credentials once. Your connection is secure, and your AI will immediately have access to your APISIX data.

Connect Apache APISIX to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix my broken upstreams?

    No. The AI can only read health data and configurations. You must manually apply any changes to your APISIX setup.

  • 02

    Does the AI change my routing rules?

    No. The tools provided are read-only. Your AI cannot modify, delete, or create any resources in Apache APISIX.

  • 03

    How often does the AI see health updates?

    The AI sees the health status as it exists in APISIX at the moment you ask the question.

  • 04

    Can I use this to monitor real-time traffic spikes?

    The AI can inspect the health of the nodes, but it does not provide a continuous real-time stream of traffic metrics.

  • 05

    What happens if an upstream has no healthcheck configured?

    The AI will report the status based on the available data, but it won't be able to perform a healthcheck if the feature isn't active in your APISIX config.

  • More questions about Apache APISIX? See everything the Apache APISIX Connector can do

Connect Apache APISIX to Claude, Cursor, ChatGPT & more