.NET Core 基於 Grafana Loki 日誌初體驗

介紹

Loki: like Prometheus, but for logs.

Loki是一個輕量級的日誌系統，受到Prometheus專案的啟發，由Grafana團隊設計和開發，所以在Grafana中是原生支援的，具有可水平擴充套件，高度可用等特性，通過儲存壓縮的、非結構化的日誌以及僅索引後設資料，更加易於操作並且執行成本更低。

github: https://github.com/grafana/loki

元件

• promtail 是代理，負責收集日誌並將其傳送給Loki。
• loki 是主伺服器，負責儲存日誌和處理查詢。
• Grafana 用於查詢和顯示日誌。

安裝

官方安裝文件：https://grafana.com/docs/loki/latest/installation/

官網支援了幾種常見的安裝方式，我這裡主要使用 Docker Compose 安裝。

docker-compose.yaml

version: "3"

networks:
  loki:

services:
  loki:
    image: grafana/loki:2.2.1
    ports:
      - "3100:3100"
    command: -config.file=/etc/loki/local-config.yaml
    networks:
      - loki

  promtail:
    image: grafana/promtail:2.2.1
    volumes:
      - /var/log:/var/log
    command: -config.file=/etc/promtail/config.yml
    networks:
      - loki

  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    networks:
      - loki

執行下邊命令，下載docker-compose.yaml

wget https://raw.githubusercontent.com/grafana/loki/v2.2.0/production/docker-compose.yaml -O docker-compose.yaml

啟動容器

docker-compose up -d

啟動成功後，執行 docker ps，可以看到啟動了3個服務,埠為3100的Grafana，埠為3000的loki服務，還有promtail代理。

接下來，訪問 http://localhost:3000 到Grafana的頁面，首次登入需要初始化賬號和密碼，然後找到左邊選單的 Configuration -> Data Sources -> Add Data Source -> Loki，配置資料來源，在url裡填寫loki服務的地址即可，然後儲存，然後可以到 Explore 頁面，檢視資料。

在 .NET Core 中配置

這裡主要用到了 Serilog 的Loki擴充套件，我新建了一個 webapi專案，名字叫LogDemo，然後需要通過Nuget安裝以下幾個元件。

• Serilog
• Serilog.AspNetCore
• Serilog.Sinks.Grafana.Loki

安裝完成以後，接著修改Program.cs 配置 Serilog。

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        }).UseSerilog((context, config) =>
        {
            config.Enrich.FromLogContext()
            .Enrich.WithProperty("app", context.HostingEnvironment.ApplicationName)
            .WriteTo.GrafanaLoki("http://localhost:3100")
            .WriteTo.Console();
        });

啟動專案後，重新整理幾次頁面，再回到 Grafana 的Explore 頁面，輸出查詢條件 {app="LogDemo"},然後就可以查詢到webapi的日誌。

總結

Grafana 原生支援，體驗也很好，和其他日誌系統ELK相比，具有輕量級，高可用，高效率等特點，是一個非常優秀的日誌元件，本文簡單嘗試使用 Loki 日誌系統，更多的介紹和配置請參照官方文件。

https://grafana.com/oss/loki/

最後歡迎掃碼關注我們的公眾號 【全球技術精選】，專注國外優秀部落格的翻譯和開源專案分享。