在 Windows 系统上安装和使用 Fluentd
“ 简单介绍一下在 Windows 系统上安装和使用 Fluentd 的方法”
1,td-agent v4(对应 Fluentd 1.11.x 版本)
安装 td-agent
可以从以下地址下载安装包:
https://td-agent-package-browser.herokuapp.com/4/windows
或者,使用 winget 来安装:
> winget install td-agent
从命令提示符运行 td-agent
td-agent 安装成功后,其配置文件位于
c:/opt/td-agent/etc/td-agent/td-agent.conf
编辑这个文件,配置以下内容:
<source>
@type forward
</source>
<match test.**>
@type stdout
</match>
这简单配置用于将任何输入数据输出到 td-agent 的日志中。
td-agent 安装后,系统中会新增一个 td-agent 命令提示符的程序,可以从 Windows 开始菜单中看到这个命令提示符。
点击并打开 td-agent command prompt,输入以下命令运行 td-agent:
> fluentd -c etc\td-agent\td-agent.conf
然后再打开一个 td-agent 命令提示符,输入以下命令向 td-agent 发送一条测试日志:
> echo {"message":"hello"} | fluent-cat test.event
如果在 td-agent 日志(c:/opt/td-agent/td-agent.log)中看到以下输出,表明一切 ok。
test.event: {"k", "v"}
以 Windows 服务的方式运行 td-agent
从 td-agent 4.0.0 开始,安装程序会将 td-agent 注册为 Windows 的服务。我们也可以手动来启动 td-agent 服务。
方法一,在控制面板-管理工具-服务中找到 Fluentd 服务,选中并启动它
方法二,通过 net 命令或者 powershell 来启动 fluentd 服务。
> net start fluentdwinsvc
The Fluentd Windows Service service is starting..
The Fluentd Windows Service service was started successfully.
或:
PS> Start-Service fluentdwinsvc
安装 插件
打开 td-agent 命令提示符,使用 fluent-gem 来安装所需插件
> fluent-gem install fluent-plugin-xyz --version=1.2.3
2,td-agent v3(对应 Fluentd 1.10.x 版本)
安装 td-agent
从以下地址下载 v3的安装包:
https://td-agent-package-browser.herokuapp.com/3/windows
从命令提示符运行 td-agent
方法和示例同上边 v4.
手动注册 td-agent 为系统服务
td-agent v3 的安装包没有将其注册为系统服务,可通过以下方式手动注册服务。
以管理员身份运行 td-agent 命令提示符,输入以下命令:
> fluentd --reg-winsvc i
> fluentd --reg-winsvc-fluentdopt '-c C:/opt/td-agent/etc/td-agent/td-agent.conf -o C:/opt/td-agent/td-agent.log'
如果需要 td-agent 服务自动运行,还需要执行以下命令:
> fluentd --reg-winsvc i --reg-winsvc-auto-start --reg-winsvc-delay-start
> fluentd --reg-winsvc-fluentdopt '-c C:/opt/td-agent/etc/td-agent/td-agent.conf -o C:/opt/td-agent/td-agent.log'
以 Windows 服务的方式运行 td-agent
请见上边 v4 的说明
安装插件
方法和 v4 相同:
> fluent-gem install fluent-plugin-xyz --version=1.2.3
Enjoy fluentd anytime!