• CPU
  • MEMORY
  • DISK
  • HUMAN

How to debug system performance bottlenecks with your AI

Connect Netdata to your AI client to turn raw system metrics into clear troubleshooting steps.

Ask AI about this page

Short answer

How do I debug system performance bottlenecks with my AI?

Your AI pulls granular Netdata metrics and chart data to find the exact resource causing your system slowdowns. It compares these data points to pinpoint where your resources are hitting a ceiling. You get a clear breakdown of the culprit behind the lag.

Where the data leads.

The outcomes of your analysis.

The AI categorizes findings based on which specific resource is being exhausted.

CPU

Processor saturation

The AI identifies high load averages or specific process spikes. You get the exact metric causing the queue.

MEMORY

RAM exhaustion

It detects memory leaks or swap usage spikes. You'll see if your application is hitting physical limits.

DISK

Storage bottlenecks

The AI checks I/O wait times and disk throughput. It finds if your storage speed is throttling the system.

HUMAN

Manual intervention

The AI flags issues it can't fix, like hardware failure or misconfigured kernel parameters. You decide how to patch the system.

The workflow

What your AI does when the bottleneck arrives.

The AI moves from broad system visibility to deep metric analysis.

  1. Scan available data

    The AI looks at the available monitoring points to see what data is being collected.

    list_charts

  2. Pull specific metrics

    It gathers the raw numbers for the specific subsystem you are worried about.

    get_all_metrics

  3. Analyze trends

    The AI pulls historical data points to see if the spike is a momentary blip or a sustained trend.

    get_chart_data

  4. Isolate the cause

    By comparing different metric sets, the AI identifies the primary constraint.

    get_chart_data

Try it

Copy these to start.

Use these prompts to begin your investigation.

Starting points

Swap the bracketed text for your actual server names or specific metric types.

Netdata Connector

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

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

  • Check the CPU and memory charts for my production server to see why it's lagging.

  • Look at the disk I/O metrics for the database node and tell me if there's a bottleneck.

  • Analyze the recent spikes in network traffic on the web-gateway instance.

  • Find all available metrics for the monitoring agent to see what we can track.

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

Start here

Connect Netdata once, then ask.

You only need to link your Netdata instance once. Your credentials stay encrypted, and you can immediately start asking your AI about your system health.

Connect Netdata to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix the performance issues it finds?

    No. The AI only reads and analyzes the data. You have to manually apply the fixes to your system.

  • 02

    Can the AI delete any of my Netdata data?

    No. The tools only allow the AI to read metrics and chart information. It has no permission to delete or modify your data.

  • 03

    How granular is the data the AI sees?

    The AI sees whatever granularity is configured in your Netdata instance, from per-second metrics to long-term trends.

  • 04

    Does the AI see my entire infrastructure?

    The AI only sees the data provided by the Netdata instance you have connected.

  • 05

    Can the AI create new charts in Netdata?

    No. The AI can only list existing charts and pull data from them.

  • More questions about Netdata? See everything the Netdata Connector can do

Connect Netdata to Claude, Cursor, ChatGPT & more