COLLECTOR
夜莺在你已有的数据上做告警分析，Categraf 负责把数据送进来：一个 agent 覆盖操作系统、中间件、数据库、网络设备与 Kubernetes，按 Prometheus Remote Write 协议推送。MIT 协议开源，与夜莺出自同一个团队。
发布包按平台分开，且已经把 conf 目录打进去了，解压即可运行。Linux 提供 amd64 与 arm64，Windows 为 zip 包。默认构建之外还有两个变体：-with-cgo-plugin 额外带 NVIDIA DCGM 采集，categraf-slim 只保留指标采集。
tar xzf categraf-v<版本号>-linux-amd64.tar.gzcd categraf-v<版本号>-linux-amd64版本号是文件名的一部分，因此没有固定的 latest 下载地址，需要到发布页挑对应构建。
GitHub Releases →镜像里二进制在 /usr/bin/categraf，示例配置在 /etc/categraf/conf。设置 N9E_HOST 后，entrypoint 会自动改写 config.toml 里的服务端地址；需要更多定制时再挂载自己的 conf 目录。
docker pull flashcatcloud/categraf:latestdocker run -d --name categraf -e N9E_HOST=192.168.1.10:17000 flashcatcloud/categraf:latest需要 Go 1.25 及以上。打包时把二进制和 conf 一起打，agent 才有配套的示例配置。
go buildtar zcvf categraf.tar.gz categraf confmacOS 上要用 gnu-tar（gtar）：系统自带的 bsdtar 打出来的包 Categraf 会加载失败。
test 模式把采集结果直接打到标准输出，可以在接服务端之前先确认插件是否正常。
./categraf --test./categraf --test --inputs system:mem配置都在 conf 目录：config.toml 管 agent 自身，每个采集器一个 input.<插件名> 目录。用 --inputs 可以只跑指定插件。
./categraf./categraf --configs /path/to/conf-directory./categraf --inputs system:mem接入夜莺、给主机打标签、没数据时怎么查，文档里有逐步的说明。
Categraf 使用文档 →DaemonSet 采节点与 cAdvisor 指标，Deployment 采 apiserver、CoreDNS 这类集群级目标，sidecar 采单个服务。三份编排文件仓库里都有。
kubectl apply -n monitoring -f k8s/daemonset.yamlkubectl apply -n monitoring -f k8s/deployment.yamlkubectl apply -n monitoring -f k8s/sidecar.yaml每个插件是 inputs/ 下的一个目录，各自带一份示例配置。以下为部分：
操作系统
数据库
中间件
Web 与应用服务器
容器与 Kubernetes
网络设备与硬件
GPU
云
拨测
通用
Categraf 走 Prometheus Remote Write 协议推送，因此可以写入夜莺、Prometheus、VictoriaMetrics 等任何支持该协议的后端。PUSH 意味着由 agent 主动建立连接——在网络策略不允许中心端反向访问各网段时，这一点很关键。
接成夜莺的数据源 →夜莺不绑定 Categraf。Telegraf、Datadog Agent 以及标准的 Prometheus exporter 都以同样方式写入；已经在抓取目标的 Prometheus 也可以原样保留。
Categraf 源码与发布 →