skills.rest
netdata
netdataOFFICIAL
Explore all skills by this author →
WebsiteGitHub

query-netdata-agents

Query Netdata Agent HTTP APIs directly for metrics, logs, alerts, and streaming topology data.

80.4k|6.6k|Updated Jun 17, 2013
Search Tags:#logs#api#metrics#Automation#Netdata#Monitoring#Observability
One-click install
npx skills add https://github.com/netdata/netdata --skill query-netdata-agents
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: query-netdata-agents
Source: https://github.com/netdata/netdata/tree/main/docs/netdata-ai/skills/query-netdata-agents
Command: npx skills add https://github.com/netdata/netdata --skill query-netdata-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a secure, authenticated interface to interact directly with Netdata Agents, bypassing Cloud latency and enabling high-frequency data access for power users and automated monitoring workflows.

Core Features & Use Cases

  • Direct Agent API Access: Query metrics, logs, alerts, and configuration directly via port 19999.
  • Automated Auth Management: Automatically mints, caches, and refreshes per-agent bearer tokens from Netdata Cloud credentials.
  • Use Case: Use this Skill to perform high-frequency batch fetches of system metrics or to audit streaming replication progress across a fleet of parent-child nodes.

Quick Start

Use the query-netdata-agents skill to fetch the current firing alerts for the node identified by the provided UUID.

Frequently Asked Questions about query-netdata-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query a Netdata Agent directly?▼

Use the agents_query_agent wrapper to send authenticated requests to the Agent's HTTP API. The wrapper handles bearer token minting and caching automatically, ensuring secure access to protected endpoints.

When should I use direct-agent queries instead of Netdata Cloud?▼

Use direct-agent queries for lower-latency access, high-frequency batch fetches, or when Cloud connectivity is unavailable. Cloud-proxied queries remain the default for standard team-member access and fleet-wide aggregation.

Does this skill support bearer-protected agents?▼

Yes, the skill detects bearer-protected agents and uses your Netdata Cloud token to mint, cache, and refresh the required per-agent bearer token transparently.

How do I list available functions on an agent?▼

Query the agent's function endpoints with the info=true parameter to discover supported parameters and capabilities for specific functions like systemd-journal or netdata-streaming.

What are the limitations of direct-agent queries?▼

Direct-agent queries are limited to a single host. Fleet-wide aggregation, silencing rules, and certain alert-config management tasks are only available through the Netdata Cloud interface.

Related Skills

Explore More Software Engineering Skills→
netdatanetdata
1

netdata-mcp-integration

Query live Netdata metrics and alerts via MCP tools.

Official
Intermediate
b-open-iob-open-io
1

bot-health-monitor

Aggregate heartbeat, uptime, and health signals across bot fleets.

Official
Intermediate
tsuga-devtsuga-dev
2

tsuga-audit-monitor-coverage

Audit Tsuna monitor coverage and notification routing gaps across services and teams.

Official
Advanced
kubespherekubesphere
17.0k

whizard-notification

Automate centralized alert routing across multi-tenant Kubernetes clusters using WizTelemetry CRDs.

Official
Advanced