Logger_MM.Agent 1.3.0

Logger_MM.Agent

Logging agent for Logger_MM Observer. Fire-and-forget logging with offline buffering.

Installation

dotnet add package Logger_MM.Agent

Quick Start

using Logger_MM.Agent;

// Create agent
var agent = new LoggerMMAgent(
    observerUrl: "http://your-server:5080",
    apiKey: "your-api-key",
    appName: "MyApp",
    appVersion: "1.0.0",
    environment: "Production"
);

// Start session
await agent.StartAsync();

// Log messages
agent.Info("MyModule", "MyFunction", "Hello from Logger_MM!");
agent.Error("MyModule", "MyFunction", "Something went wrong", exception: ex);

// Stop on shutdown
await agent.StopAsync();

Logging Methods

By Level

agent.Debug(module, function, message, ...);
agent.Info(module, function, message, ...);
agent.Warning(module, function, message, ...);
agent.Error(module, function, message, exception: ex, ...);
agent.Critical(module, function, message, exception: ex, ...);

By Type

agent.UserAction(module, function, message, ...);
agent.LlmCall(module, function, message, ...);
agent.ContentCreation(module, function, message, ...);
agent.ContentDownload(module, function, message, ...);

Full Control

agent.Log(
    level: "Error",
    type: "UserAction",
    module: "PaymentModule",
    function: "ProcessPayment",
    message: "Payment failed",
    user: "john.doe",
    @params: new { orderId = 123 },
    input: requestData,
    output: responseData,
    exception: ex,
    tags: new[] { "payment", "error" },
    correlationId: "req-456"
);

Session Management

// Start session (required before logging)
await agent.StartAsync();

// Check connection
if (agent.IsConnected) { ... }

// Keep session alive (if not sending logs for extended periods)
// Sessions auto-close after 1 hour of inactivity
await agent.PingAsync();

// Flush logs immediately
await agent.FlushAsync();

// Stop and close session
await agent.StopAsync();

Attachments

using Logger_MM.Agent.Attachments;

// Upload file first
var fileId = await agent.UploadFileAsync(imageBytes, "screenshot.png", "image/png");

// Attach to log
agent.Info("UI", "Screenshot", "Captured screen",
    attachments: new[] { Attachment.Image(fileId.Value, "screenshot.png") });

// Inline attachments (no upload needed)
agent.Info("API", "Response", "Got data",
    attachments: new[] { Attachment.Json(responseObject, "response") });

ASP.NET Core Integration

// Program.cs
builder.Services.AddSingleton<LoggerMMAgent>(sp =>
    new LoggerMMAgent(
        observerUrl: builder.Configuration["LoggerMM:Url"],
        apiKey: builder.Configuration["LoggerMM:ApiKey"],
        appName: "MyWebApp",
        appVersion: "1.0.0",
        environment: builder.Environment.EnvironmentName
    ));

var app = builder.Build();

// Start on startup
var agent = app.Services.GetRequiredService<LoggerMMAgent>();
await agent.StartAsync();

// Stop on shutdown
app.Lifetime.ApplicationStopping.Register(() =>
    agent.StopAsync().GetAwaiter().GetResult());

Features

• Fire-and-forget: Logs are queued and sent in background
• Offline buffering: Logs are saved locally if server is unavailable
• Batch sending: Logs are sent in batches for efficiency
• Session tracking: Each app instance gets unique session
• Auto-reconnect: Automatically retries failed sends

Links

• Documentation
• GitHub