Loki是受Prometheus启发由Grafana Labs团队开源的水平可扩展,高度可用的多租户日志聚合系统。它的设计具有很高的成本效益,并且易于操作。使用标签来作为索引,而不是对全文进行检索,也就是说,通过这些标签既可以查询日志的内容也可以查询到监控的数据签,极大地降低了日志索引的存储。

简介

只要在应用程序服务器上安装Promtail来收集日志然后发送给Loki存储,就可以在Grafana UI界面通过添加Loki为数据源进行日志查询(如果Loki服务器性能不够,可以部署多个Loki进行存储及查询)。作为一个日志系统不光只有查询分析日志的能力,还能对日志进行监控和报警。

  • Loki是主服务器,负责存储日志和处理查询 。
  • Promtail是客户端代理,负责收集日志并将其发送给Loki
  • Grafana用于UI展示。

Loki架构

  1. Promtail收集并将日志发送给LokiDistributor组件;

  2. Distributor会对接收到的日志流进行正确性校验,并将验证后的日志分批并行发送到Ingester

  3. Ingester接受日志流并构建数据块,压缩后存放到所连接的存储后端;

  4. Querier收到HTTP查询请求,并将请求发送至Ingester用以获取内存数据 ,Ingester收到请求后返回符合条件的数据 ;

如果Ingester没有返回数据,Querier会从后端存储加载数据并遍历去重执行查询 ,通过HTTP返回查询结果。

安装包下载

Loki安装包下载地址【loki-linux-amd64.zip】:https://github.com/grafana/loki/releases

Promtail安装包下载地址【promtail-linux-amd64.zip】:https://github.com/grafana/loki/releases

Loki

配置

config.yaml配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
auth_enabled: false

server:
http_listen_port: 3100

ingester:
lifecycler:
address: 127.0.0.1
ring:
kvstore:
store: inmemory
replication_factor: 1
final_sleep: 0s
chunk_idle_period: 5m
chunk_retain_period: 30s

schema_config:
configs:
- from: 2021-03-01
store: boltdb
object_store: filesystem
schema: v9
index:
prefix: index_
period: 672h

storage_config:
boltdb:
directory: /tmp/loki/index

filesystem:
directory: /tmp/loki/chunks

limits_config:
enforce_metric_name: false
reject_old_samples: true
reject_old_samples_max_age: 672h

chunk_store_config:
max_look_back_period: 0

table_manager:
chunk_tables_provisioning:
inactive_read_throughput: 0
inactive_write_throughput: 0
provisioned_read_throughput: 0
provisioned_write_throughput: 0
index_tables_provisioning:
inactive_read_throughput: 0
inactive_write_throughput: 0
provisioned_read_throughput: 0
provisioned_write_throughput: 0
retention_deletes_enabled: true
retention_period: 672h

start.sh配置

1
2
#!/bin/bash
./loki --config.file=config.yaml &

启动Loki

1
2
3
4
5
6
7
8
9
10
mkdir -p /app/loki
mv loki-linux-amd64.zip promtail-linux-amd64.zip /app/loki

# 启动Loki
cd /app/loki
unzip loki-linux-amd64.zip -d loki
sh start.sh

# 验证Loki是否正常启动
ps -ef | grep loki

日志及索引存储路径:/tmp/loki

promtail

配置

promtail-config.yaml配置

注意:需要修改 clients.url为Loki服务的IP和端口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
server:
http_listen_port: 9080
grpc_listen_port: 0

positions:
filename: /tmp/positions.yaml

clients:
## loki.host为Loki服务地址
- url: http://loki.host/loki/api/v1/push

scrape_configs:
- job_name: system
static_configs:
- targets:
- localhost
labels:
## 系统编码
systemcode: ${SYSTEM_CODE}
## 服务名称
servicename: ${SERVICE_DLE_NAME}
## 实例名称
instance: ${HOSTNAME}
## 采集日志路径
__path__: /app/deploy/logs/*-warn.log

启动脚本

1
2
3
4
5
6
7
8
9
#!/bin/bash
PROMTAIL_VERSION=promtail-1.0.1-warn
cd /app/
wget http://maven.com/artifactory/maven-releases-local/promtail/$PROMTAIL_VERSION.zip
unzip $PROMTAIL_VERSION.zip -d promtail
rm $PROMTAIL_VERSION.zip
cd promtail
chmod 755 promtail
nohup ./promtail -config.expand-env=true -config.file=promtail-config.yaml &
其中-config.expand-env=true标识可从环境变量中取值。

脚本自动从Maven仓库(可换为其他地址)拉取zip包并解压,zip包中需包含 promtailpromtail-config.yaml文件

验证

启动后进入实例的app目录下查看是否存在Promtail目录。

1
2
# 验证promtail 是否已经正常启动
ps -ef | grep promtail