Categraf

Categraf 是一款 All-in-One 的数据采集器，支持指标、日志采集；支持物理机、虚拟机、交换机、容器、K8s、多种中间件/数据库的数据采集，支持混合云架构、云原生架构、多云架构。同时，Categraf 期望不止提供采集能力，还附带提供仪表盘和告警规则，力求开箱即用。

搜索 Categraf

相关话题 IT监控故障定位告警OnCall SRE 用户案例 Prometheus VictoriaMetrics 夜莺监控

Topic Overview

Categraf 这个话题主要看什么

49 已收录内容

1 人工精选

46 自动聚合

2 补充阅读

Categraf 相关文章

围绕 Categraf 的实践、选型、案例和产品内容，按同一阅读路径持续整理。

49 篇

Categraf 总体介绍

2024-09-20

Categraf 是快猫团队开源的一款采集器，All-in-one 的设计，既可以采集指标，也可以采集日志、链路数据

Categraf SNMPv3 与批量设备配置实践：认证加密、多设备标签和采集规模控制

快猫星云 · 2026-08-12

本文介绍如何在 Categraf 中配置 SNMPv3 和批量网络设备采集，覆盖 SNMPv2c 与 SNMPv3 选择、认证加密参数、多 agents 分组、mappings 标签、超时重试、GETBULK、健康检查和大规模采集建议。

Categraf SNMP 硬件与厂商私有 OID 监控：风扇、电源、温度、CPU 和内存

快猫星云 · 2026-08-12

本文介绍如何用 Categraf SNMP 插件采集网络设备硬件和厂商私有 OID，覆盖 ENTITY-MIB、ENTITY-SENSOR-MIB、风扇、电源、温度、CPU、内存、snmpwalk 验证、convert_rule、状态枚举和告警语义。

Categraf SNMP 采集排障指南：snmpwalk、MIB、超时、权限和 Dashboard 无数据

快猫星云 · 2026-08-12

本文整理 Categraf SNMP 采集的完整排障流程，覆盖 snmpwalk 验证、community 和 SNMPv3 权限、UDP 超时、设备 ACL、OID 不存在、MIB 解析、表字段失败、partial 结果、remote write 和 Dashboard 无数据。

Categraf SNMP 表格采集进阶：table、field、标签继承、过滤和 partial 策略

快猫星云 · 2026-08-12

本文深入介绍 Categraf SNMP 插件的表格采集模型，讲清 table、field、is_tag、inherit_tags、index_as_tag、filters、filters_expression、filters_mode、partial 错误策略、依赖缓存和运行时采集统计。

Categraf SNMP 交换机接口监控实战：端口流量、状态、错包和部分采集

快猫星云 · 2026-07-28

本文介绍如何使用 Categraf SNMP 插件监控交换机和路由器接口，覆盖 SNMP 连通性验证、IF-MIB 核心 OID、端口流量、带宽利用率、端口状态、错包丢包、端口过滤、partial 表格采集和告警建议。

Categraf 升级与回滚实践：配置备份、灰度验证和版本兼容

快猫星云 · 2026-07-21

本文介绍 Categraf 生产升级与回滚流程，覆盖版本盘点、二进制和配置备份、配置差异审查、灰度节点、--test 验证、systemd 重启、后端指标验收、失败回滚和变更记录。

Categraf 使用 systemd 和容器部署的常见坑

快猫星云 · 2026-07-21

本文介绍 Categraf 在 systemd 和容器部署中的常见问题，覆盖 --install、ExecStart、WorkingDirectory、EnvironmentFile、配置挂载、容器内 127.0.0.1、权限、重启策略、日志持久化和部署验收。

Categraf 多实例配置与标签设计：如何避免实例混淆和高基数

快猫星云 · 2026-07-21

本文介绍 Categraf 多实例采集时如何设计稳定标签，覆盖多个 [[instances]]、实例级 labels、global.labels、agent_hostname、ident、instance、server、outputaddress、Dashboard 变量和高基数控制。

Categraf Dashboard 没有数据：数据源、变量、标签和 PromQL 排查

快猫星云 · 2026-07-20

本文介绍 Categraf 指标已写入后端、但夜莺或 Grafana Dashboard 没有数据时的完整排查方法，覆盖 Dashboard 文件选择、数据源、时间范围、变量、实际标签、PromQL、采集周期、版本兼容和面板变换。

Categraf 已采到指标但后端查不到：remote write 链路排查

快猫星云 · 2026-07-20

本文介绍 Categraf 使用 test 模式确认采集、再用 debug 或正式模式验证写入，但夜莺、VictoriaMetrics 或 Prometheus 兼容后端仍查不到数据时的完整排查方法，覆盖运行模式、writer、标签转换、内存队列、HTTP、认证、TLS、时间偏差、租户和查询端点。

Categraf 插件没有指标：从 test 模式到数据库权限的完整排查

快猫星云 · 2026-07-20

本文给出 Categraf 进程正常但单个 input 没有指标时的完整排查路径，覆盖插件目录、instances、--inputs、test 模式、采集周期、网络、认证、TLS、运行用户、数据库权限和指标过滤。

Categraf 启动失败排查：TOML、配置路径、权限和 systemd 常见错误

快猫星云 · 2026-07-17

本文从 Categraf 当前源码和 Linux 部署流程出发，给出启动失败的完整排查顺序，覆盖配置目录、TOML 语法与编码、文件权限、systemd 服务、二进制架构、版本兼容、端口冲突和日志定位。

Categraf 配置文件结构详解：global、writer、heartbeat、inputs 与四类 Agent

快猫星云 · 2026-07-17

本文从源码和实际目录结构出发，讲清楚 Categraf 的配置目录、global、writer、heartbeat、input 插件，以及 Metrics、Prometheus、Logs、Ibex 四类 Agent 的配置与数据链路。

Categraf PostgreSQL 监控实战：连接、事务、缓存、锁和慢查询指标

快猫星云 · 2026-07-16

本文介绍如何使用 Categraf 采集 PostgreSQL 指标，包括监控账号、实例配置、事务与缓存指标、锁等待自定义 SQL、pg_stat_statements、夜莺和 Grafana Dashboard，以及告警建议。

Categraf MongoDB 监控实战：单节点、副本集、分片集群的采集配置和大盘

快猫星云 · 2026-07-09

本文介绍如何使用 Categraf 采集 MongoDB 指标，覆盖单节点、副本集、mongos、config server、shard server、认证权限、核心指标、Dashboard 和告警建议。

MongoDB Docker 测试环境搭建：单节点、副本集和分片集群

快猫星云 · 2026-07-09

本文记录如何用 Docker Compose 搭建用于 Categraf MongoDB 监控验证的测试环境，覆盖单节点、三节点副本集、config server、shard replica set、mongos、认证账号和测试数据。

Categraf DNS 查询监控实战：解析结果、非预期 IP、解析耗时和可用性

快猫星云 · 2026-07-09

本文介绍如何使用 Categraf dns_query 插件做 DNS 查询质量监控，包括 DNS 服务器配置、域名解析探测、非预期 IP 校验、结果码、响应码、解析耗时、Dashboard 和告警建议。

Categraf TCP/UDP 网络探测实战：端口连通性、响应时间和告警

快猫星云 · 2026-07-03

本文介绍如何使用 Categraf net_response 插件做 TCP/UDP 网络探测，包括端口连通性、响应匹配、结果码、响应时间、Dashboard 和告警建议。

Categraf HTTP 响应监控实战：可用性、状态码、延迟和证书

快猫星云 · 2026-07-03

本文介绍如何使用 Categraf http_response 插件做 HTTP/HTTPS 黑盒探测，包括探测配置、结果码、状态码、分阶段耗时、HTTPS 证书过期时间、Dashboard 和告警建议。