{"id":13574503,"url":"https://github.com/flashcatcloud/categraf","last_synced_at":"2026-03-09T06:02:30.914Z","repository":{"id":36953140,"uuid":"481071345","full_name":"flashcatcloud/categraf","owner":"flashcatcloud","description":"one-stop telemetry collector for nightingale","archived":false,"fork":false,"pushed_at":"2026-02-25T06:17:56.000Z","size":21618,"stargazers_count":1201,"open_issues_count":6,"forks_count":332,"subscribers_count":23,"default_branch":"main","last_synced_at":"2026-02-25T11:52:32.706Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://flashcat.cloud/docs/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flashcatcloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-13T04:36:31.000Z","updated_at":"2026-02-25T09:22:42.000Z","dependencies_parsed_at":"2026-01-06T21:01:57.982Z","dependency_job_id":"a9c684eb-84ba-4273-8c21-f4ba211ef113","html_url":"https://github.com/flashcatcloud/categraf","commit_stats":null,"previous_names":[],"tags_count":185,"template":false,"template_full_name":null,"purl":"pkg:github/flashcatcloud/categraf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashcatcloud%2Fcategraf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashcatcloud%2Fcategraf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashcatcloud%2Fcategraf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashcatcloud%2Fcategraf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashcatcloud","download_url":"https://codeload.github.com/flashcatcloud/categraf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashcatcloud%2Fcategraf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30284629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T15:00:52.156Z","updated_at":"2026-03-09T06:02:30.871Z","avatar_url":"https://github.com/flashcatcloud.png","language":"Go","funding_links":[],"categories":["Go","Prometheus-Exporter"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/flashcatcloud/categraf\"\u003e\n    \u003cimg src=\"doc/categraf.png\" alt=\"categraf - one-stop telemetry collector\" width=\"240\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/flashcatcloud/categraf\"/\u003e\n  \u003cimg src=\"https://img.shields.io/docker/pulls/flashcatcloud/categraf\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/flashcatcloud/categraf\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/flashcatcloud/categraf\"/\u003e\u003cbr/\u003e\n  \u003cimg src=\"https://img.shields.io/github/contributors-anon/flashcatcloud/categraf\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue\"/\u003e\n  \u003ca href=\"https://flashcat.cloud/\"\u003e \u003cimg src=\"https://img.shields.io/badge/Powered%20By-Flashcat-blueviolet\"/\u003e \u003c/a\u003e\n\u003c/p\u003e\n\nCategraf 是一款 All-in-One 的数据采集器，支持指标、日志采集；支持物理机、虚拟机、交换机、容器、K8s、多种中间件/数据库的数据采集，支持混合云架构、云原生架构、多云架构。同时，Categraf 期望不止提供采集能力，还附带提供仪表盘和告警规则，力求开箱即用。\n\n[加入微信群](https://download.flashcat.cloud/ulric/wechat17-1.jpg)。如果二维码已过期，可以加我微信 picobyte 拉群，备注：“categraf 加群”。\n\n## 特点\n\n- 内置支持近百种采集插件，同时支持采集指标和日志，减少 agent 部署数量，降低维护成本\n- 采用 PUSH 方式推送数据，对于网络策略要求较高的场景，可以减少对外部网络的依赖\n- 采用 remote write 协议推送数据，支持将数据推送到 Nightingale、Prometheus、VictoriaMetrics 等后端\n- 尽可能落地最佳实践，不需要采集的数据无需采集，针对可能会对时序库造成高基数的问题在采集侧做出处理\n\n\u003e ❇️ 我们推荐你使用 [**夜莺Nightingale**](https://github.com/ccfos/nightingale) 作为监控服务端，和 Categraf 丝滑对接，夜莺中已经内置了各类告警规则和仪表盘。\n\u003e\n\n![nightingale](./doc/img/nightingale-template-center.png)\n\n\n\u003e ❇️ 我们推荐你使用快猫星云旗下的 [**Flashduty**](https://flashcat.cloud/product/flashduty/?from=categraf-github) 作为 OnCall 值班平台，Flashduty 支持告警聚合、降噪、认领、升级、排班，让告警的触达既高效，又确保告警处理不遗漏、件件有回响。\n\n![flashduty](./doc/flashduty.png)\n\n\n## 更多文档\n\n- [快速开始](https://flashcat.cloud/blog/monitor-agent-categraf-introduction/)\n- [视频教程](https://mp.weixin.qq.com/s/T69kkBzToHVh31D87xsrIg)\n- [软件下载](https://github.com/flashcatcloud/categraf/releases)\n\n## 从源代码编译\n\n```shell\n# export GO111MODULE=on\n# export GOPROXY=https://goproxy.cn\n\ngo build\ntar zcvf categraf.tar.gz categraf conf\n```\n\n\n*Note: 对于mac os x 用户，请使用 gun-tar 工具打包*\n```shell\nbrew install gnu-tar\ngtar zcvf categraf.tar.gz categraf conf\n```\n\n*否则会出现以下报错：*\n\n```F! failed to init config: failed to load configs of dir: ./conf err:toml: line 1: files cannot contain NULL bytes; probably using UTF-16; TOML files must be UTF-8```\n\n\n\n## 运行\n\n```shell\n# test mode: just print metrics to stdout\n./categraf --test\n\n# test system and mem plugins\n./categraf --test --inputs system:mem\n\n# print usage message\n./categraf --help\n\n# run\n./categraf\n\n# run with specified config directory\n./categraf --configs /path/to/conf-directory\n\n# only enable system and mem plugins\n./categraf --inputs system:mem\n\n# use nohup to start categraf\nnohup ./categraf \u0026\u003e stdout.log \u0026\n```\n\n\n## 部署在K8s\n\nCategraf 可以以 daemonset, deployment 或者 sidecar 的形式运行在K8s中。\n\nedit k8s/daemonset.yaml, replace NSERVER_SERVICE_WITH_PORT with service ip:port of nserver in your cluster, replace CATEGRAF_NAMESPACE with namespace value, then run:\n\n```shell\nkubectl apply -n monitoring -f k8s/daemonset.yaml # collect metrics, metrics/cadvisor of node\nkubectl apply -n monitoring -f k8s/sidecar.yaml # collect service metrics\nkubectl apply -n monitoring -f k8s/deployment.yaml #collect apiserver coredns etc\n```\nNotice: k8s/sidecar.yaml is a demo, replace mock with your own image of service.\n\n## 使用Categraf无缝代替Prometheus抓取数据\nsee detail [here](https://github.com/flashcatcloud/categraf/blob/main/prometheus/README.md)\n\n## 插件\n\nplugin list and document: [https://github.com/flashcatcloud/categraf/tree/main/inputs](https://github.com/flashcatcloud/categraf/tree/main/inputs) \n\n\n## 致谢\n\nCategraf is developed on the basis of Telegraf, Exporters and the OpenTelemetry. Thanks to the great open source community.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashcatcloud%2Fcategraf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashcatcloud%2Fcategraf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashcatcloud%2Fcategraf/lists"}