# Kanject.Core.Logs

A queryable, DynamoDB-backed log **store** — not a `Microsoft.Extensions.Logging` sink. Write records into named log groups with `ILogManager.LogAsync`, and read them back — filtered by text and time window — with `GetLogsAsync`. Use it for durable, application-level audit and event trails your service can query itself, alongside (not instead of) your normal `ILogger`.

## Install

```bash
dotnet add package Kanject.Core.Logs.Provider.DynamoDb
```

The DynamoDB provider implements `ILogManager` from `Kanject.Core.Logs.Abstractions` (pulled in transitively).

## Register

```csharp
using Kanject.Core.Logs.Provider.DynamoDb.Extensions;

builder.Services.AddLogStore(options =>
{
    options.Ttl       = 30;                  // retention, in days
    options.Namespace = appSettings.Stage;   // per-stage log-table isolation
    options.AwsRegion = appSettings.AwsRegion;
});
```

`AddLogStore` wires the log `DbContext` and `ILogManager`. `Ttl` sets record retention in days; `Namespace` isolates the store per stage (it inherits the DynamoDB config surface — region, credentials, table).

## Write a record

```csharp
public class AuditService(ILogManager logs)
{
    // Persist a log record under a named group.
    public Task RecordAsync(string customerId, string action)
        => logs.LogAsync(new LogRequest
        {
            LogGroup = "customer-actions",
            Log      = $"{customerId} {action}",
        });
}
```

## Read them back

Query a group by text and time range — the read is paginated and returns records plus page metadata:

```csharp
// Query a group back, filtered by text and time window (paginated).
var (entries, metadata) = await logs.GetLogsAsync(new GetSystemLogsRequest
{
    LogGroup  = "customer-actions",
    Query     = "c-014",
    StartDate = DateTime.UtcNow.AddDays(-7),
    EndDate   = DateTime.UtcNow,
});

// each entry: Id (Guid), LogGroup, Log, CreatedOn
```

## What ships with it

- `ILogManager.LogAsync(LogRequest { LogGroup, Log })` — persist a record into a named group
- `ILogManager.GetLogsAsync(GetSystemLogsRequest { Id, LogGroup, Query, StartDate, EndDate })` — paginated query
- Each record is `{ Guid Id, string LogGroup, string Log, DateTime CreatedOn }`
- DynamoDB-backed with a configurable `Ttl` (days) for automatic expiry
- `Namespace` prefixing for per-stage / per-tenant isolation

> **This is a log store, not your app logger:** Keep using `ILogger<T>` / CloudWatch for framework and diagnostic logging. Reach for `Kanject.Core.Logs` when you need a **queryable** trail your own code can read back — audit logs, per-customer activity, event histories — without standing up a separate logging service.

---
_Source: https://www.kanject.com/docs/core-logs/ · Kanject Docs_