# flashcatcloud/categraf

one-stop telemetry collector for nightingale

Repository: https://github.com/flashcatcloud/categraf
Canonical: https://ross.abutalabs.com/products/categraf
Homepage: https://flashcat.cloud/docs/
Language: Go
License: MIT
License Family: permissive
Last push: 2026-08-26T02:53:59+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 84, longevity 100
- inputs: {"age_days": 1603, "days_push": 7, "days_rel": 29, "gap_med": 6.0, "n_releases_24m": 63}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1304, forks 357 (observed 2026-08-28T04:04:18.540500+00:00)

## What it is
Categraf is an all-in-one telemetry collector written in Go that gathers metrics and logs from physical machines, VMs, switches, containers, Kubernetes, middleware, and databases. It pushes data via the remote write protocol to backends like Nightingale, Prometheus, and VictoriaMetrics, and ships with nearly a hundred built-in collection plugins plus bundled dashboards and alert rules.

## Use cases
- collect server metrics and logs with a single agent
- monitor kubernetes containers and nodes
- push telemetry to nightingale or victoriaMetrics via remote write
- replace multiple exporters with one monitoring agent
- collect metrics from databases and middleware like mysql and redis
- deploy a monitoring agent as a kubernetes daemonset
- monitor hybrid cloud and multi-cloud infrastructure

## When to choose
- you use Nightingale (or Prometheus/VictoriaMetrics) and want a single agent for metrics and logs
- you want out-of-the-box dashboards and alert rules for common OS, middleware, and database targets
- you need push-based collection to minimize inbound network exposure
- you want Telegraf-style plugins with high-cardinality safeguards built in

## When to avoid
- you need OpenTelemetry-native tracing/APM collection rather than metrics and logs
- you already run a mature Telegraf, Prometheus node_exporter, or OTel Collector pipeline you don't want to migrate
- you need a pull-based scraping model instead of push remote write

## Facets
- artifact type: application
- maturity: active
- function: monitoring, logging, analytics
- domain: monitoring, self-hosted
- platform: windows, go, cross-platform
- tags: telemetry-collector, remote-write, nightingale, prometheus-ecosystem, agent, metrics-collection, all-in-one-agent, devops, containers, linux, macos, docker, kubernetes

## Member repositories
- flashcatcloud/categraf (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:18.540500+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:51:07.850019+00:00, confidence not recorded.
  - readme: https://github.com/flashcatcloud/categraf (fetched 2026-08-28T04:04:18.540500+00:00, sha db08476516c8)
  - homepage: https://flashcat.cloud/docs/ (fetched 2026-08-29T12:10:39.604767+00:00, sha d17a80da9b99)
  - site_page: https://flashcat.cloud/about (fetched 2026-08-29T12:10:39.613912+00:00, sha 0f2fb6127bbe)
  - site_page: https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v8/quickstart/datasource (fetched 2026-08-29T12:10:39.615841+00:00, sha 2c9e10198978)
  - site_page: https://flashcat.cloud/docs/content/flashcat-monitor/categraf/2-installation (fetched 2026-08-29T12:10:39.617717+00:00, sha 43d2c0894439)
  - site_page: https://flashcat.cloud/docs/content/flashcat/polaris/introduction (fetched 2026-08-29T12:10:39.619825+00:00, sha 72eeea09ddd8)
  - site_page: https://flashcat.cloud/docs/content/flashcat-partner/prometheus/quickstart/overview (fetched 2026-08-29T12:10:39.621729+00:00, sha e1a66e0dd8eb)
  - site_page: https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v9 (fetched 2026-08-29T12:10:39.623514+00:00, sha 1ae22506d872)
  - site_page: https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v9/prologue/introduction (fetched 2026-08-29T12:10:39.625169+00:00, sha 09bbfe5371fb)
  - site_page: https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v9/install/pre-intro (fetched 2026-08-29T12:10:39.627717+00:00, sha 4ef25975d93e)
- Data as of 2026-08-30T08:39:29.467469+00:00.