这是我看到的比较精炼的一片关于logstash的文章,特别转载:

另推荐一个网址:

http://udn.yyuap.com/doc/logstash-best-practice-cn/get_start/daemon.html

断断续续的看了一周logstash的文档,总算在线上ubuntu搭建起来一个logstash环境了。现在分享一下自己的经验

关于logstash

这玩意现在还算是火爆,依托于这棵大树下,logstash的关注度是非常高的,项目目前来说算是活跃。logstash是一个用于日志收集、分析的系统,架构设计非常灵活,几乎可以满足各种规模的需求。

logstash的逻辑架构

logstash的逻辑架构其实一点都不复杂,经历收集->过滤->输出三个步骤即可简简单单的筛选与管理日志,这简简单单的三个步骤经过符合业务规模的设计之后,就可以满足各种规模的需求了。

logstash的配置文件也很简单

input { }filter { }output { }

经过这三个基本配置段,就可以筛选出符合自己要求的日志了。

一些参考资料

说实话,logstash的官方文档实在是太过于简略了,我第一次看完之后完全一抹黑,根本不会写,后来是看了官方推荐的《logstash book》这本书之后才慢慢了解清楚logstash到底怎么回事。因此这本书也是强烈推荐的。不过新版本的书目前还没找到免费的,我当时看的是版本的,虽然版本低了些,和现在的logstash有些不太一样(不再使用fatjar打包了,而是直接用bash脚本传参给ruby脚本启动),不过主体功能没多大变化,配合官方文档的一些说明还是可以学习的。

其他可以google一些别人写的配置做参考

我用的业务模型

我的规模其实很小,就收集几个服务器的java程序的日志(log4j输出),推送到中央服务器进行查看而已,必要的时候进行报警。

因此我采用的规模是这样的, 在线上服务器上(input => file, filter => grok, output => tcp),从日志文件中接受输入,使用grok正则过滤器进行提取日志,使用tcp协议直接发送到中央日志服务器上进行收集和展示。

在日志服务器上(input => tcp, output => elasticsearch and email),不增加中央服务器太高的负载,将正则过滤部分放在产品服务器上,中央服务器只是收集过滤过的日志之后做一下索引展示而已,整套架构没有用到redis,因为我的规模量比较少,日志也很少,没必要用redis存储日志,只索引日志用于查询就够了。

我的配置

理清了使用的架构之后,那么写配置就非常容易了。

在产品服务器上配置如下:

input {    file {        type => "my_app"        path => "/var/log/tomcat7/my_app.log"        tags => [ "my_app", "log4j" ]        codec => multiline {            pattern => "^%{TIMESTAMP_ISO8601}"            negate => true            what => "previous"        }    }}filter {    if [type] == "my_app" {        grok {            match => { "message" =>                 "%{TIMESTAMP_ISO8601:date} \[(?
.+?)\] (?
\w+)\s*(?
.*)"            }        }        if [log_level] == "ERROR" and "Invalid password for user" not in [content] {            throttle {                after_count => 2                key => "%{content}"                add_tag => "throttled"            }        }    }}output {    tcp {        codec => json_lines        host => "center.com"        mode => "client"        port => "tcp_port"    }}

过滤这样的日志:

          date                 thread_name            log_level                      content           |                         |                   |                              |2015-01-27 10:37:32,131 [ajp-apr-127.0.0.1-8009-exec-2] INFO  mobile.ShortMessageService  - {success=true}2015-01-27 10:41:18,447 [ajp-apr-127.0.0.1-8009-exec-1] ERROR security.UserService  - grails.validation.ValidationException: Validation Error(s) occurred during save():

增加了这个plugin,目的是为了当有大量异常出现的时候,过滤掉重复的异常,不至于发爆邮箱。

在日志服务器配置如下

input {    tcp {        codec => json_lines        host => "0.0.0.0"        mode => "server"        port => "tcp_port"    }}filter {    if ! [tags] or ! [type] {        drop { }    }}output {    elasticsearch_http {        host => "localhost"    }    if "throttled" not in [tags] and [type] == "my_app" and [log_level] == "ERROR" and "Invalid password for user" not in [content] ) {         email {            body => "%{message}"            from => "smtp@email.com"            contenttype => "text/plain; charset=UTF-8"            options => [                "smtpIporHost", "smtp.email.com",                "userName", "login_name",                "password", "password",                "authenticationType", "login"            ]            subject => "服务器%{host} %{type}日志发现异常: %{content}"            to => "alter_email@email.com"        }    }}

给日志服务器最终也加上了filter,因为tcp端口对外暴露,暴露在互联网的端口你懂得,各种扫描,会引来大量的垃圾信息,因此必须要先过滤掉这些垃圾信息,才是有用的日志记录。

推送到elasticsearch,就在本机装着。elasticsearch是很好的索引服务,索引日志之后用于快速筛选和查找。

这样,一个初步可用的logstash就搭建好了,也能适应我目前的规模了。展示到页面上用的是这个项目,也是elasticsearch旗下的项目,使用和配置都很简单,就不再细说了。

批量部署

配置都测试完毕,就剩下批量部署了,使用的,给logstash添加一个state,也很简单: 

cat /srv/salt/logstash.sls

#logstash_repo:#  pkgrepo.managed:#    - name: deb http://packages.elasticsearch.org/logstash/1.4/debian stable main#    - file: /etc/apt/sources.list.d/logstash.list#    - key_url: http://packages.elasticsearch.org/GPG-KEY-elasticsearch##logstash:#  pkg.latest:#    - refresh: Truelogstash:  pkg.installed:    - sources:      - logstash: http://myserver/downloads/logstash_1.4.2-1-2c0f5a1_all.deblogstash-config:  file.recurse:    - name: /etc/logstash/conf.d    - source: salt://servers/logstash/conf.d/    - makedirs: Truelogstash-service:  service.running:    - name: logstash    - enable: True    - watch:      - pkg: logstash      - file: logstash-config

注释部分是logstash的官方源,参考,不过我这边使用实在是太慢了,不利于批量部署。不得已,只好自己下载deb包放在自己的服务器上,使用pkg.install中的sources指令从自己的服务器下载deb包安装了。

最后,使用salt '*' state.sls logstash搞定,批量部署完毕,日志都上来了。

总结一些坑

首先是版本问题

我发现国内的资料大多都老旧(如果用百度去看别人的配置,可能还在1.3以下版本),很多配置段都废弃了,因此写配置之前务必先看官方文档中plugin的文档。比如除了input plugin的type field之外,几乎所有的plugin的type field都废弃了。

其次是启动方式也略有不同,低版本的logstash使用的是fatjar方式,使用java -jar方式启动,需要自己解决依赖。但是从1.4版本以后,这种方式已经不再需要,只需要一个jdk环境即可,别的依赖已经打包到压缩包中了。个人十分推荐使用软件包的方式,自带服务服务管理脚本,好维护,好配置。

tcp配置的坑

打通这个tcp配置着实费了不少工夫,一开始怎么都不通,按文档配置也没发现什么问题(mode默认client,在服务器手工改为server),但是数据就是上不来,检查日志发现有警告

:message=>"JSON parse failure. Falling back to plain-text", xxxxxxxxxxxxx

于是google,发现 (google group链接,需爬墙),在input tcp这里加上codec => json_lines,fix.

kibana

正式稳定版本目前为3.1.2,使用这个版本部署会发现无法访问elasticsearch,最新的beta版无此问题,但是部署比较麻烦点。参考这个解决。

elasticsearch http默认不启用gzip

当查询到的数据比较多的时候,明显感觉到慢,打开chrome的network的时候发现elasticsearch返回的数据非常大,占满带宽。于是继续google,加入一以下配置启用gzip,解决。