Skip to main content
reopt Handbook
reopt Handbook
LLMOps and AgentOps in Production

Architecture and Release

Ch1. System ArchitectureCh2. Versioning and ReleaseCh3. Evaluation Framework

Operational Reliability

Ch4. Online GuardrailsCh5. Observability and SLOsCh6. Cost and Latency Optimization

Growth and Response

Ch7. Experiment OperationsCh8. Incident Management Runbook

Verification

Verification ReportVerification ArchiveUpdates
Handbook›LLMOps and AgentOps›Ch8. Incident Management Runbook
한국어English

Ch8. Incident Management Runbook

Operate a unified standard for quality regressions, cost spikes, and policy bypass incidents

Key takeaways

  • LLM incidents often look normal while failing in substance, so classify them by type: quality regression, cost spike, policy bypass, MCP/Skill compromise, A2A abuse, and voice/realtime degradation.
  • Follow a fixed containment order: narrow blast radius, stop side-effect paths (payments, deployments, file writes), revoke tokens and connections, enable fallback, then preserve trace and approval evidence.
  • Map incidents to unified SEV levels: policy bypass is SEV-1/2 with Security and Compliance, quality regression and cost spikes are SEV-2/3.
  • Use AI agentic operations (e.g. PagerDuty) to connect observability signals, runbooks, approval boundaries, and escalation, but require human approval for SEV-1.
  • Postmortems should remove the system conditions that allowed failure rather than assign personal blame.

LLM service incidents often look normal while failing in substance.
Classify incidents by quality, cost, and policy, then standardize immediate actions and recurrence controls.

Incident Types

TypeDetection SignalImmediate Action
Quality regressionTask Success drops, judge score declinesRoll back prompt/model/tool policy
Cost spikeUnit cost rises, cache hit rate dropsRoute to lighter models, limit tool calls, switch to batch
Policy bypassViolation responses increase, guardrail bypassSwitch to approval mode, hotfix policy pack
MCP/Skill compromiseShadow server, unapproved scope, abnormal egressDisable server, revoke token, isolate sandbox
A2A abuseWebhook SSRF, pre-auth resource exposureBlock peer, stop push notifications
Voice/realtime degradationfirst-audio latency, interruption loopsText fallback, session recreation, low-latency model switch

Response Flow

Postmortem Fields

  • Detection delay cause (MTTD)
  • Containment delay cause
  • Manual steps that can be automated
  • Controls to prevent the same incident class
  • Related trace_id, approval_id, MCP server ID, skill version
  • Customer impact scope and notification needs

Link to Unified Incident Classification

Manage LLMOps incidents together with security incidents:

  • Quality regression: classify as SEV-2/3 and escalate to ML Platform Lead.
  • Cost spike: classify as SEV-2/3 and respond jointly with Finance and Platform.
  • Policy bypass: classify as SEV-1/2 and involve Security and Compliance immediately.

If a data security incident occurs, switch to the SEV-1 security response process immediately.

PagerDuty AI Agentic Operations

In 2026, PagerDuty is expanding its AI integration ecosystem across LLMOps, agent governance, and agentic cloud operations. Operationally, this should not be interpreted as "AI automatically fixes everything." The important shift is connecting observability signals, runbooks, approval boundaries, and escalation into one incident loop.

CapabilityDescription
Agentic detectionAI agents detect abnormal patterns and classify incident type
Automated recoveryRun predefined isolation and recovery runbooks
Escalation AIAnalyze severity and impact scope, then assign the right response team
Postmortem generationDraft incident timelines and root-cause summaries

Containment Order

Narrow impact scope: tenant, channel, model version, prompt version, MCP server, skill version.
Stop side-effect paths: payments, refunds, deployments, outbound messages, file writes, shell/code execution.
Revoke tokens and connections: MCP/A2A credentials, webhook secrets, long-lived API keys.
Enable fallback: previous version, restricted response, text-only, human review, read-only mode.
Preserve traces and approval evidence, then create postmortem and regression evals.

Credential Rotation and A2A Blocking Example

containment_playbook:
  trigger: mcp_or_a2a_compromise
  steps:
    - disable_mcp_server: github-readonly-prod
    - revoke_token_audience: mcp://github-readonly-prod
    - block_a2a_peer:
        agent_card_url: https://partner.example.com/.well-known/agent-card.json
        reason: webhook_ssrf_attempt
    - rotate_webhook_secret: a2a_push_notifications
    - set_runtime_mode: read_only
    - preserve_evidence:
        - trace_id
        - approval_id
        - mcp_server_logs
        - webhook_request_headers

Automated Recovery Standard

Apply automated recovery first to incidents with limited blast radius, such as single-tenant issues or lightweight model fallback. SEV-1 incidents should require human approval.

Principle

Postmortems should focus on removing the system conditions that allowed failure, not assigning personal blame.

Baseline and Sources

ItemBaseline DateRecheck ByPrimary Source
OWASP MCP incident risks2026-05-172026-06-16https://owasp.org/www-project-mcp-top-10/
OWASP Agentic Skills incident risks2026-05-172026-06-16https://owasp.org/www-project-agentic-skills-top-10/
PagerDuty AI operations ecosystem2026-05-172026-06-16https://www.pagerduty.com/newsroom/pagerduty-expands-ai-ecosystem-to-supercharge-ai-agents/

Related docs

Incident Response

AI Security and Compliance Operations · Prepare AI-specific incident detection, containment, recovery, and communication.

Verification Report

Structure, link, metric, and logic verification for LLMOps and AgentOps in Production

Monitoring and Incident

Enterprise Project Architecture · Operate logs, metrics, traces, alerts, runbooks, and post-incident learning.

References

Enterprise Project Architecture · Reference categories for adapting the enterprise project handbook to a specific organization.

Ch2. Versioning and Release

Release prompts, models, tools, and policies as traceable artifacts

Ch7. Experiment Operations

Repeat prompt, model, and workflow experiments quickly and safely

Verification Report

Structure, link, metric, and logic verification for LLMOps and AgentOps in Production

On this page

Incident TypesResponse FlowPostmortem FieldsLink to Unified Incident ClassificationPagerDuty AI Agentic OperationsContainment OrderCredential Rotation and A2A Blocking ExampleBaseline and Sources