📝 Mapeando Logs do .NET com Zabbix

No ecossistema moderno de observabilidade, os logs são elementos fundamentais para rastrear o comportamento de aplicações, identificar falhas e monitorar performance. Embora o .NET forneça mecanismos nativos de logging via ILogger, muitas empresas utilizam Zabbix como plataforma de monitoramento, integrando logs e métricas em um ambiente centralizado.

Este artigo explora como mapear logs de aplicações .NET utilizando o ILogger e integrá-los ao Zabbix, trazendo detalhes técnicos e arquiteturais para implementação.

---

⚙️ Arquitetura da Solução

A arquitetura de integração entre .NET e Zabbix segue este fluxo:

1. Aplicação .NET gera logs usando ILogger.
2. Os logs podem ser processados e enviados por um Zabbix Sender.
3. O Zabbix Server recebe os eventos.
4. Os logs ficam disponíveis em dashboards do Zabbix para análise.

---

🏗️ Configuração no .NET

1. Criando o Projeto

dotnet new webapi -n DotNetZabbixDemo
cd DotNetZabbixDemo

2. Configurando o Logging com ILogger

No arquivo Program.cs:

var builder = WebApplication.CreateBuilder(args);

// Configuração de logging padrão
builder.Logging.ClearProviders();
builder.Logging.AddConsole();

var app = builder.Build();

app.MapGet("/health", (ILogger<Program> logger) =>
{
    logger.LogInformation("Health check chamado em {time}", DateTime.UtcNow);
    return Results.Ok("API está saudável");
});

app.Run();

---

📡 Enviando Logs para o Zabbix

O Zabbix não possui conector nativo para ILogger, mas podemos usar o Zabbix Sender.

1. Instalar o Zabbix Sender

No servidor de aplicação:

sudo apt-get install zabbix-sender

2. Enviar Logs

No .NET, podemos invocar o zabbix_sender via Process.Start:

using System.Diagnostics;

public static class ZabbixLogger
{
    public static void SendToZabbix(string host, string key, string value)
    {
        var process = new Process
        {
            StartInfo = new ProcessStartInfo
            {
                FileName = "zabbix_sender",
                Arguments = $"-z zabbix.server.com -s {host} -k {key} -o \"{value}\"",
                RedirectStandardOutput = true,
                RedirectStandardError = true,
                UseShellExecute = false,
                CreateNoWindow = true
            }
        };
        process.Start();
        process.WaitForExit();
    }
}

Uso dentro de um endpoint:

app.MapGet("/order/{id}", (int id, ILogger<Program> logger) =>
{
    logger.LogInformation("Consulta de pedido {id}", id);

    ZabbixLogger.SendToZabbix("dotnet-api", "order.request", $"Pedido consultado: {id}");

    return Results.Ok(new { Id = id, Status = "Processado" });
});

---

📊 Configuração no Zabbix

1. Criar Host no Zabbix com o nome do servidor da aplicação.
2. Criar Item para chave order.request.
3. Visualizar logs recebidos em Latest Data.
4. Criar Dashboard/Zabbix Screens para exibir métricas e logs recebidos.

---

🔍 Boas Práticas

✔️ Estruturar logs com ILogger para facilitar parsing.
✔️ Criar chaves específicas no Zabbix para cada tipo de evento.
✔️ Usar níveis de log (Information, Warning, Error) para priorização.
✔️ Integrar alertas do Zabbix com canais como Slack, Teams ou e-mail.

---

✅ Conclusão

A integração entre .NET e Zabbix permite centralizar logs e métricas em um único ambiente de observabilidade. Embora não exista integração nativa, o uso de Zabbix Sender torna o processo simples e altamente eficaz. Essa abordagem garante maior visibilidade, ajudando equipes a reagirem rapidamente a falhas e a manterem aplicações em alta disponibilidade.

---

🤝 Conecte-se Comigo

Se você trabalha com .NET moderno e quer dominar arquitetura, logging, DevOps ou interoperabilidade, vamos conversar:

💼 LinkedIn
✍️ Medium
📬 [e-mail]

---

⁶ Levantai os vossos olhos para os céus, e olhai para a terra em baixo, porque os céus desaparecerão como a fumaça, e a terra se envelhecerá como roupa, e os seus moradores morrerão semelhantemente; porém a minha salvação durará para sempre, e a minha justiça não será abolida.
Isaías 51:6