How It Works

CerbiStream provides build-time validation and runtime governance for your .NET logging pipeline.

01

Define Your Governance Profile

Create rules for required fields, forbidden patterns, and field severities. Store profiles as code in your repo.

{
  "Version": "1.0.0",
  "LoggingProfiles": {
    "production": {
      "RequiredFields": [
        "timestamp",
        "message",
        "correlationId"
      ],
      "DisallowedFields": [
        "ssn",
        "creditCard",
        "password"
      ],
      "FieldSeverities": {
        "password": "Forbidden"
      }
    }
  }
}
02

Validate at Build Time

The CerbiStream Roslyn analyzer runs during your standard dotnet build, emitting diagnostics for governance violations. Fail fast, fix early.

$ dotnet build

✗ Example governance findings:
  - Missing required field: correlationId
  - Disallowed field detected: password
  
(Output is representative; actual diagnostics depend
on your governance profile configuration.)
03

Govern at Runtime

One line to add CerbiStream. Use preset modes or 20+ environment variables for zero-code configuration changes in any environment.

// One-line setup
builder.Logging.AddCerbiStream();

// Or use preset modes:
.EnableDeveloperMode()  // Console on, Queue off
.ForProduction()        // Queue on, Telemetry on
.ForTesting()           // Console on, Governance on
.ForPerformance()       // All overhead disabled

// Override via environment variables:
// CERBISTREAM_MODE=production
// CERBISTREAM_CONSOLE_OUTPUT=true
// CERBISTREAM_QUEUE_ENABLED=false
04

Monitor & Report

CerbiStream tags events with governance metadata. Forward tags to your observability platform for monitoring, or review through CerbiShield dashboards.

// Example governance tags on log events
profile: production
violations: 0
redactions: 2
traceable: true
severity: Info

Tags can be exported for audit support and
internal policy validation.

Governance controls can help support internal policies and common compliance requirements. However, CerbiStream does not provide legal certification. Always validate configuration against your organization's specific requirements.

Try the Developer Playground

Experiment with governance profiles and see validation in action. No setup required.

Sample Log Event
{
  "timestamp": "2024-01-15T10:30:00Z",
  "level": "Information",
  "correlationId": "abc-123-def",
  "message": "Order processed successfully",
  "orderId": "ORD-789",
  "customerId": "USR-456"
}

Governance Profile

Validation Output(simulated)
Click "Run Validation" to see results

Ready to get started?

Install CerbiStream from NuGet and configure your first governance profile in minutes.