Skip to main content

Query Agent Events

Skill Verified Active

Bug-investigation tool for the Netdata agent-events ingestion namespace -- triage crashes, panics, fatals across the fleet by downloading events of interest and clustering locally. Covers the three transports (Cloud API and direct agent API are primary; ssh is operator-only), the verified AE_* field map and enum meanings, the dedup model (23h client-side per agent and event signature), the after-the-fact event timing (POST only on agent restart), and the Netdata systemd-journal plugin multi-value filter syntax (FIELD in A, B, C) AND ... Use when investigating crashes / panics / fatals; when grepping for events touching a specific function or file or version; when looking for regressions across versions; when an agent is reported crashing in a way you want to triage. Ships scripts get-events.sh and analyze-events.sh that fetch events with index-friendly filters and compute group-by stats. Defaults to last 24 hours and to the latest stable plus latest 2-3 nightlies.

Purpose

To enable efficient, in-depth investigation of Netdata agent crashes and critical events by providing specialized tools and documentation for slicing and analyzing event data.

Features

  • Triage crashes, panics, and fatals across Netdata fleet
  • Download events of interest and cluster locally
  • Support for Cloud API, direct agent API, and ssh transports
  • Index-friendly query patterns for efficient data slicing
  • Analysis scripts for grouping and identifying event patterns

Use Cases

  • Investigating agent crashes, panics, or fatals
  • Searching for events touching specific functions, files, or versions
  • Identifying regressions across agent versions
  • Analyzing agent stability issues reported by users

Non-Goals

  • Generic log querying across all namespaces
  • Real-time monitoring of active system performance
  • Modifying agent configurations or behavior

Installation

npx skills add netdata/netdata

Runs the Vercel skills CLI (skills.sh) via npx — needs Node.js locally and at least one installed skills-compatible agent (Claude Code, Cursor, Codex, …). Assumes the repo follows the agentskills.io format.

Quality Score

Verified
99 /100
Analyzed about 16 hours ago

Trust Signals

Last commitabout 16 hours ago
Stars78.8k
LicenseGPL-3.0
Status
View Source

Similar Extensions

Query Netdata Agents

99

Query Netdata Agents (parents and children) directly via their HTTP API on port 19999. Includes a bearer-token helper that mints, caches, and transparently refreshes a per-agent bearer from a long-lived Netdata Cloud token, and auto-detects bearer-protected agents. Use when the user asks how to call an agent's REST API or Function directly, query an agent's logs/metrics/alerts directly, mint a bearer token from a cloud token, or work around bearer protection.

Skill
netdata

Node Connect

100

Diagnose OpenClaw Android, iOS, or macOS node pairing, QR/setup code, route, auth, and connection failures.

Skill
steipete

Openclaw Debugging

100

Debug OpenClaw model, provider, tool-surface, code-mode, streaming, and live/Crabbox behavior by choosing the right logs, probes, and proof path before changing code.

Skill
steipete

Systematic Debugging

100

Systematic debugging methodology emphasizing root cause analysis over quick fixes

Skill
bobmatnyc

Troubleshooting

100

Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues. Trigger this skill when list_pages, new_page, or navigate_page fail, or when the server initialization fails.

Skill
ChromeDevTools

Query Netdata Cloud

100

Query Netdata Cloud via its REST API -- metrics, logs (systemd-journal / windows-events / otel-logs), topology graphs (topology:snmp), network flows (flows:netflow), alerts, dynamic configuration (DynCfg), and generic Functions on a node. Use when the user asks about querying Netdata Cloud, fetching metrics from the cloud, querying logs / topology / netflow / sflow / ipfix through Cloud, listing or modifying configurations via DynCfg, calling agent Functions through Cloud, listing spaces/rooms/nodes, or building a curl command against `app.netdata.cloud`. Pairs with the `query-netdata-agents` skill when direct-agent access is needed.

Skill
netdata

© 2025 SkillRepo · Find the right skill, skip the noise.