- A+
背景介绍
最近工作涉及几台新服务器的日志需要接入ELK系统，配置思路如下：
使用Filebeat收集本地日志数据，Filebeat监视日志目录或特定的日志文件，再发送到消息队列到kafka，然后logstash去获取消费，利用filter功能过滤分析，最终存储到elasticsearch中。
filebeat和flume都具有日志收集功能，不过filebeat更轻量，使用go语言编写占用资源更少，可以有很高的并发，带有内部模块（auditd，Apache，Nginx，System和MySQL），可通过一个指定命令来简化通用日志格式的收集，解析和可视化；flume使用java开发，需要安装java环境，相对会比较重。
当然两者也存在区别：Filebeat收集数据的速度大于写入速度的时候可能出现数据丢失的现象，而flume会在收集数据和写入数据之间做出调整，保证能在两者之间提供一种平稳的数据状态。可以实时的将分析数据并将数据保存在数据库或者其他系统中，不会出现数据丢失的现象。
以下仅记录配置过程及常见的几种排错命令，安装篇会独立一篇做详细介绍。
配置信息
filebeat配置
我是直接yum install filebeat一键安装的，这里不做具体讲解官网有详细介绍：
https://www.elastic.co/guide/en/beats/filebeat/current/index.html
安装完成后我们以配置采集/var/log/messages为例，配置如下
# egrep -v '#|^$' /etc/filebeat/filebeat.yml filebeat.inputs: - type: log enabled: true paths: - /var/log/messages filebeat.config.modules: path: ${path.config}/modules.d/*.yml reload.enabled: false setup.template.settings: index.number_of_shards: 1 setup.kibana: output.kafka: hosts: ["10.114.102.30:9092", "10.114.102.31:9092", "10.114.102.32:9092", "10.114.102.33:9092", "10.114.102.34:9092"] topic: T621_messages partition.round_robin: reachable_only: false required_acks: 1 compression: gzip processors: - add_host_metadata: when.not.contains.tags: forwarded - add_cloud_metadata: ~ - add_docker_metadata: ~ - add_kubernetes_metadata: ~ 有几个参数需要注意的：
paths表示需要提取的日志的路径，将日志输出到kafka中，创建topic
- required_acks
0：这意味着生产者producer不等待来自broker同步完成的确认继续发送下一条（批）消息。此选项提供最低的延迟但最弱的耐久性保证（当服务器发生故障时某些数据会丢失，如leader已死，但producer并不知情，发出去的信息broker就收不到）。
1：这意味着producer在leader已成功收到的数据并得到确认后发送下一条message。此选项提供了更好的耐久性为客户等待服务器确认请求成功（被写入死亡leader但尚未复制将失去了唯一的消息）。
-1：这意味着producer在follower副本确认接收到数据后才算一次发送完成。 此选项提供最好的耐久性，我们保证没有信息将丢失，只要至少一个同步副本保持存活。 三种机制，性能依次递减 (producer吞吐量降低)，数据健壮性则依次递增。
- json.keys_under_root: true
- json.add_error_key: true
- json.message_key: log
这三行是识别json格式日志的配置，若日志格式不为json格式，需要注释掉，否则收集到的日志为filebeat的错误日志。
kafka配置
kafka原来已经安装并配置好了，这里不再说明具体安装过程，后续会出一篇ELK完整搭建过程。
这里不做重点讲解，可直接查官网：https://kafka.apache.org/documentation/#quickstart
因为有5台配合zookeeper做了集群，选其中一台配置如下：
# egrep -v '#|^$' /home/kafka/kafka/config/server.properties broker.id=1 #按顺序写，不要乱 listeners=PLAINTEXT://0.0.0.0:9092 #自己的ip advertised.listeners=PLAINTEXT://10.114.102.30:9092 num.network.threads=24 num.io.threads=8 socket.send.buffer.bytes=102400 socket.receive.buffer.bytes=102400 socket.request.max.bytes=104857600 log.dirs=/data/kafka num.partitions=8 num.recovery.threads.per.data.dir=1 offsets.topic.replication.factor=1 transaction.state.log.replication.factor=1 transaction.state.log.min.isr=1 log.retention.hours=48 log.segment.bytes=1073741824 log.retention.check.interval.ms=300000 zookeeper.connect=10.114.102.30:2181,10.114.102.31:2181,10.114.102.32:2181,10.114.102.33:2181,10.114.102.34:2181 zookeeper.connection.timeout.ms=6000 auto.create.topics.enable=false group.initial.rebalance.delay.ms=0 注意：每台服务器除broker.id需要修改之外，其他属性保持一致。
logstash配置
logstash安装也是直接参考官网就可以了
https://www.elastic.co/guide/en/logstash/7.x/index.html
不过有个地方要注意，kafka和logstash的版本兼容问题，以下是kafka使用的版本：
find /home/kafka/kafka/libs/ -name *kafka_* | head -1 | grep -o 'kafka[^n]*' kafka_2.11-1.1.0.jar 通过查找rpm包可以看到logstash用的是7.8.0
/home/cxhchusr/logstash-7.8.0.rpm 在conf.d目录下配置消费messages的文件如下
# egrep -v '#|^$' /etc/logstash/conf.d/T621_messages.conf input { kafka { bootstrap_servers => "10.114.102.30:9092,10.114.102.31:9092,10.114.102.32:9092,10.114.102.33:9092,10.114.102.34:9092" client_id => "T621_messages" group_id => "T621_messages" auto_offset_reset => "latest" consumer_threads => 10 decorate_events => true topics => ["T621_messages"] decorate_events => true type => syslog } } filter{ grok { match => { "message" => "%{SYSLOGLINE}" } } date { match => [ "logdate", "YYYY-MM-dd HH:mm:ss.SSS" ] target => "@timestamp" timezone =>"+00:00" } mutate{ remove_field => "logdate" } } output { elasticsearch { hosts => ["10.114.102.30:9200", "10.114.102.31:9200", "10.114.102.32:9200", "10.114.102.33:9200", "10.114.102.34:9200"] index => "t621_messages-%{+YYYY.MM.dd}" user => caixun password => "******()90" } } 注意：es索引需要全部为小写。
最后启动即可，并加入开机自启动/etc/rc.local：
nohup /usr/share/logstash/bin/logstash -f /etc/logstash/conf.d/ > /dev/null 2>&1 & kibana创建索引
logstash配置完成后即可在kibana创建索引
创建完成效果如下，表示接入成功：
常用排查命令
配置过程中除了在kafka上创建topic，还需查询topic是否创建成功、消费情况、以及消息处理情况。
以及es是否正常入库并创建了索引。下面列出几个ELK运维常用命令。
kafka常用运维指令
- 查询当前topic列表
/home/kafka/kafka/bin/kafka-topics.sh --zookeeper 127.0.0.1:2181 --list
- 创建topic
/home/kafka/kafka/bin/kafka-topics.sh --zookeeper 127.0.0.1:2181 --create --partitions 10 --replication-factor 1 --topic T621_messages
- topic描述(某topic详细信息)
/home/kafka/kafka/bin/kafka-topics.sh --zookeeper 127.0.0.1:2181 --describe --topic T621_messages
- topic消费情况(测试消息是否正常生产)
发送：/home/kafka/kafka/bin/kafka-console-producer.sh --broker-list 127.0.0.1:9092 --topic T621_messages
接收：/home/kafka/kafka/bin/kafka-console-consumer.sh --bootstrap-server 127.0.0.1:9092 --topic T621_messages --from-beginning
- 查看topic堆积情况
/home/kafka/kafka/bin/kafka-consumer-groups.sh --bootstrap-server 127.0.0.1:9092 --list ##查看组列表
/home/kafka/kafka/bin/kafka-consumer-groups.sh --bootstrap-server 127.0.0.1:9092 --describe --group T621_messages ##偏移量
/data/kafka/kafka/bin/kafka-console-consumer.sh --bootstrap-server 127.0.0.1:9092 --topic T621_messages --from-beginning
ES常用运维指令
- 查看ES集群健康情况
curl -u caixxx:"CAIxxx()90" '10.114.102.30:9200/_cluster/health'
- 查看索引存储情况
curl -u caixxx:"CAIxxx()90" '10.114.102.30:9200/_cat/indices?v'
- 查看帮助命令
# curl -u caixun:"CAIXUN()90" '10.114.102.30:9200/_cat' =^.^= /_cat/allocation /_cat/shards /_cat/shards/{index} /_cat/master /_cat/nodes /_cat/tasks /_cat/indices /_cat/indices/{index} /_cat/segments /_cat/segments/{index} /_cat/count /_cat/count/{index} /_cat/recovery /_cat/recovery/{index} /_cat/health /_cat/pending_tasks /_cat/aliases /_cat/aliases/{alias} /_cat/thread_pool /_cat/thread_pool/{thread_pools} /_cat/plugins /_cat/fielddata /_cat/fielddata/{fields} /_cat/nodeattrs /_cat/repositories /_cat/snapshots/{repository} /_cat/templates /_cat/transforms /_cat/transforms/{transform_id} 过滤索引查看消息是否成功存储在es，有的话代表配置成功。
---- 钢铁 [email protected] 2021.08.20
参考鸣谢
官方kafka：http://kafka.apache.org/
