---
title: Troubleshooting
description: Diagnose common runtime issues and resolve them quickly.
order: 84
---

# 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.