Skip to main content

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.