Incident Response

adobe/skills/plugins/aem/cloud-service/skills/dispatcher/incident-response

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

Investigate and triage runtime incidents involving the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration in AEM as a Cloud Service environments only, using runtime-backed MCP evidence.

Instructions onlyDevOps & Cloud
AI-generated overview

Investigates and triages Adobe Dispatcher runtime incidents in AEM as a Cloud Service using runtime-backed MCP evidence.

What it does
This skill guides an evidence-first investigation of cloud runtime incidents involving the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration. It quantifies impact, classifies whether the issue belongs to the Dispatcher or CDN/edge layer, gathers logs and traces, inspects cache behavior, and correlates findings with static checks. It produces an incident report with an evidence table, probable cause and confidence, containment, remediation, rollback, and open risks.
When to use it
Use it when a runtime incident is suspected in an AEM as a Cloud Service Dispatcher or HTTPD configuration. It fits triage and diagnosis work where runtime evidence from Dispatcher MCP tools is available. It is scoped to the cloud-service variant only.
Requirements
Requires Dispatcher MCP configured for the cloud variant (AEM_DEPLOYMENT_MODE=cloud) and the tools monitor_metrics, tail_logs, trace_request, inspect_cache, validate, lint, and sdk. It ships reference documents only, no scripts.

Dispatcher Runtime Incident Response (Cloud)

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

Variant Scope

  • This skill is cloud-service-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. Classify whether issue belongs to Dispatcher layer or CDN/edge layer using cloud guardrails, including reserved probe-path behavior.
  3. 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.
  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 container/runtime prerequisites were missing.
  • Keep fixes reversible unless user explicitly requests high-risk change.
  • For cloud incidents, explicitly state when root cause is outside Dispatcher config scope (CDN/WAF/edge policy).

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
  • local-sdk-execution.md – shipped local SDK launcher contract for local cloud-runtime reproduction
  • 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
  • mode-specific-verification-matrix.md
  • cloud-service-aemaacs-guardrails.md – cloud-service-only immutable/include/runtime boundary checks from AEMaaCS patterns
  • 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/cloud-service/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