9. Fluentd部署:日志

2022-11-12,,,

Fluentd是用来处理其他系统产生的日志的,它本身也会产生一些运行时日志。Fluentd包含两个日志层:全局日志和插件级日志。每个层次的日志都可以进行单独配置。

    日志级别

    Fluentd的日志包含6个级别:fatal、error、warn、info、debug和trace。级别依次递增,高级别的日志包含低级别的日志。默认为info,所以默认情况下,日志中包含info、warn、error、fatal这4个级别的日志。

    全局日志

    Fluentd内核使用全局日志配置,若插件没有单独设置自己的日志配置项,插件也共用全局日志配置项。可通过命令行或配置文件进行设置。

2.1 命令行

-v、-vv用于增加日志级别,-q、-qq用于降低日志级别。

$ fluentd -v  ... # debug level
$ fluentd -vv ... # trace level $ fluentd -q ... # warn level
$ fluentd -qq ... # error leve

使用命令行可以在不改变配置文件的情况下调整日志级别,方便调试。

配置文件

也可以在配置文件中设置的log_level来配置全局日志级别。

<system>
# equal to -qq option
log_level error
</system>
    插件日志

    可通过@log_level对每个插件单独设置日志级别,这个级别将覆盖全局日志级别。

<source>
@type tail
@log_level debug
path /var/log/data.log
...
</source>
<source>
@type http
@log_level fatal
</source>

上边这个片段中,对两个不同的输入源分别设置了各自的日志级别。

    日志格式

    Fluentd的日志支持text和json两种格式,默认使用text,可在<system>中进行设定。

<system>
<log>
format json
time_format %Y-%m-%d
</log>
</system>

若使用json格式,

2017-07-27 06:44:54 +0900 [info]: #0 fluentd worker is now running worker=0

这条日志将会转化为如下输出:

{"time":"2017-07-27","level":"info","message":"fluentd worker is now running worker=0","worker_id":0}
    将日志写入文件

    Fluentd默认将其日志输出到stdout,可通过-o将日志输出到文件中。

$ fluentd -o /path/to/log_file

若将日志写入文件,默认情况下Fluentd不会进行日志轮转,即会向指定的文件中不断写入日志,这可能会导致日志文件过大。可通过命令行参数开启日志轮转功能。

5.1 --log-rotate-age AGE

这里AGE为整数或字符串,需要和下边的rotate-size配合使用。

整数表示轮转文件个数;

字符串表示轮转频率,可为daily、weekly或monthly。

5.2 --log-rotate-size BYTES

BYTES为轮转文件的大小,达到此字节数即开始写入新的文件。

当rotate-age值为整数时,通过此配置项控制日志的轮转。

$ fluentd -c fluent.conf --log-rotate-age 5 --log-rotate-size 104857600
    捕获Fluentd日志

    Fluentd自身日志也可以被采集。

    Fluentd使用fluent作为自身日志的tag,我们可以通过<label @FLUENT_LOG>来处理Fluentd自身的日志。

# Add hostname for identifying the server
<label @FLUENT_LOG>
<filter fluent.*>
@type record_transformer
<record>
host "#{Socket.gethostname}"
</record>
</filter> <match fluent.*>
@type monitoring_plugin
# parameters...
</match>
<label>

这样做的一个用处是用来监控Fluentd运行情况。

9. Fluentd部署:日志的相关教程结束。

《9. Fluentd部署:日志.doc》

下载本文的Word格式文档,以方便收藏与打印。