windows环境下Grafana+loki+promtail入门级部署日志系统，收集Springboot(Slf4j+logback)项目日志

往期热门专栏回顾

前言

新的项目开工，采用Springboot(Slf4j+logback)搭建项目，项目有很多模块，后续需要采用微服务架构。因此日志系统也需要分布式日志系统，而不是进入堡垒机输入命令查看日志这种传统的方式。

新项目不像淘宝、京东、抖音这些体量特别大，因此我们直接弃掉ELK（项目用不到es，ELK反而太显笨重）。研究几个日志系统之后，看到一款日志系统loki 眼前一亮，Loki 是 grafana Labs 团队最新的开源项目，是一个水平可扩展，高可用性，多租户的日志聚合系统。其所属Grafana Labs团队，还维护有一款著名监控仪表系统 Grafana。

今天给大家演示如何在windows环境下部署Grafana+loki+promtail日志系统，实现Springboot(Slf4j+logback)项目的日志收集，在Grafana Web界面上就能看到我们项目的日志。

效果如下：

1、搭建项目

搭建一个Springboot(Slf4j+logback)项目，配置日志文件logback.xml。
在 D://soft/grafana-9.0.6/testlogs文件夹下生成文件，文件名log.log。

<?xml version='1.0' encoding='UTF-8'?>
<!--日志配置-->
<configuration>
    <!--直接定义属性-->
    <property name="logFile" value="D://soft/grafana-9.0.6/testlogs/log"/>
    <property name="maxFileSize" value="30MB"/>

    <!--控制台日志-->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d [%thread] %-5level %logger{50} -[%file:%line]- %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!--滚动文件日志-->
    <appender name="fileLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${logFile}.log</file>
        <encoder>
            <!--日志输出格式-->
            <pattern>%d [%thread] %-5level -[%file:%line]- %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logFile}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>${maxFileSize}</maxFileSize>
        </rollingPolicy>
    </appender>
    <!--创建一个具体的日志输出-->
    <logger name="***.qinghuasuo" level="info" additivity="true">
        <!--可以有多个appender-ref，即将日志记录到不同的位置-->
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="fileLog"/>
    </logger>

    <!--基础的日志输出-->
    <root level="info"></root>
</configuration>

2、安装Grafana+loki+promtail

安装Grafana+loki+promtail，搭建日志系统。

2.1、安装Grafana

2.1.1、下载

下载地址：https://grafana.***/grafana/download?platform=windows

2.1.2、解压

下载grafana-enterprise-9.0.6.windows-amd64.zip安装包即可，并解压到 D:\soft\grafana-9.0.6

2.1.3、启动

进入\bin目录，双击grafana-server.exe启动

2.1.4、访问系统

启动成功之后，http://localhost:3000
初始登录账户：admin/admin

2.2、安装loki

2.2.1、下载

下载地址：https://github.***/grafana/loki/releases

2.2.2、解压

下载loki-windows-amd64.exe.zip安装包，并进行解压到D:\soft\loki，解压得到loki-windows-amd64.exe

2.2.3、配置

在D:\soft\loki目录下添加loki-local-config.yaml文件，内容如下(其中的路径地址，已修改成Windows路径，需要注意修改为自己服务器的路径)：

auth_enabled: false

server:
  http_listen_port: 3100
  grpc_listen_port: 9096 # 通信端口

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
  max_transfer_retries: 0
  max_chunk_age: 20m  #一个timeseries快在内存中的最大持续时间。

schema_config:
  configs:
    - from: 2022-08-06
      store: boltdb
      object_store: filesystem
      schema: v11
      index:
        prefix: index_
        period: 672h #每张表的时间范围28天

storage_config:
  boltdb:
    directory: D://tmp/loki/index # 索引文件存储地址
  filesystem:
    directory: D://tmp/loki/chunks # 块存储地址

limits_config:
  enforce_metric_name: false
  reject_old_samples: true

chunk_store_config:
  max_look_back_period: 24h # 最大可查询历史日期 28天,这个时间必须是schema_config中的period的倍数，否则报错。

table_manager: # 配置保留多少天的数据，那么之前数据会被清除，Loki中默认保留所有数据
  retention_deletes_enabled: true
  retention_period: 24h

2.2.4、配置

打开cmd定位到D:\soft\loki目录，执行命令：.\loki-windows-amd64.exe --config.file=loki-local-config.yaml，loki服务启动成功。

2.3、安装promtail

2.3.1、下载

下载地址：https://github.***/grafana/loki/releases
这里选择v2.8.10下的Assets下载promtail-windows-amd64.exe.zip，最新版本没有promtail-windows。

2.3.2、解压

下载promtail-windows-amd64.exe.zip安装包，并解压到D:\soft\loki目录，得到promtail-windows-amd64.exe

2.3.3、配置

在D:\soft\loki目录下添加promtail-local-config.yaml文件，内容如下(使用promtail去推送Springboot项目产生的日志文件，这里使用监控文件夹的形式（文件夹+文件通配）)：

server:
  http_listen_port: 9080
  grpc_listen_port: 0
positions:
  filename: D:\soft\loki\positions.yaml

clients:
  - url: http://localhost:3100/loki/api/v1/push
    batchwait: 10s
    batchsize: 40960000
scrape_configs:
  - job_name: system
    static_configs:
    - targets:
      - localhost
      labels:
        job: viplogs
        host: localhost
        __path__: D:\soft\grafana-9.0.6\testlogs\*.log

2.3.4、启动

打开cmd定位到D:\soft\loki目录，执行命令： .\promtail-windows-amd64.exe --config.file=promtail-local-config.yaml，promtail服务启动成功。

3、使用Grafana+loki+promtail查看日志

3.1、登录grafana后在Data sources -> Add data source选择loki

3.2、配置信息

填写上loki的地址

3.3、选择Explore

去执行loki的日志查询

3.4、查询日志

总结

从结果来看Grafana+loki+promtail搭建的日志系统，可以满足我们的需求，采集到Springboot(Slf4j+logback)项目日志，并且可以在WebUI上操作、查看这些日志。

从过程看，Grafana+loki+promtail搭建日志系统，入门级部署是非常容易的，比部署ELK要简单很多。

喜欢的小伙伴们，可以给个关注和点赞。我这里还有其他Java专栏，云原生、数据库、前端、运维等知识点分享。