Getting Started with Blameless

Welcome

Incidents

Blameless app for Slack

Blameless app for Microsoft Teams

Retrospectives

Customizing Blameless

Welcome

This guide is intended to provide you with the knowledge to get up and running quickly using Blameless. This guide assumes that all integrations have already been set up during the onboarding process. If you have any additional questions, please feel free to contact your account executive or email us at support@blameless.com for more information.

Incidents

How to start an incident

There are three ways to start a Blameless Incident:

1. Through the Blameless web UI.

2. Through Bots (Slack and Microsoft Teams) via the bot commands.

3. Via webhooks from external sources.

Blameless web UI

Users can start an Incident through web ui from the Incidents page in Blameless page.

Blameless app for Slack

With the Blameless bot installed, users can start an Incident through Slack by running Blameless slash commands from the designated channel or any channel that has the bot invited into or via the Blameless App for Microsoft Teams that allows you to manage and orchestrate your incident resolution workflow natively in Microsoft Teams.

When the user runs/blameless start incidenta modal will appear asking the user to select an incident type, severity level, and add a brief description of the incident. Any customizations for the selected Incident Type and Severity will be populated in the incident creation modal.

Assigning incident roles

Once an incident has been created, a common best practice is to start assembling an incident response team. The Blameless tool contains roles which can be assigned to users in your Slack channel so for example, you can assign someone to be an Incident Commander. Assigning a role is achieved via the Blameless slackbot “slash” command.

Running/blameless assignwill prompt a modal asking the user to select an incident role and the user who will be assigned. Any customizations from Settings for "Incident Role" will be populated in the modal.

Highlighting Slack messages

A key feature of Blameless is highlighting important Slack messages so that it is automatically added to an event timeline.

There are two ways for users to highlight important messages. The first way is by adding one of the following emoji reactions to the message you would like to capture:

• point_up

• point_up_2

• robot_face

• pushpin

• round_pushpin

• star

• floppy_disk

The above bullet list contains the codes to use for the emojis. Refer to the following figure for the actual icons.

The second way to highlight in Slack is by clicking on theMore Actionsoption for the message you’d like to capture. From there, you will see theCapture Highlightfeature provided by the Blameless bot.

Capturing highlights through Slack adds these important messages and images to your events timeline making it easier for new participants of an incident to get caught up.

Changing an incident’s status​

You can progress the status of a Blameless incident by updating its status. This can be achieved via the Blameless web UI, as well as through the Blameless App for Slack or Microsoft Teams. Updating an incident’s status provides a new set of tasks to be completed for each phase transitioned into.

Changing an incident type during an incident​

If you change incident type during an incident the following will occur:

1. You will receive a warning window confirming you wish to make the change.

2. There will be an update to the time-list to indicate when a type transition occurs.

3. The Incident remains in the same status as when it is changed.

4. All completed tasks until that point are still complete, then the new tasks are presented.

5. The Timeline is preserved.

6. The Retrospective and tags are overwritten.

Running/blameless statuswill prompt a modal asking the user to select a status for the incident. Users can also run/blameless set status to <investigating|identified|monitoring|resolved>to update the status.

You can also update the status via the Blameless web UI by clicking on the status dropdown menu located in the upper left hand side of the incident page.

It is important to keep participants and stakeholders up to date with the progress of the incident by maintaining its status.

Blameless app for Microsoft Teams

The Blameless platform offers a Microsoft Teams integration that allows you to manage and orchestrate your incident resolution workflow natively in Microsoft Teams.

Once the Blameless Microsoft Teams bot is installed, you can start an incident in Teams by mentioning the bot@blamelessfrom any channel that the Blameless Bot has access to.

Upon mentioning the bot, it will provide you a list of command options, including starting an incident and showing recent incidents.

​

Starting an incident

Click on "Start Incident". The bot will then prompt you to specify a type, severity, and description.

Once the incident starts, the bot will create a dedicated incident channel and display a summary.

Incident Management using the Blameless App for Microsoft Teams​

After creating an incident, it's time to work through the incident and manage it with the help of the bot, including tasks, roles, incident lifecycle, data collection and more. The dedicated incident channel will be populated with the incident summary for immediate context.

The dedicated incident channel will be populated with the incident summary for immediate context. The incident creator will then be prompted with some suggested actions to start managing the incident.

In addition to the initial suggestions, the Blameless App for Microsoft Teams provides several commands to facilitate workflows during the incident.

Assign Incident Roles​

Users can assign roles by selecting a role/user combination from the dropdowns. Upon role assignment, the bot will show a success message and display the tasks list for the current incident phase.

Set Incident Status​

Users can move the incident through the various phases by selecting the incident phase they'd like to transition to.

Set Incident Type​

Users can set the incident type by selecting a new incident type.

Set Incident Severity​

Users can change the incident severity by selecting a new severity.

Refer to the Microsoft Teams Bot Incident Management section for more information.

Incidents via Webhooks from External Sources​

To request webhooks contact your customer success manager or email us at support@blameless.com for more information.

Retrospectives

Assigning retrospective roles

Retrospectives are a great opportunity to learn from an incident, and Blameless makes it easy and quick to complete retrospectives through its robust set of features. The first step in completing a retrospective is assigning roles to a retrospective. Blameless allows you to assign three roles: Owner, Author, and Reviewer.

Running/blameless assign retrospectivewill prompt a modal asking the user to select a retrospective role and a user to assign to. Users can also run/blameless assign retrospective <user> <owner|authors|reviewers>to assign a user to a role directly.

Marking a retrospective as published​

Once a retrospective has been reviewed and approved by the appropriate parties, you can update the status of the retrospective to Published.

To publish a retrospective, navigate to the retrospective for the incident. Once you’re in the appropriate retrospective, click on the retrospective state dropdown and select “Published”. Now that you’ve published the retrospective, the incident Slack channel will be archived and the data from the retrospective can be used in our Reliability Insights module.

Customizing Blameless

Blameless lets customers configure a range of settings so that organizations can tailor the platform to meet their needs. To start, you will need to navigate to the Settings page on the side menu bar.

Incident workflow configuration​

Users can define different workflows per incident type and severities. This allows you to configure settings related to incidents, retrospectives, and integrations for different use cases.

By default, all incident types in Blameless come with four severity labels. These default labels are:

• SEV0

• SEV1

• SEV2 and

• SEV3

The labels can be renamed to match your internal naming scheme from Organization settings.

Whenever an incident type is created, additional customization options are enabled. You can customize the incident type by selecting it from the Incident Workflows list of types. Some of the additional configurations for incident types include:

• Incident Naming Scheme
• Slack Groups/User Invited to Incident Types for each Severity
• Slack Channels for Incident Announcements
• Tasks for each status
• Auto Assign Role to Creator
• Incident Role with Full Task Permission
• Incident tag categories
• Analysis template and custom retrospective questions
  • Custom retrospective questions are defined using JSON schema
• Retrospective completion SLO in days
• Requiring retrospectives
• PagerDuty integration settings
• Jira integration settings

Note: Once you have adjusted your settings, make sure to save otherwise, as soon as you leave this section your modifications will be lost.

 

Retrospective customization​

Users can customize retrospectives to adapt the questions to their process and derive better insights and more meaningful data.

When configuring a Retrospective you can customize two areas, the Analysis Template, and the Custom Retrospective Questions.

The Analysis Template is often used to note the qualitative insights that the incident team discusses. Some commonly asked questions users like to add to the template below are things such as:

• What went well?
• What did not go well?
• What can we improve?

The Custom Questions setting allows for you to ask more quantitative questions that are normally answered as a part of the Retrospective review process. Answers from the questions in this section are captured as data which can later be queried in the Reliability Insights module.

Custom questions are configured using JSON schema which allows for ultimate flexibility and can be configured per incident type and severity in Settings: