Support runbook

What to collect when debugging Dhal installs.

Support runbook

When debugging a Dhal install, collect these outputs.

1. Version and install

npm ls @rokadhq/dhal
node --version
npm --version

2. Doctor

npx dhal doctor --json > dhal.doctor.json

3. Report

npx dhal report --output dhal.report.json

Review before sharing.

4. Rules

npx dhal rules --json > dhal.rules.json

5. Reproduction fixture

Create a minimal replay fixture with the request shape that was blocked unexpectedly.

npx dhal replay fixtures.replay.json --json

6. Environment posture

Confirm whether the deployment uses:

• Express, Fastify, or raw Node HTTP;
• proxy/CDN in front;
• Redis/Valkey;
• IP reputation;
• webhook alerts;
• OpenTelemetry.