mystery0/categraf

N9E Categraf Docker镜像

镜像概述

N9E Categraf Docker镜像是将Categraf数据采集器容器化的解决方案。Categraf是一款功能强大的监控数据采集工具，专为Nightingale（N9E）监控系统设计，能够采集系统、应用、数据库等多种类型的监控指标，并支持多种输出格式。

核心功能和特性

• 全面的指标采集能力，支持系统、应用、数据库等多种监控对象
• 灵活的配置方式，支持自定义采集规则
• 多种数据输出格式，可与Nightingale等监控系统无缝集成
• 轻量级设计，资源占用低
• 支持容器化部署，便于在各种环境中快速部署和扩展

使用场景和适用范围

• 企业级监控系统部署
• 云原生环境监控
• 服务器和应用性能监控
• DevOps监控体系构建
• 需要集中采集和分析监控数据的场景

使用方法和配置说明

基本使用

使用以下命令启动Categraf容器：

bash
docker run -d \
  --name categraf \
  -v /path/to/config:/etc/categraf \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /:/rootfs:ro \
  --net=host \
  mystery0/n9e-categraf

Docker Compose配置

yaml
version: '3'
services:
  categraf:
    image: mystery0/n9e-categraf
    container_name: categraf
    restart: always
    network_mode: host
    volumes:
      - ./config:/etc/categraf
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    environment:
      - TZ=Asia/Shanghai

配置说明

1. 配置文件位于容器内的/etc/categraf目录，建议通过挂载本地目录进行配置管理
2. 主要配置文件包括：
   • categraf.conf: 主配置文件
   • conf.d/: 各类采集器的配置目录
3. 详细配置方法请参考官方文档或项目博客

环境变量

注意事项

• 使用host网络模式可以获得更全面的系统指标采集能力
• 确保挂载必要的主机目录以获取完整的系统信息
• 根据监控需求调整采集频率和指标类型，避免资源占用过高
• 配置文件修改后需要重启容器使配置生效

相关资源

• 项目博客: [***]
• Nightingale监控系统: https://github.com/ccfos/nightingale
• Categraf项目: https://github.com/flashcatcloud/categraf