Opsphere
← All articles

PagerDuty Incident Triage: A Practical Guide for SRE Teams

PagerDuty Incident Triage: A Practical Guide for SRE Teams

Abstract isometric incident triage title card

PagerDuty tells you that something is wrong, who owns it and who has been paged. It does not tell you why the service is failing. This guide covers how responders turn a PagerDuty incident into a ranked list of investigation steps, and how to connect that incident to metrics, logs, deployments, Kubernetes, cloud infrastructure and code changes before anyone touches production.

Opsphere
opsphere.io
Connect Incidents to Their Context
Opsphere brings cloud, Kubernetes, observability and CI/CD context together, helping SRE teams investigate incidents from a single interface.
See how Opsphere works with PagerDuty

TL;DR

  • Problem: The PagerDuty incident holds the ownership, urgency and timeline. The evidence that explains the failure sits in other tools, and switching between them burns the first minutes of every incident.
  • Takeaway: Read the incident record first (service, urgency, escalation, log entries), form two or three hypotheses, then test each one against metrics, deploys, cluster state and cloud changes in parallel.
  • Safety rule: Investigate read-only. Do not remediate until the verification conditions in this guide are met and the evidence points to one cause.
  • Next step: Use the triage workflow and timeline checklist below in your next incident review, then see how Opsphere works with PagerDuty as a read-only layer alongside it.

Table of Contents

What PagerDuty does, and where investigation begins

PagerDuty is a digital operations management platform. According to its annual report, it aggregates signals from software-enabled systems to help teams detect, analyze and resolve IT incidents, and it connects to the rest of a customer’s technology stack and collaboration tools. The same filing describes more than 700 integrations and an API for building additional connections.

In practice, that makes PagerDuty the system of record for the human side of an incident:

  • Which service the alert fired on, and who owns that service.
  • Which escalation policy applied, and who was paged, when, and through which channel.
  • Whether the incident was acknowledged, reassigned, escalated or resolved.
  • What urgency the incident carries.

It is not the system of record for why the checkout service started returning 500s. That answer lives in your metrics backend, your deploy pipeline, your cluster and your cloud account. Good triage is the discipline of moving from the first set of facts to the second set quickly and without guessing.

The five things to read in a PagerDuty incident

Before opening any dashboard, spend two minutes on the incident itself. Each field narrows the search.

1. The service and its owner

The service on the incident tells you the blast radius you should assume. A page on a leaf internal service and a page on an API gateway call for different first questions. Confirm who owns the service and whether the responder holding the page is that owner or a secondary. If ownership is unclear or stale, fix that in the incident channel immediately, because every later decision depends on knowing who can approve a change.

2. Urgency

Urgency separates incidents that need immediate attention from those that can wait. Treat it as an input, not a verdict. A high-urgency page triggered by a noisy threshold may be a false alarm, and a low-urgency incident on a slowly filling disk may become a high-urgency outage by morning. Note the urgency, then ask whether the symptom in the alert supports it.

3. Escalation context

Check which escalation level is active, who has already been notified and whether anyone has acknowledged. An incident that has escalated past its first level tells you the first responder did not acknowledge, which is useful when you are reconstructing the timeline later. It also tells you who else might already be looking, so you avoid duplicate work.

4. The alert payload

Read the alert details that created the incident: the source, the monitored resource, the threshold or condition, and any links or custom fields the monitoring tool attached. These details are your first anchor for the metrics and logs queries you run next.

5. Incident log entries

The incident log is a chronological record of what happened to the incident: triggered, notified, acknowledged, escalated, reassigned, annotated, resolved. Read it from top to bottom. It answers questions that dashboards cannot: how long the incident was unacknowledged, whether the same service paged repeatedly, whether someone already tried something and noted it.

Step-by-step triage workflow

This workflow assumes one responder has acknowledged the page and others may join. Each step produces something you can write in the incident notes.

  1. Acknowledge and state the impact in one sentence. Write what is broken, for whom, and since when, using the alert time and the first customer-visible symptom. If you cannot state impact yet, say so and make that the first investigation target.
  2. Read the incident record. Capture service, owner, urgency, escalation level and the alert payload. Copy the trigger time. Every other timestamp gets compared to it.
  3. Check for related incidents and alerts. Look for other open incidents on dependent services, and for alerts grouped under the same incident. Several pages in a short window usually point upstream: a shared database, a network path, a cluster node pool or a recent platform change.
  4. Write two or three hypotheses. Examples: a recent deployment introduced a regression; a dependency is saturated; a node or zone is unhealthy; a configuration or secret changed. Rank them by how well they fit the symptom and the timing.
  5. Test hypotheses in parallel, not in sequence. Assign each to a responder or run the queries side by side. The aim is to eliminate hypotheses quickly, so choose the cheapest check that could disprove each one.
  6. Correlate on time. Line up the trigger time with deploy times, config changes, scaling events, cloud events and traffic shifts. A change landing minutes before the first alert earns the top spot on your list, but it is a lead, not a conclusion.
  7. Confirm with a second, independent signal. A metric spike plus a matching log pattern, or a failing deploy plus a pod restart loop, is stronger than either alone.
  8. Decide the next action and its owner. Rollback, scale, failover, or continue investigating. Record who approves it.
  9. Verify before remediating using the conditions below.
  10. Record what you found in the incident notes as you go, so the post-incident review does not depend on memory.

Connecting PagerDuty evidence to the rest of the stack

The incident gives you a timestamp, a service name and an alert source. Those three values are the keys that unlock evidence elsewhere.

Metrics and alerts

Start with the alerting source named in the payload. Look at the metric that crossed its threshold over a window that begins well before the trigger time, at least several times the alert’s evaluation window, so you can see whether the change was sudden or gradual. Then widen to the golden signals for the same service: latency, traffic, errors and saturation. If multiple alerts are grouped into the incident, find the earliest one. It is often closest to the cause.

Metrics and alerts

Logs and traces

Filter logs by service name and time range, starting a few minutes before the first alert. Look for a change in the error pattern, not just the volume: a new exception class, a new upstream host, a new status code. Where traces exist, follow a failing request to find which hop adds the latency or error.

Deployments and code changes

Ask what changed in the window before the incident: application releases, feature flag flips, infrastructure-as-code applies, GitOps syncs, dependency upgrades. Map each change to a commit or pull request, and read the diff for the component that matches the symptom. A quick way to rank candidates is to ask which change touched the failing code path or its configuration.

Kubernetes

For containerized services, check the state of the workload that backs the PagerDuty service:

  • Pod status: restarts, crash loops, pending pods, out-of-memory kills.
  • Recent rollout history and whether a new ReplicaSet is failing readiness checks.
  • Node conditions and resource pressure in the affected node pool.
  • Events in the namespace around the trigger time.
  • Horizontal autoscaler behavior: is it scaling, capped or flapping?

Cloud infrastructure

Check whether the underlying cloud resources changed or degraded: load balancer health, database connections and CPU, queue depth, storage limits, network rules and recent configuration changes in the account. Provider-side service health notices belong on this list too, since a regional issue changes the entire plan.

Why this is slow by hand

Each of these checks lives in a different console, with different query languages and different ways of naming the same service. A responder who has to translate the PagerDuty service name into a Kubernetes namespace, then a deploy pipeline, then a log index, spends the early minutes on translation instead of diagnosis. That is the gap a unified operational layer is designed to close. For a broader look at the practice, the enterprise incident response checklist offers a useful frame for the preparation and coordination side of response.

How Opsphere fits next to PagerDuty

Opsphere is an operational intelligence platform that unifies context across AWS, Kubernetes, observability, CI/CD, security and engineering tools. It is not an incident management replacement. PagerDuty stays your system for paging, escalation and incident records. Opsphere sits beside it as a read-only layer: it can read PagerDuty incident evidence, then help a responder investigate across the rest of the stack, and it does not change incident records automatically.

In terms of the workflow above, that means:

  • Ownership and context in one place. The service from the incident can be tied to the infrastructure, deployments and dependencies behind it through operational context and investigation memory, so responders do not rebuild the picture by hand each time.
  • Parallel hypothesis testing. Opsphere’s investigation workflow is built around evidence-backed hypotheses tested side by side, matching steps 4 to 7.
  • Read-only by design. Opsphere uses read-only operational tools, so investigating does not alter the systems you are trying to stabilize.
  • Existing tools stay the source of truth. Opsphere connects to the tools you already run rather than asking you to replace them or duplicate telemetry.

The PagerDuty and Prometheus integration announcement explains how incident response and infrastructure visibility come together. For teams that want assistants in their IDE or chat to query this context, the MCP operational gateway exposes it through Model Context Protocol.

Incident timeline checklist

A clean timeline is the backbone of both live coordination and the review that follows. Build it as the incident runs, using PagerDuty’s log entries as the spine and adding evidence from other systems.

  • [ ] Trigger time of the first alert, and the monitoring source that fired it.
  • [ ] Notification time for each responder and the channel used.
  • [ ] Acknowledgement time, and who acknowledged.
  • [ ] Escalation events, including level, time and reason (no acknowledgement, manual escalation, reassignment).
  • [ ] Urgency changes and who made them.
  • [ ] First customer-visible symptom, with a source such as a support ticket or synthetic check.
  • [ ] Last known good state: the latest time the service behaved normally.
  • [ ] Changes in the window: deploys, flag changes, infrastructure applies, scaling events, with commit or ticket references.
  • [ ] Hypotheses raised, in order, with who tested each and the result.
  • [ ] Evidence collected: queries, dashboards, log patterns and cluster state, each with a timestamp.
  • [ ] Actions taken, who approved them and the observed effect.
  • [ ] Mitigation time (impact reduced) and resolution time (service healthy and verified).
  • [ ] Open questions to carry into the review.

Keep the timeline in one agreed place, and use one time zone throughout. Mixed local times are a common source of false correlations.

Troubleshooting table: common PagerDuty incident patterns

The table maps frequent patterns to the first evidence to check. It is a starting point for hypotheses, not a diagnosis.

Pattern in the incident Likely direction First evidence to check Read-only next step
Page fires minutes after a release Regression or bad config in the new version Deploy history, rollout status, error logs by version Compare error rate before and after the rollout time
Multiple services page at once Shared dependency or platform issue Database, queue, DNS, node pool and network health Find the earliest alert and the service it depends on
Repeated pages on the same service Flapping threshold or unresolved root cause Incident log entries, alert history, metric trend Check whether prior resolutions fixed the cause or only the symptom
High urgency, no visible customer impact Noisy or misconfigured alert Alert condition, synthetic checks, real traffic metrics Confirm the symptom with a second signal before escalating
Pods restarting, latency rising Memory limits, failing probes or a bad dependency Pod events, resource usage, readiness probe results Review recent resource and probe changes
Incident unacknowledged and escalating Routing or on-call coverage problem Escalation policy, schedule, notification log entries Reach the next responder directly and note the gap for review
Errors only in one region or zone Infrastructure or provider-side issue Cloud health, zone-level metrics, load balancer targets Compare healthy and unhealthy zones
Alert fired, metrics now normal Transient spike or auto-recovery Metric window around trigger, deploy and scaling events Keep the incident open until the cause is understood or the review is scheduled

Verification conditions before remediation

Under pressure, the most expensive mistake is a confident fix applied to the wrong cause. Require these conditions before any rollback, restart, scale-out or failover.

  1. The impact is confirmed. You can point to a metric, error log or user report that shows the problem, not only the alert.
  2. Two independent signals agree. For example, a deploy timestamp and an error-rate change that line up, plus matching log evidence.
  3. The competing hypotheses are addressed. You can say why the leading hypothesis fits better than the others, or which cheap check you ran to rule them out.
  4. The action is scoped and reversible. You know what it touches, what could go wrong, and how to undo it.
  5. An owner has approved it. The service owner or incident commander agreed, and the approval is in the notes.
  6. A success signal is defined. You have decided in advance which metric should recover and by roughly when, so you can tell whether the fix worked.
  7. The timeline is current. The action, the time and the approver are recorded before you run it.

If any condition fails, keep investigating or take the safest reversible mitigation. For teams thinking about how far automation should go, the article on safe automation from read-only agents to scoped remediation lays out a staged approach.

Reducing noise before the next page

Much of the time lost in triage is spent on alerts that never needed a human. After each incident, review which alerts contributed and which only added noise. Merge alerts that describe the same symptom, tighten thresholds that fire on harmless variation, and make sure each page maps to a service with a named owner. A discussion of how to approach this from the security side is in reducing false positive alerts.

Small teams feel this most, because the same people handle on-call, deploys and infrastructure. Consolidating context rather than adding another console is often the better trade, and the small SRE teams use case describes how Opsphere approaches it.

Reducing noise before the next page

Plans and getting started

Opsphere publishes its plans per month: Community at €0, Developer at €19, Team at €500 and Enterprise at €450, with Custom Solutions available without a published price. Individual engineers can start on an entry tier, and teams that want a shared investigation layer across their stack can compare tiers on the Opsphere pricing page.

Opsphere

Opsphere also offers a web client for remote infrastructure operations, so responders can run read-only operational queries from a browser as well as from an IDE.

FAQ

What is PagerDuty and what does it do?

PagerDuty is a cloud-based digital operations management platform for incident management, automation, AIOps and customer service operations, according to its annual report. Teams use it to turn signals from monitoring tools into incidents and route them to the right responders. Investigation of the cause usually happens in the tools around it.

Does PagerDuty replace my monitoring and observability tools?

No. It receives signals from those tools and coordinates the human response. Metrics, logs, traces, deploy history and cluster state stay in their own systems, which is why responders need a way to read across them during an incident.

Does Opsphere change PagerDuty incidents?

No. Opsphere is a read-only operational intelligence layer. It helps responders investigate across PagerDuty and the rest of the stack, and it does not change incident records automatically. PagerDuty remains the system for paging, escalation and incident status.

What should a small team prioritize when using PagerDuty?

Start with clear service ownership, an escalation policy that matches real coverage, and urgency settings that reflect actual impact. Then standardize the triage steps and timeline checklist above so any responder can run the same process, and review noisy alerts after each incident.

Next step: connect PagerDuty with your operational context

If your responders lose time moving between PagerDuty and the rest of the stack, the next logical step is to see the integration. Read how Opsphere works with PagerDuty and start investigating with read-only context beside your existing incident workflow.

Sources

OOpsphere
Discuss Your Incident Workflow
Contact Opsphere to discuss how operational context across your cloud and engineering tools can support incident investigation.

This article is provided for general informational purposes only and does not constitute professional, legal, security, or compliance advice. Please evaluate recommendations against your organization’s specific environment and requirements.