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

categraf v0.3.47(企业版v0.3.74)及以后版本oracle插件不依赖cgo，不用下载with-cgo版本了

categraf-v0.3.21-linux-amd64-with-cgo-plugin.tar.gz # 带 cgo 插件的版本,目前cgo插件有两个 dcgm 和 arp 
categraf-v0.3.21-linux-amd64.tar.gz # linux + amd64  环境下运行的版本
categraf-v0.3.21-linux-arm64.tar.gz # linux + arm64  环境下运行的版本  
categraf-v0.3.21-windows-amd64.zip  # windows + amd64 环境下运行的版本
categraf-v0.3.21-windows-arm64.zip  # windows + arm64 环境下运行的版本
categraf-slim-v0.3.21-linux-amd64.tar.gz # linux+amd64 环境下运行，不包含 ibex-agent/prometheus-agent/logs-agent 不包含arp和 oracle 插件,只采集metrics的用户可以尝试 不了解区别的不推荐使用这个包
categraf-slim-v0.3.21-linux-arm64.tar.gz #linux+arm64 环境下运行，不包含 ibex-agent/prometheus-agent/logs-agent 不包含arp 和 oracle 插件,只采集metrics的用户可以尝试 不了解区别的不推荐使用这个包

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

部署

在目标机器部署，只需要 categraf 二进制、以及 conf 目录，conf 下有一个主配置文件：

config.toml，定义机器名、全局采集频率、全局附加标签、remote write backend地址等；
另外就是各种采集插件的配置目录，以input.打头，categraf 会遍历这些文件下的插件配置执行采集任务，如果某个采集器 xx 不想启用，把 input.xx 改个其他前缀(或者删除这个目录)，比如 bak.input.xx，categraf 就会忽略这个采集器。

启停

linux systemd 托管 (推荐)

v0.3.35 版本及以上支持

# 以service方式安装, 相当于添加service文件+systemctl daemon-reload
sudo ./categraf  --install

# 以service方式卸载, 相当于systemctl stop categraf + 删除service文件
sudo ./categraf  --remove

# 以service方式启动categraf ，相当于systemctl start categraf
# 如果之前有nohup启动的categraf进程，需要先人工停掉原来的categraf进程
sudo ./categraf  --start

# 以service方式停止categraf，相当于systemctl stop categraf
sudo ./categraf  --stop

# 以service方式查看categraf，相当于systemctl status categraf
sudo ./categraf  --status

v0.3.35 版本以下

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 查看

自升级

linux下v0.3.36版本及以上支持通过 --update --update_url 升级文件来进行升级 ,例如

./categraf  --update  --update_url https://download.flashcat.cloud/categraf-v0.3.36-linux-amd64.tar.gz

自升级的前提就是: 已经通过 --install 安装了服务，如果没有安装服务，需要先安装服务，然后再执行自升级命令。

categraf --install v0.3.36 及以上版本，会自动做以下3件事情

创建一个categraf.service文件
把categraf所在目录指定为WorkingDirectory
指定 -configs categraf所在目录下的conf 作为启动参数

非systemd托管方式启动自升级

如果你之前使用nohup方式/supervisord方式启动categraf，想升级到v0.3.36及以上版本，

需要先停止之前启动的categraf进程
用新版本替换原有的categraf版本，保持categraf和conf目录放在同一个父目录下
执行 sudo ./categraf --install 安装服务
执行 sudo ./categraf --start 或者 sudo systemctl start categraf 启动服务

systemd托管方式启动自升级

如果你的unit文件恰好也叫 categraf.service

需要先停止之前启动的categraf进程
用新版本替换原有的categraf版本，保持categraf和conf目录放在同一个父目录下
执行 sudo ./categraf --remove 删除旧service
执行 sudo ./categraf --install 创建新的service
执行 sudo ./categraf --start 或者 systemctl start categraf 启动服务

如果你的unit文件不叫 categraf.service

需要先停止之前启动的categraf进程
用新版本替换原有的categraf版本，保持categraf和conf目录放在同一个父目录下
执行 sudo ./categraf --install 创建新的service
执行 sudo ./categraf --start 或者 systemctl start categraf 启动服务

无论是上面哪种方式，后续升级categraf只需执行sudo ./categraf --update --update_url=https://download.flashcat.cloud/categraf-v0.3.37-linux-amd64.tar.gz 升级到v0.3.37版本