Pervaxis.Core.Observability 1.6.0

Pervaxis.Core.Observability

Structured logging (Serilog), distributed tracing (OpenTelemetry / AWS X-Ray), and per-request context propagation. Implements Sections 16 and 21 of the Pervaxis Platform Spec.

Installation

dotnet add package Pervaxis.Core.Observability

Registration

// In Program.cs
builder.Host.UsePervaxisLogging(sinks =>
{
 // Add CloudWatch or any other Serilog sink here
 // sinks.WriteTo.AmazonCloudWatch(...);
});

builder.Services.AddPervaxisObservability();

Configuration via appsettings.json:

{
 "Pervaxis": {
 "Observability": {
 "ServiceName": "order-service",
 "Environment": "production",
 "ServiceVersion": "1.2.0",
 "Logging": {
 "MinimumLevel": "Information"
 },
 "Tracing": {
 "OtlpEndpoint": "http://localhost:4317",
 "SamplingRatio": 1.0
 }
 }
 }
}

Per-Request Context

Set correlation, tenant, and user context at the request boundary (e.g. middleware):

public class PervaxisContextMiddleware(
 IObservabilityContextAccessor contextAccessor,
 RequestDelegate next)
{
 public async Task InvokeAsync(HttpContext httpContext)
 {
 contextAccessor.Properties = new ObservabilityProperties
 {
 CorrelationId = httpContext.Request.Headers["X-Correlation-ID"].FirstOrDefault()
 ?? Guid.NewGuid().ToString(),
 TenantId = httpContext.Request.Headers["X-Tenant-ID"].FirstOrDefault()
 };

 await next(httpContext);
 }
}

Required Log Fields (Section 21)

Every log event is automatically stamped with:

Sensitive Data Redaction

The RedactionDestructuringPolicy automatically redacts 22 sensitive property names: password, token, secret, apiKey, ssn, cvv, authorization, and others. Any object whose type name contains Credential, Secret, Token, or Password is fully redacted.

Distributed Tracing

using var activity = PervaxisActivitySource.StartActivity("ProcessOrder");
activity?.SetTag("orderId", orderId);
activity?.SetTag("tenantId", tenantId.Value);

Traces export via OTLP to AWS ADOT Collector → AWS X-Ray.

Pervaxis Platform · Clarivex Technologies · https://clarivex.tech