categraf release包的命名规则遵循{project}-{version}-{os}-{arch}.tar.gz (windows后缀是zip)，例如 categraf-v0.2.36-linux-amd64.tar.gz` 表示 categraf 的版本是 v0.2.36，运行在 linux 系统上，架构是 amd64。

categraf-v0.2.36-linux-amd64-with-cgo-plugin.tar.gz # 带 cgo 插件的版本,目前cgo插件有两个 oracle 和 arp 
categraf-v0.2.36-linux-amd64.tar.gz # linux + amd64  环境下运行的版本
categraf-v0.2.36-linux-arm64.tar.gz # linux + arm64  环境下运行的版本  
categraf-v0.2.36-windows-amd64.zip  # windows + amd64 环境下运行的版本
categraf-v0.2.36-windows-arm64.zip  # windows + arm64 环境下运行的版本

如果是从老版本升级，也是建议大家查看下载中心或者 categraf releases 页面，每个版本改动了什么，升级时注意什么，都会在这里写清楚。

部署

在目标机器部署，只需要 categraf 二进制、以及 conf 目录，conf 下有一个主配置文件：config.toml，定义机器名、全局采集频率、全局附加标签、remote write backend地址等；另外就是各种采集插件的配置目录，以input.打头，如果某个采集器 xx 不想启用，把 input.xx 改个其他前缀(或者删除这个目录)，比如 bak.input.xx，categraf 就会忽略这个采集器。

conf 目录下还提供了 categraf.service 文件样例，便于大家使用 systemd 托管 categraf。如果对 systemd 不熟悉，建议学习一下课程：Linux进阶知识

启停

linux systemd 托管 (推荐)

sudo cp categraf.service /etc/systemd/system/
sudo systemctl daemon-reload

# 以服务方式启动
systemctl start categraf

# 停止服务
systemctl stop categraf

windows 服务方式启动

# windows 安装服务
categraf.exe --win-service-install

# 启动服务
categraf.exe --win-service-start 

# 停止服务
categraf.exe --win-service-stop

windows 后台方式启动

# 后台启动
win_run.bat start   

# 停止后台进程
win_run.bat stop

注：以服务方式启动或者后台方式启动二选一（如果有session限制，需要以后台方式启动）

测试

我们经常会需要测试某个采集器的行为，临时看一下这个采集器输出哪些监控指标，比如配置好了 conf/input.mysql/mysql.toml 想要看看采集了哪些 mysql 指标，可以执行命令：./categraf --test --inputs mysql

如果要一次性测试、查看多个插件的输出，可以执行命令：./categraf --test --inputs mysql:cpu:mem, 注意使用冒号来分割多个插件。

这个命令会去连接你配置的 mysql 实例，执行SQL收集输出，将输出的内容做格式转换，最终打印到 stdout，如果我们在 stdout 正常看到了 mysql 相关监控指标，则说明一切正常，否则就是哪里出了问题，大概率是 conf/input.mysql/mysql.toml 配置的有问题。

重启

如果修改了某个采集器的配置，需要重启 categraf 或者给 categraf 进程发送HUP信号，发送HUP信号的命令，如下：

kill -HUP `pidof categraf`

注:windows下不支持发送HUP信号，需要重启categraf。

另外，categraf 支持哪些命令行参数，可以通过 ./categraf --help 查看