Incident Response

adobe/skills/plugins/aem/6.5-lts/skills/dispatcher/incident-response

by adobe940b8795c0dfApache-2.0197 starsListed Oct 9, 2026Updated Oct 8, 2026Repository updated today

Investigate and triage runtime incidents involving the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration in AEM 6.5 LTS environments only, using runtime MCP evidence.

Instructions onlyDevOps & Cloud
AI-generated overview

Investigates and triages Adobe Dispatcher runtime incidents in AEM 6.5 LTS AMS environments using MCP evidence.

What it does
Guides an evidence-first investigation of runtime incidents involving the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration in AMS deployments. It walks through quantifying impact, gathering logs and traces, applying AMS 6.5 guardrails, inspecting cache behavior, and correlating static checks. It produces an incident summary, an evidence table, probable cause with confidence, and containment, remediation and rollback guidance.
When to use it
Use it when a runtime incident is suspected in an AEM 6.5 LTS AMS environment involving the Dispatcher module or HTTPD configuration. It suits triage and diagnosis where runtime evidence from Dispatcher MCP tools is available. It is not intended for other deployment variants or non-Dispatcher issues.
Requirements
Requires the Dispatcher MCP for AMS (AEM_DEPLOYMENT_MODE=ams) or the AMS Dispatcher MCP SDK preset to ams, exposing the tools monitor_metrics, tail_logs, trace_request, inspect_cache, validate, lint and sdk. Ships no scripts; it is instructions plus reference documents.

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

Source and attribution

Source:adobe/skillsinplugins/aem/6.5-lts/skills/dispatcher/incident-responseat commit940b879

License: Apache-2.0

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal