Alertiqo.Client 1.0.0

Alertiqo .NET Client

Official .NET client for Alertiqo error tracking service.

Installation

dotnet add package Alertiqo.Client

Quick Start

Basic Usage (Console/Desktop Apps)

using Alertiqo.Client;

// Initialize once at startup
Alertiqo.Init("your-api-key", "https://alertiqo.io");

try
{
    // Your code here
}
catch (Exception ex)
{
    Alertiqo.CaptureException(ex);
    throw;
}

ASP.NET Core Integration

// Program.cs
using Alertiqo.Client;
using Alertiqo.Client.Middleware;

var builder = WebApplication.CreateBuilder(args);

// Add Alertiqo services
builder.Services.AddAlertiqo(options =>
{
    options.ApiKey = builder.Configuration["Alertiqo:ApiKey"]!;
    options.Endpoint = builder.Configuration["Alertiqo:Endpoint"] ?? "https://alertiqo.io";
    options.Environment = builder.Environment.EnvironmentName;
});

var app = builder.Build();

// Add Alertiqo middleware (should be early in the pipeline)
app.UseAlertiqo();

app.Run();

Configuration via appsettings.json

{
  "Alertiqo": {
    "ApiKey": "your-api-key",
    "Endpoint": "https://alertiqo.io"
  }
}

Features

Capture Exceptions

try
{
    // Your code
}
catch (Exception ex)
{
    await alertiqo.CaptureExceptionAsync(ex);
}

Capture Messages

await alertiqo.CaptureMessageAsync("Something went wrong", "error");
await alertiqo.CaptureMessageAsync("This is a warning", "warning");

Add Context

// Set user context
Alertiqo.SetUser("user-123", "user@example.com", "John Doe");

// Add tags
Alertiqo.SetTag("feature", "checkout");
Alertiqo.SetTag("tenant", "acme-corp");

// Add extra data
Alertiqo.SetExtra("order_id", 12345);
Alertiqo.SetExtra("cart_items", new[] { "item1", "item2" });

Breadcrumbs

Alertiqo.AddBreadcrumb("User clicked checkout button", "ui", "user");
Alertiqo.AddBreadcrumb("API call to /api/orders", "http", "info");
Alertiqo.AddBreadcrumb("Order created successfully", "app", "info", new Dictionary<string, object>
{
    { "order_id", 12345 }
});

Custom Error Payload

await alertiqo.CaptureExceptionAsync(ex, payload =>
{
    payload.Tags = new Dictionary<string, string>
    {
        { "custom_tag", "value" }
    };
    payload.Context = new Dictionary<string, object>
    {
        { "custom_data", "value" }
    };
});

Configuration Options

Dependency Injection

public class MyService
{
    private readonly IAlertiqoClient _alertiqo;

    public MyService(IAlertiqoClient alertiqo)
    {
        _alertiqo = alertiqo;
    }

    public async Task DoSomethingAsync()
    {
        try
        {
            // Your code
        }
        catch (Exception ex)
        {
            await _alertiqo.CaptureExceptionAsync(ex);
            throw;
        }
    }
}

License

MIT License - see LICENSE file for details.