adobe/incident-response

Dispatcher Runtime Incident Response (AMS)

Investigate AMS runtime incidents involving the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration with an evidence-first workflow.

Variant Scope

• This skill is AMS-only.
• Scope is fixed by this skill directory; do not ask the user to choose deployment variant.

MCP Tool Contract

Use only these Dispatcher MCP tools:

• monitor_metrics
• tail_logs
• trace_request
• inspect_cache
• validate
• lint
• sdk

Workflow

1. Quantify impact (monitor_metrics).
2. Gather logs and traces (tail_logs, trace_request). To get the full log sequence for a specific request: use tail_logs to obtain entries (some include pid and tid from dispatcher debug lines), then call trace_request(pid=..., tid=...) to retrieve all log lines for that request. See mcp-tool-orchestration.md § Trace by pid:tid.
3. Apply AMS 6.5 guardrails to triage hypotheses (tier/farm ordering, variable usage, flush exposure, immutable boundaries).
4. Inspect cache behavior (inspect_cache).
5. Correlate with static checks (validate, lint, sdk).
6. Return containment + remediation + rollback.

Verification Scope Selection

Use shared references to select incident evidence depth:

• mode-specific-verification-matrix.md
• test-case-catalog.md

Output Contract

Always return:

• incident summary (symptom, impact window, blast radius)
• evidence table (tool, input, finding)
• selected test IDs and outcomes
• probable cause + confidence level
• containment, durable remediation, and rollback
• open risks and missing evidence

Guardrails

• Distinguish observations from inference.
• Do not claim root-cause certainty without corroborating evidence.
• Do not claim runtime verification if host-path/log prerequisites were missing.
• Keep fixes reversible unless user explicitly requests high-risk change.

References

• runtime-investigation-checklist.md
• runtime-prompts-and-troubleshooting-scenarios.md – runtime prompts and troubleshooting scenario map for tail_logs, trace_request, monitor_metrics, inspect_cache
• incident-scenario-playbooks.md – focused debug scenarios
• symptom-hypothesis-matrix.md – troubleshooting hypothesis shortcuts for faster evidence-driven diagnosis
• incident-report-template.md
• quick-start-execution-path.md – normalize repo root and select the incident path quickly
• repo-layout-workflows.md – map the failing behavior to the relevant dispatcher file families
• playbook-command-linkage.md – exact MCP command chains for incident playbooks
• ams-6-5-guardrails.md
• mode-specific-verification-matrix.md
• test-case-catalog.md
• change-risk-and-rollback-template.md
• public-docs-index.md
• public-doc-citation-rules.md
• core-7-tools-reference.md