Sistem Entegrasyonu

Vardlog sunucusunun ayağa kaldırılması ve .NET projelerine entegre edilmesi.

1. Sunucu Kurulumu (Docker)

Vardlog çekirdek motorunu kendi altyapınızda çalıştırmak için Docker Compose kullanmanız önerilir. Aşağıdaki konfigürasyon, sistemi ayağa kaldırmak için yeterlidir.

docker-compose.yml
services:
  vardlog:
    image: hacicoskun/vardlog:latest
    container_name: vardlog
    ports:
      - "{port}:8080"
    environment:
      INITIAL_ADMIN_EMAIL: {Email}
      INITIAL_ADMIN_PASSWORD: {Password}
    restart: unless-stopped
Admin Hesabı

Konteyner ilk kez ayağa kalktığında, environment değişkenlerinde belirttiğiniz bilgilerle bir yönetici hesabı oluşturulur. Panele erişim için bu bilgileri kullanacaksınız.

2. Proje Oluşturma ve API Anahtarı

Sistem ayağa kalktıktan sonra, loglarını izlemek istediğiniz her uygulama için panel üzerinden bir proje tanımlamanız gerekir.

  1. Tarayıcınızdan http://{sunucu-ip}:{port} adresine gidin ve admin bilgilerinizle giriş yapın.
  2. Dashboard üzerinden + Provision butonuna tıklayarak uygulamanız için bir isim belirleyin.
  3. Proje oluşturulduktan sonra Settings sekmesine gidin.
  4. Access Keys bölümünde yer alan güvenlik anahtarını (API Key) kopyalayın.

3. .NET SDK Entegrasyonu

Uygulamanıza Vardlog kütüphanesini NuGet üzerinden dahil edin.

Terminal
dotnet add package Vardlog --version 1.0.6

appsettings.json Konfigürasyonu

Kopyaladığınız API anahtarını ve sunucu adresinizi yapılandırma dosyanıza ekleyin.

appsettings.json
"Vardlog": {
  "Endpoint": "http://{sunucu-ip}:{port}",
  "ApiKey": "{AccessKey}"
}

Program.cs Entegrasyonu

Vardlog, IHostApplicationBuilder mimarisi ile uyumludur.

Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.AddVardlog(); 

var app = builder.Build();
app.Run();

4. Alarm ve Bildirim Kuralları

Projenize gelen kritik hatalardan anında haberdar olmak için NTFY push bildirim altyapısını kullanabilirsiniz.

  1. Vardlog panelinde ilgili projenin Settings ekranına gidin.
  2. Notification Rules bölümünden + Create Rule butonuna tıklayın.
  3. Uyarıyı tetikleyecek log seviyesini seçin.
  4. Condition (Şart) belirleyin. İsterseniz bir metin girerek kuralın sadece bu kelimeyi içeren (Contains) veya birebir eşleşen (==) loglarda çalışmasını sağlayabilirsiniz.
  5. Mobil cihazınıza NTFY uygulamasını indirin ve panelde size verilen özel Topic ID kanalına abone olun.