Troubleshooting

Use this page to debug common issues in local and production environments.

Jobs are not executing

• Confirm worker process is running.
• Confirm job is registered and discoverable.
• Check run status via IDurableJobRunQueryService.
• Verify provider connection and migrations completed.

Unexpected retry behavior

• Verify MaxAttempts for the job.
• Check RetryBehavior, delay, and jitter settings.
• Confirm exception path actually throws when retry is desired.

Lease contention or duplicate-appearing work

• Confirm unique WorkerName per process/container.
• Validate LeaseDurationSeconds is not shorter than typical execution time.
• Review long-running handlers for heartbeat extension timing risks.

Missing telemetry or hosted observability data

• Confirm Eventing.TenantId and Eventing.ClientSecret are set.
• Verify outbound connectivity to ingestion API.
• Trigger a known run and confirm event flow end to end.