跳转到主要内容
此内容尚未提供您的语言版本,正在以英文显示。

Query Netdata Agents

技能 已验证 活跃

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.

目的

To enable users to directly query Netdata Agents via their HTTP API, including managing authentication for bearer-protected agents, for detailed troubleshooting and data retrieval.

功能

  • Directly query Netdata Agent HTTP APIs
  • Mint, cache, refresh, and use per-agent bearer tokens
  • Auto-detect bearer-protected agents
  • Query agent logs, metrics, and configuration
  • Provide token-safe wrappers for secure credential handling

使用场景

  • When needing to call an agent's REST API or Function directly
  • When querying an agent's logs/metrics/alerts directly
  • When minting a bearer token from a cloud token
  • When working around bearer protection issues on an agent

非目标

  • Querying Netdata Cloud for aggregated fleet-wide data (use sibling skill)
  • Replacing the need for Netdata Agent installation
  • Providing a full Netdata Cloud UI replacement

工作流

  1. Load environment variables from .env file
  2. Resolve agent claim ID (if needed)
  3. Resolve per-agent bearer token (minting/caching/refreshing via Cloud if necessary)
  4. Construct and execute direct agent API call using wrapped curl
  5. Mask sensitive credentials in stderr logs
  6. Return API response body to stdout

实践

  • API Interaction
  • Authentication Management
  • Data Querying
  • Security Best Practices

先决条件

  • Netdata Cloud REST token
  • Netdata Cloud hostname
  • Agent node ID, machine GUID, and claim ID (for bearer minting)
  • Network access to the agent on port 19999

安装

npx skills add netdata/netdata

通过 npx 运行 Vercel skills CLI(skills.sh)— 需要本地安装 Node.js,以及至少一个兼容 skills 的智能体(Claude Code、Cursor、Codex 等)。前提是仓库遵循 agentskills.io 格式。

质量评分

已验证
99 /100
1 day ago 分析

信任信号

最近提交1 day ago
GitHub 所有者 netdata (opens in new tab)
星标78.8k
许可证GPL-3.0-or-later
网站netdata.cloud(opens in new tab)
状态
查看源代码

类似扩展

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.

技能
netdata

Azure Monitor Query Py

100

Azure Monitor Query SDK for Python. Use for querying Log Analytics workspaces and Azure Monitor metrics. Triggers: "azure-monitor-query", "LogsQueryClient", "MetricsQueryClient", "Log Analytics", "Kusto queries", "Azure metrics".

技能
microsoft

Query Agent Events

99

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.

技能
netdata

Observability Gap Hunt

98

Inspects services, jobs, and code paths for missing or weak logs, metrics, traces, alerts, dashboards, or deployment-linked telemetry, then returns a tightly scoped backlog of observability gaps. Use when a user says `find observability gaps`, `audit telemetry coverage`, `what logs or metrics are missing`, `check alerting coverage`, or asks for a recurring telemetry review. Do NOT use for live incident response, root-cause analysis, generic performance tuning, or a broad code review.

技能
ckorhonen

X Twitter Scraper

100

当用户需要通过 Xquik 获取 X (Twitter) 数据或执行需要确认的 X 操作时使用：推文搜索、用户查找、关注者提取、媒体下载、监控、Webhook、MCP、SDK、发布、点赞、私信和个人资料更新。需要 Xquik API 密钥。切勿索要 X 登录凭据。

技能
Xquik-dev

Slack

100

Use the Slack tool to react, pin/unpin, send, edit, delete messages, or fetch Slack member info.

技能
steipete