Version v0.1 · dotnet

Optional Hosted Observability

Configure DurableStack to publish runtime events to the hosted observability site.

Optional Hosted Observability

Hosted observability is optional.

When configured, DurableStack publishes runtime events to the hosted platform.

Start at https://app.durablestack.com to register, create a tenant, and retrieve the tenant ID and client secret needed for runtime integration.

Required settings

Set these options in your AddDurableStack... block:

  • options.Eventing.TenantId
  • options.Eventing.ClientSecret

When both TenantId and ClientSecret are set, ingestion sink registration is automatic.

Example

builder.Services.AddDurableStackPostgres(connectionString, options =>
{
    options.Eventing.TenantId = "tenant_...";
    options.Eventing.ClientSecret = "secret_...";
});

Validation checklist

1) Confirm runtime identity mapping

  • Ensure each runtime instance is associated with the intended organization/project/tenant scope.
  • Keep naming consistent between runtime configuration and site configuration.

2) Verify credentials and environment settings

  • Configure secrets through your secure secret store (not source control).
  • Validate that production and staging use separate credentials and scopes.

3) Validate end-to-end visibility

  • Trigger a known job run.
  • Confirm it appears in the observability dashboard and run views.
  • Confirm failures and retries are represented correctly.

4) Operational hardening

  • Rotate credentials on a regular schedule.
  • Alert on connection gaps so missing telemetry is detected quickly.
  • Re-check mapping after tenant/project reorganizations.

Detailed ingestion protocol and endpoint contracts are intentionally outside this guide.