DataKit 服务管理¶

DataKit 安装完后，有必要对安装好的 DataKit 做一些基本的介绍。

DataKit 目录介绍¶

DataKit 目前支持 Linux/Windows/Mac 三种主流平台：

安装完成以后，DataKit 目录列表大概如下：

├── [4.4K]  conf.d
├── [ 160]  data
├── [ 64M]  datakit
├── [ 192]  externals
├── [1.2K]  pipeline
├── [ 192]  gin.log   # Windows 平台
└── [1.2K]  log       # Windows 平台

其中：

• conf.d：存放所有采集器的配置示例。Datakit 主配置文件 datakit.conf 位于目录下
• data：存放 Datakit 运行所需的数据文件，如 IP 地址数据库等
• datakit：Datakit 主程序，Windows 下为 datakit.exe
• externals：部分采集器没有集成在 Datakit 主程序中，就都在这里了
• pipeline 存放用于文本处理的脚本代码
• gin.log：Datakit 可以接收外部的 HTTP 数据输入，这个日志文件相当于 HTTP 的 access-log
• log：Datakit 运行日志（Linux/Mac 平台下，Datakit 运行日志在 /var/log/datakit 目录下）

Datakit 服务管理¶

可直接使用如下命令直接管理 Datakit：

# Linux/Mac 可能需加上 sudo
datakit service -T # stop
datakit service -S # start
datakit service -R # restart

服务管理失败处理¶

有时候可能因为 Datakit 部分组件的 bug，导致服务操作失败（如 datakit service -T 之后，服务并未停止），可按照如下方式来强制处理。

Linux 下，如果上述命令失效，可使用以下命令来替代：

sudo service datakit stop/start/restart
sudo systemctl stop/start/restart datakit

Mac 下，可以用如下命令代替：

# 启动 Datakit
sudo launchctl load -w /Library/LaunchDaemons/cn.dataflux.datakit.plist
# 或者
sudo launchctl load -w /Library/LaunchDaemons/com.guance.datakit.plist

# 停止 Datakit
sudo launchctl unload -w /Library/LaunchDaemons/cn.dataflux.datakit.plist
# 或者
sudo launchctl unload -w /Library/LaunchDaemons/com.guance.datakit.plist

服务卸载以及重装¶

可直接使用如下命令直接卸载或恢复 Datakit 服务：

注意：此处卸载 Datakit 并不会删除 Datakit 相关文件。

# Linux/Mac shell
datakit service -I # re-install
datakit service -U # uninstall

FAQ¶

Windows 下启动失败¶

Datakit 在 Windows 下以服务的形式启动，启动后会写入很多 Event 日志，随着日志的积累，可能会出现如下报错：

Start service failed: The event log file is full.

该报错会导致 Datakit 无法启动。通过设置一下 Windows Event 即可（以 Windows Server 2016 为例）：