Go to file
Ulric Qin f4f49e114d update README 2022-06-24 17:53:45 +08:00
.github release image to docker hub 2022-06-14 15:12:16 +08:00
agent refactor var name 2022-06-24 17:29:06 +08:00
conf refactor agent 2022-06-24 16:35:46 +08:00
config delete logs item output 2022-06-24 14:49:45 +08:00
docker new base image 2022-06-14 21:22:03 +08:00
house output plugin ck support idle_duration 2022-06-17 20:21:37 +08:00
inputs add some kube-state-metrics related yaml files 2022-06-24 16:19:01 +08:00
k8s update daemonset template 2022-06-17 11:13:28 +08:00
logs reformat import pkgs 2022-06-24 14:00:42 +08:00
parser fix prometheus parser 2022-06-23 16:20:36 +08:00
pkg add docker plugin v1 2022-06-07 10:36:17 +08:00
types code refactor 2022-04-25 14:51:52 +08:00
writer code refactor 2022-06-17 20:24:29 +08:00
.gitignore Build image (#19) 2022-06-13 14:02:57 +08:00
.goreleaser.yaml build arm64v8 artifacts 2022-06-22 16:50:32 +08:00
LICENSE add LICENSE 2022-05-16 11:58:50 +08:00
Makefile add Makefile job: build-enterprise 2022-06-24 10:10:54 +08:00
README.md update README 2022-06-24 17:53:45 +08:00
go.mod send logs to kafka 2022-06-24 13:42:41 +08:00
go.sum send logs to kafka 2022-06-24 13:42:41 +08:00
main.go add clickhouse as output plugin, beta version 2022-06-17 19:04:02 +08:00
main_posix.go try to support windows 2022-05-29 17:03:03 +08:00
main_windows.go write log to file when running on windows 2022-05-29 20:49:09 +08:00

README.md

Categraf

Categraf is a monitoring agent for nightingale / prometheus / m3db / victoriametrics / thanos / influxdb / tdengine.

Build

# export GO111MODULE=on
# export GOPROXY=https://goproxy.cn
go build

Pack

tar zcvf categraf.tar.gz categraf conf

Run

# test mode: just print metrics to stdout
./categraf --test

# test system and mem plugins
./categraf --test --inputs system:mem

# print usage message
./categraf --help

# run
./categraf

# run with specified config directory
./categraf --configs /path/to/conf-directory

# only enable system and mem plugins
./categraf --inputs system:mem

# use nohup to start categraf
nohup ./categraf &> stdout.log &

Deploy categraf as daemonset

edit k8s/categraf.yaml, replace NSERVER_SERVICE_WITH_PORT with service ip:port of nserver in your cluster, replace CATEGRAF_NAMESPACE with namespace value, then run:

kubectl apply -n monitoring -f ks8/categraf.yaml

Plugin

Click on the links to see the README of each plugin.

Thanks

Categraf is developed on the basis of Telegraf and Exporters. Thanks to the great open source community.