Sıfırdan kayda geçmiş bir değişikliğe beş dakika.

Parçalar nasıl birleşiyor

Reldavi iki yarımdan oluşur ve herhangi bir şey kurmadan önce hangisinin hangisi olduğunu bilmek işinize yarar. Bu çizimin solu sizin deponuzdaki koddur — üç paket ve yaklaşık on beş satır yapılandırma. Sağı başka bir yerde çalışır; ya bizim sunucularımızda ya da aynı compose dosyasıyla sizinkilerde, ve hiçbirini siz kurmazsınız.

Önce neye ihtiyacınız var

1. Kurulum

İki paket: değişiklikleri yakalayan EF Core interceptor'ı ve bunları gönderen istemci.

dotnet add package Reldavi.EntityFrameworkCore
dotnet add package Reldavi.Client
dotnet add package Reldavi.AspNetCore

2. Yapılandırma

İstemciyi kaydedin, interceptor'ı DbContext'inize ekleyin ve Reldavi'a mevcut kullanıcının kim olduğunu söyleyen middleware'i devreye alın. Middleware UseAuthentication'dan sonra gelir; öncesinde principal boştur ve her değişiklik kimsesiz kaydedilir.

// Program.cs
builder.Services.AddReldaviClient(options =>
{
    options.Endpoint = new Uri("https://ingest.reldavi.com");
    options.ApiKey   = builder.Configuration["Reldavi:ApiKey"]!;
});

builder.Services.AddReldaviEntityFrameworkCore(options =>
{
    options.MaskHashSecret = builder.Configuration["Reldavi:MaskSecret"];
    options.MaskProperty("Iban", MaskStrategy.PreserveLast, 4);
});

builder.Services.AddDbContext<ShopDbContext>((sp, options) => options
    .UseNpgsql(connectionString)
    .UseReldavi(sp));

builder.Services.AddReldaviHttpContext();

var app = builder.Build();

app.UseAuthentication();
app.UseAuthorization();
app.UseReldavi();   // after authentication

Her satır ne yapıyor

3. İşaretleme

Varsayılan olarak her varlık denetlenir ve her alan kaydedilir. Öznitelikler bunu daraltır. Buradaki hiçbir şey iş mantığınızı değiştirmez.

[AuditResource("shop.order")]
public sealed class Order
{
    public int Id { get; set; }

    [AuditLabel]
    public string Reference { get; set; } = "";

    public string Status { get; set; } = "Pending";

    [AuditMask(MaskStrategy.PreserveLast, 4)]
    public string CardNumber { get; set; } = "";

    [AuditIgnore]
    public string InternalNotes { get; set; } = "";
}

4. Doğrulama

Bir değişiklik kaydedin ve paneli açın. Olay birkaç saniye içinde görünür — varsayılan gönderim aralığı — ve fark ekranı yalnızca gerçekten değişen alanları gösterir.

• Olay doğru aktörü gösteriyor mu? “anonymous” yazıyorsa middleware UseAuthentication'dan önce kayıtlıdır.
• Maskeli alanlar izdüşümünü gösteriyor mu? Ham değer görüyorsanız öznitelik yanlış üyede demektir.
• reldavi.events.dropped sayacı sıfır mı? Değilse tampon küçük ya da uç nokta sağlıksızdır.

Beş dakika sonra elinizde ne var

Bir kaydetme, dokunduğu her varlık için bir olay üretir. Bunlardan birinin hatta ve depoda nasıl göründüğü aşağıda — bir kez okumaya değer, çünkü sonrasında ürüne dair neredeyse her soru bu alanlardan birine dair bir sorudur.

{
  "id":            "01937f2e-9c14-7a3b-8f21-6d5e4c3b2a19",
  "occurredAt":    "2026-09-21T14:12:08.4419Z",
  "resourceType":  "shop.order",
  "resourceId":    "91847",
  "resourceLabel": "A-1042",
  "action":        "updated",
  "actor": {
    "id":    "u_4410",
    "name":  "deniz@acme.test",
    "type":  "user"
  },
  "changes": {
    "Status":     { "from": "Pending",        "to": "Approved" },
    "Total":      { "from": 1240.00,          "to": 1116.00 },
    "CardNumber": { "from": "•••• •••• •••• 4417", "to": "•••• •••• •••• 9021" }
  }
}

Tek bir kaydetmenin içinde ne oluyor

Kodu ilk okuyanın aklına iki soru birlikte gelir: işlemim artık daha mı yavaş, ve geri alınırsa denetim olayına ne olur? İki cevap da şu dört anın sırasında.

Uygulamanız bir ASP.NET Core uygulaması değilse

AddReldaviHttpContext, müşteriyi ve aktörü mevcut HTTP isteğinden çözer. Bir worker servisi, bir konsol uygulaması veya bir mesaj tüketicisinin isteği yoktur; bunlar Reldavi’ye kimin hareket ettiğini bir kapsam iterek söyler. Gerisi — interceptor, maskeleme, yığınlama — birebir aynıdır.

// A worker, a console app, a message consumer: no request, so push a scope.
using (AuditScope.Push(new AuditContext
{
    TenantId = "acme",
    Actor    = AuditActor.Service("nightly-reconciliation"),
}))
{
    order.Status = OrderStatus.Settled;

    await db.SaveChangesAsync(cancellationToken);
}

Hiçbir şey görünmüyorsa

Boş bir panelin neredeyse tamamını dört şey açıklar; bakmaya değer sıraya göre.

Dokümantasyonun geri kalanı

Yukarıdaki hızlı başlangıç kaydedilmiş bir değişiklikle biter; bu, işin tamamı değil başlangıcıdır. Platformun yaptığı her şey aşağıda, konu başına bir sayfa.

Sırada ne okunur

• Karşılaştırma
• Güvenlik