spearhead-issue-response/docs/index.md
2017-01-13 21:43:22 +02:00

4.6 KiB

This documentation covers parts of the Spearhead Systems Incident Response process. It is a copy of PagerDuty's documentation and furthermore a cut-down version of our own internal documentation, used at Spearhead Systems for any issue (incident or service request), and to prepare new employees for on-call responsibilities. It provides information not only on preparing for an incident or service request, but also what to do during and after. It is intended to be used by on-call practitioners and those involved in our operational technical support response process (or those wishing to become part of our support team). See the about page for more information on what this documentation is and why it exists. This documentation is complementary to what is available in our existing wiki that may not yet be open sourced.

!!! note "Issue, Incident and Service Request" At Spearhead we use the term issue to define any request from our customers. Issues fall into two categories: "Service Requests (SR)" and "Incidents (IN)". An IN will generally be an issue that has impact on the normal functioning of the business while a SR generally does not.

Incident Response at Spearhead Systems

Being On-Call

If you've never been on-call before or part of a support delivery team, you might be wondering what it's all about. These pages describe what the expectations are, along with some resources to help you.

  • Being On-Call - A guide to being on-call, both what your responsibilities are, and what they are not.
  • Alerting Principles - The principles we use to determine what things notify an engineer, and what time of day they do so.

Before an Incident

Reading material for things you probably want to know before an incident occurs. You likely don't want to be reading these during an actual incident.

  • Severity Levels - Information on our severity level classification. What constitutes a Low issue? What's a "Major Incident"?, etc.
  • Different Roles for Incidents - Information on the roles during an incident; Incident Commander, Scribe, etc.
  • Incident Call Etiquette - Our etiquette guidelines for incident calls, before you find yourself in one.

During an Incident

Information and processes during an incident.

After an Incident

Our followup processes, how we make sure we don't repeat mistakes and are always improving.

  • Post-Mortem Process - Information on our post-mortem process; what's involved and how to write or run a post-mortem.
  • Post-Mortem Template - The template we use for writing our post-mortems for major incidents.

Training

So, you want to learn about incident response? You've come to the right place.

Additional Reading

Useful material and resources from external parties that are relevant to incident response.