Configure um pipeline de logs estruturados com .NET, Serilog, Grafana Loki e Docker Compose, preparando labels para consultas, filtros e dashboards no Grafana.
Aprenda a iniciar uma estrutura de observabilidade para aplicaƧƵes .NET 10 utilizando Serilog, Grafana Loki, Grafana e Docker Compose.
Nesta primeira parte, serĆ” criada uma aplicaĆ§Ć£o Console em C# e configurado o envio de logs estruturados para o Loki por meio do sink Serilog.Sinks.Grafana.Loki. O ambiente de observabilidade serĆ” executado em containers Docker, evitando instalaƧƵes locais mais complexas e mantendo as dependĆŖncias isoladas.
O conteĆŗdo apresenta o papel de cada componente da arquitetura: o Serilog produz e direciona os eventos de log, o Grafana Loki recebe e armazena esses eventos e o Grafana funciona como interface para visualizaĆ§Ć£o, consultas e criaĆ§Ć£o de dashboards.
TambĆ©m sĆ£o abordados:
- Conceitos de observabilidade com logs, mƩtricas e traces;
- DiferenƧas entre Grafana, Loki, Prometheus e Elasticsearch;
- InstalaĆ§Ć£o e validaĆ§Ć£o do SDK do .NET;
- CriaĆ§Ć£o de projetos com a .NET CLI;
- Estrutura de uma aplicaĆ§Ć£o Console com top-level statements;
- InstalaĆ§Ć£o de pacotes NuGet pela linha de comando;
- Conceito e funcionamento dos sinks do Serilog;
- CriaĆ§Ć£o dos serviƧos Grafana e Loki com Docker Compose;
- ConfiguraĆ§Ć£o de portas, credenciais e dependĆŖncias entre containers;
- Uso de volumes e arquivos YAML de configuraĆ§Ć£o do Loki;
- DiagnĆ³stico de containers com docker ps, docker logs e docker compose logs;
- ConfiguraĆ§Ć£o de labels para indexaĆ§Ć£o e filtragem dos logs;
- Envio dos eventos para o endpoint HTTP do Loki;
- Uso de CloseAndFlush() para garantir o envio dos logs pendentes;
- ConfiguraĆ§Ć£o do Loki como Data Source no Grafana;
- ComunicaĆ§Ć£o entre serviƧos pela rede interna do Docker.
Ao final, estarƔ pronta a base tƩcnica para explorar os logs no Grafana e criar consultas, filtros e painƩis de observabilidade.
Ćndice de capĆtulos
00:00:00 IntroduĆ§Ć£o Ć observabilidade com .NET
00:00:34 O que Ć© o Grafana Loki
00:00:56 Loki como sink do Serilog
00:01:38 Ferramentas utilizadas: .NET 10, Docker e VS Code
00:02:31 Objetivo: da instalaĆ§Ć£o ao dashboard
00:02:51 AplicaĆ§Ć£o Console e escopo do hands-on
00:03:55 Site, documentaĆ§Ć£o e ecossistema Grafana
00:06:03 Grafana: dashboards, mƩtricas, logs e traces
00:06:45 Conhecendo a documentaĆ§Ć£o do Grafana Loki
00:08:26 Loki, Prometheus e observabilidade distribuĆda
00:09:53 Como Grafana, Loki e Prometheus processam dados
00:10:54 ComparaĆ§Ć£o com Elasticsearch
00:11:34 InstalaĆ§Ć£o do .NET e Docker
00:13:58 Verificando o ambiente de desenvolvimento
00:15:18 Consultando a versĆ£o e os SDKs do .NET
00:16:18 Templates disponĆveis na .NET CLI
00:18:10 Criando o projeto Console
00:19:38 Abrindo o projeto no Visual Studio Code
00:19:57 Profiles e extensƵes do VS Code
00:21:27 Estrutura de um projeto .NET Console
00:22:39 ConfiguraƧƵes do arquivo .csproj
00:23:44 Top-level statements no Program.cs
00:24:12 Serilog e o sink para Grafana Loki
00:26:43 Instalando os pacotes NuGet
00:27:17 Arquitetura do Docker Compose
00:29:01 Volumes e configuraĆ§Ć£o persistente do Loki
00:30:29 Criando o arquivo docker-compose.yml
00:32:19 ServiƧos, portas e credenciais do Grafana
00:33:17 Verificando conflitos entre containers
00:35:27 Executando o Docker Compose
00:37:10 Consultando logs dos containers
00:38:47 Vantagens do Docker para o ambiente local
00:39:42 Configurando o Serilog e as labels
00:41:16 Criando o LoggerConfiguration
00:42:49 Endpoint HTTP e sink do Loki
00:43:48 Labels, chaves e valores para filtragem
00:45:22 Compilando e executando a aplicaĆ§Ć£o
00:45:49 Garantindo o envio com CloseAndFlush()
00:47:11 Acessando a interface do Grafana
00:47:44 Configurando o Loki como Data Source
00:48:03 ComunicaĆ§Ć£o pela rede interna do Docker
00:48:59 Encerramento e continuaĆ§Ć£o do tutorial
Links:
Grafana Labs
Grafana Loki
Docker
https://docs.docker.com/get-started/get-docker/
