中小型研发团队架构实践：集中式日志ELK

1、集中式日志

日志可分为系统日志、应用日志以及业务日志，系统日志给运维人员使用，应用日志给研发人员使用，业务日志给业务操做人员使用。咱们这里主要讲解应用日志，经过应用日志来了解应用的信息和状态，以及分析应用错误发生的缘由等。

随着系统的日益复杂，大数据时代的来临，须要几十甚至上百台的服务器是常有的事，所以迫切须要有一套针对日志、且可以集中式管理的产品。ELK 就实现了集中式日志管理平台，该平台统一涵盖了分布式日志收集、检索、统计、分析以及对日志信息的 Web 管理等集中化管控。

1.一、ELK 简介

ELK 是 Elasticsearch、Logstash、Kibana 的简称，这三套开源工具组合起来能搭建一套强大的集中式日志管理平台。

Elasticsearch 是个开源的分布式搜索引擎，提供搜索、分析、存储数据三大功能。它的特色有：分布式、自动发现、索引自动分片、索引副本机制、RESTful 风格接口、多数据源以及自动搜索负载等。

Logstash 是一个开源的用来收集、解析、过滤日志的工具。支持几乎任何类型的日志，包括系统日志、业务日志和安全日志。它能够从许多来源接收日志，这些来源主要包括 Syslog、消息传递（例如 RabbitMQ）和 Filebeat；可以以多种方式输出数据，这些方式主要包括电子邮件、WebSockets 和 Elasticsearch。

Kibana 是一个基于 Web 的友好图形界面，用于搜索、分析和可视化存储在 Elasticsearch 中的数据。它利用 Elasticsearch 的 RESTful 接口来检索数据，不只容许用户定制仪表板视图，还容许他们以特殊的方式查询、汇总和过滤数据。

1.二、ELK 的架构

下图是集中式日志管理 ELK 的架构图。出于性能的考虑，选择采用了 Beats+EK 的形式来组合搭建集中式日志管理系统。

ELK 架构

2、配置方法

2.一、Elasticsearch

Elasticsearch 部署完成后，须要更改 elasticsearch.yml 配置文件中的主要属性：cluster.name、node.name、network.host、discovery.zen.ping.unicast.hosts。其中，当部署 Elasticsearch 时是以集群模式部署的，那么 discovery.zen.ping.unicast.hosts 这个属性才会须要被配置。

2.二、Logstash

经过配置 filebeat-pipeline.conf 文件中的 Input、Filter（可选）和 Output 来完成对数据的采集、过滤和输出，以下图所示：

Logstash 配置

而后以 filebeat-pipline.conf 文件启用 Logstash 服务，以下图所示：

启用 Logstash 服务

备注：因为采用的是 Beats+EK 这个方案来实现集中式日志管理，因此不须要配 Logstash。

2.三、Kibana

经过更改 kibana.yml 配置文件内容，用来链接正确的 Elasticsearch 服务地址，一般只须要配置 elasticsearch.url 属性便可，请见下图的第一个图。配置完成后，执行【bin/kibana &】命令启用 Kibana 服务，请见下图的第二个图。最后就能够在浏览器中打开 Kibana 管理页面（访问地址：http://139.198.13.12:4800/）来查看日志。

Kibana 的配置说明

启用 Kibana 服务

2.四、Filebeat

filebeat.yml 配置文件内容主要包含 Filebeat、Output、Shipper（可选）、Logging（可选）四大部分，其中 Filebeat 主要定义监控的日志文件信息，Output 主要配置日志数据的输出目标。

filebeat.yml 文件中，主要属性值的命名规范以下：

1. fields.AppID 的命名规范是{AppID}。
2. fields.AppName 的命名规范是{产品线英文名称}.{项目英文名称}（若是项目英文名称由 2 个或 2 个以上英文单词组成，则单词之间请用. 分隔）。
3. 针对 index 属性须要注意的是：索引 (index) 所定义的值是{产品线英文名称}，但英文字母必须所有小写，且不能如下划线开头，也不能包含逗号。

filebeat.yml 的配置示例以下图所示：

filebeat.yml 的配置示例

日志文件存放在哪台服务器中，filebeat 服务就部署在哪台服务器中。在 windows 操做系统上启用 filebeat 服务的步骤：

一、在 windows 下开启搜索，输入 powershell，打开 powershell 所在文件位置，右键 powershell.exe 以管理员身份运行，进入 PowerShell 窗口。

或者以管理员身份启动 cmd.exe，输入命令 powershell，进入 PowerShell 窗口 。

注意：

请务必确保以管理员身份打开 PowerShell 窗口，不然的话在如下第 2 步中运行.ps1 脚本时，就会报没有权限建立 filebeat 服务的错误：

二、导向到 filebeat 执行程序所在目录，例如：cd 'E:\ELK\filebeat-1.3.0-windows'，而后执行命令：powershell.exe -ExecutionPolicy UnRestricted -File .\install-service-filebeat.ps1。

三、以后能够在 PowerShell 窗口中经过如下几个命令来查看、启用以及中止 filebeat 服务：

• 查看 filebeat 服务状态：Get-Service filebeat
• 启动 filebeat 服务：Start-Service filebeat
• 中止 filebeat 服务：Stop-Service filebeat

3、使用方法

3.一、Log4Net 本地日志

一、日志存放路径规范：{盘符}:\Log4Net{AppID}\，其中 AppID 即为咱们所作项目的六位编码。例如：D:\Log4Net\110107\。

二、log4net.config 配置内容：

<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/> </configSections> <appSettings> </appSettings> <log4net> <appender name="FileAppender" type="log4net.Appender.RollingFileAppender"> <!--AppID 150202，用于区分哪一个应用的日志 --> <file value="D:\Log4Net\150202\" /> <rollingStyle value="Composite" /> <datePattern value="yyyy-MM-dd&quot;.log&quot;" /> <staticLogFileName value="false" /> <param name="Encoding" value="utf-8" /> <maximumFileSize value="100MB" /> <countDirection value="0" /> <maxSizeRollBackups value="100" /> <appendToFile value="true" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="记录时间：%date 线程：[%thread] 日志级别：%-5level 记录类：%logger 日志消息：%message%newline" /> </layout> </appender> <logger name="FileLogger" additivity="false"> <level value="DEBUG" /> <appender-ref ref="FileAppender" /> </logger> </log4net> </configuration>

注意了：

• maximumFileSize 设置为 100MB；请给 countDirection 设置为大于 -1 的整数；maxSizeRollBackups 设置为 100。
• 日志文件内容规范：日志文件中的每条日志内容要求是“记录时间 线程 日志级别 出错类 日志消息”。

3.二、日志查询

基于 Kibana 查询日志（访问地址：http://139.198.13.12:4800/），主要经过如下几个步骤实现：

1. 选择业务索引库。
2. 选择日期范围。
3. 输入待查找的内容实现精确查询，也能够经过输入 * 实现模糊查询。
4. 点击每条日志的展开图标，能够查看该条日志的详细信息。
5. 在 Kibana 界面的左侧区域，自上而下依次是索引库选择框、选中字段集合列表（Selected Fields）、可用字段集合列表（Available Fields）。经过添加可用字段到选中字段集合列表中来改变 Kibana 右侧的日志表格呈现。

请参考以下图所示：

Kibana 查询日志界面

4、Demo 下载及更多资料

• Log4NetDemo 下载地址：https://github.com/das2017/Log4NetDemo
• ELK 官网：https://www.elastic.co/
• 正则表达式配置说明：https://www.elastic.co/guide/en/beats/filebeat/current/regexp-support.html

转自http://www.infoq.com/cn/articles/architecture-practice-03-elk