categraf-deploy-guide

categraf-deploy-guide is a skill for Claude Code, Codex from ccfos/nightingale. It costs 132 tokens per session (2,908 once invoked), scanned D, original, Apache-2.0.

A deployment guide for Categraf, a data collector that gathers machine metrics and sends them to Nightingale. It covers installing the collector, configuring its destination, starting it, and checking that data arrives.

In plain words
What is it for?
Deploying Categraf on Linux, Windows, Docker, or Kubernetes, registering it as a service, configuring its writer address, and verifying collection.
Why use it?
It provides a clear path from obtaining Categraf to connecting a machine to Nightingale without mixing deployment with later diagnosis or plugin configuration.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /home/flashcat/categraf/conf/:/etc/categraf/conf.

About the project

Nightingale is an open-source monitoring and alerting system that connects to stored metrics and log data, evaluates alert rules, and distributes notifications. Operations teams use it to manage alarms and explore observability data alongside existing data sources and collectors. Catalogue add-ons provide skills for operating Nightingale.

ccfos/nightingale · 13,280 stars · on GitHub · n9e.github.io

Install

Getting it into your agent

There is no command for this one: it runs only inside a plugin, and the catalogue could not identify which plugin ships it. The source is linked below.

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for categraf-deploy-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/ccfos/nightingale/categraf-deploy-guide.svg)](https://agentmods.dev/skills/ccfos/nightingale/categraf-deploy-guide)
Your own site
<a href="https://agentmods.dev/skills/ccfos/nightingale/categraf-deploy-guide"><img src="https://agentmods.dev/badge/skills/ccfos/nightingale/categraf-deploy-guide.svg" alt="Measured on agentmods" height="20"></a>
Per session 132 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,908 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 3 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00132 $0.02908
Opus 5 $0.00066 $0.01454
Sonnet 5 $0.00026 $0.00582
Haiku 4.5 $0.00013 $0.00291

Measured 6d ago against content hash 8068cc1c524b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade D, and why

categraf-deploy-guide scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

curl -sSfL 'http://N9E_HOST:17000/api/n9e/agents/categraf/install.sh' | sudo bash -s -- --server 'http://N9E_HOST:17000'

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -sSfL 'http://N9E_HOST:17000/api/n9e/agents/categraf/install.sh' | sudo bash -s -- --server 'http://N9E_HOST:17000'

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sSfL 'http://N9E_HOST:17000/api/n9e/agents/categraf/install.sh' | sudo bash -s -- --server 'http://N9E_HOST:17000'
aiagent/skill/embedded/builtin/categraf-deploy-guide/SKILL.md · 251 lines

How it starts

The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Categraf Deployment Guide

Scope

Enter this skill:

  • "how to install / how to deploy / how to start categraf"
  • "run categraf on Docker / Kubernetes / Windows / Linux"
  • "how to register categraf as a systemd service / start on boot"
  • "report categraf to Nightingale / how to write config.toml / what to put in the writer URL"
  • "how to verify that categraf is collecting data"
  • "categraf is installed but Nightingale can't see the machine" → do not enter this skill, route to host-onboard-diagnose

Do not enter this skill:

  • Diagnosing onboarding failures after install → host-onboard-diagnose
  • Abnormal metrics after onboarding → host-health-diagnose
  • Configuring collection for a specific input plugin (mysql / redis / nginx / snmp, etc.) → guide the user to read the comments under conf/input.<name>/; this skill only covers "get it installed + get it connected"

One-Sentence Principle

categraf deployment = three actions: get the binary → correctly write the [[writers]] section of config.toml → start it and verify. Everything else is a variant of these three steps (containerization, systemd management, Windows service, etc.).

Deployment Methods Quick Reference

Scenario Recommended method Notes
Linux physical machine / VM binary + systemd v0.3.35+ has a built-in --install one-liner to register
Linux but no root binary + --user --install supported in v0.4.5+
Container / orchestration environment Docker or K8s DaemonSet collecting host metrics requires mounting /proc /sys
Windows categraf.exe --win-service-install or run in the background with win_run.bat
macOS (development/debugging) run the binary directly not recommended for production

Operating system support: Linux kernel 2.6.32+ / Windows 10+ or Server 2008+ / macOS 10.15+.

Quickest Path: One-Click Install

If the nightingale server is v9+ and bundles categraf, a single command on the target host does everything below (download, unpack, rewrite the reporting address, register and start the systemd service):

Read the full file on GitHub · 251 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 251 lines · 132 tokens per session scan D 8068cc1c524b

Subscribe to this mod's changes

categraf-deploy-guide is a skill published in the GitHub repository ccfos/nightingale (13,280 stars, last pushed yesterday), licensed Apache-2.0. It adds 132 tokens to every session and 2,908 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.