Opportunity Report

Compile incident data and build a narrative for analysis in incident review meetings | Jeli Part of PagerDuty

The Opportunity Report provides a space to build an incident narrative, view participants, and document key takeaways and action items. Opportunity Reports surface insights into organizational patterns and they help create structure for incident review meetings.

Navigate to Opportunities select your preferred opportunity Report. You will then see tabs outlined in the following sections.

Overview

When you navigate to an opportunity's Report Overview tab you'll see cards detailing Opportunity Start, Opportunity End and Last Import at the top.

Opportunity report

Opportunity Report Overview tab


CardDescription
Opportunity StartBy default, Jeli determines this timestamp by the earliest message collected from Slack. You can edit this value in the Narrative Builder under the Opportunity Start marker.
Opportunity EndBy default, Jeli determines this timestamp by the latest message collected from Slack. You can edit this value in the Narrative Builder under the Opportunity End marker.
Last ImportJeli determines this timestamp by the most recent data import into the opportunity.

📘

Time Zone

All times on this page are displayed in the user's local time zone.

Summary

The Summary section offers a Markdown-supported text field to document a high-level summary of the incident and its investigation. Click the icon to the right of the Summary to enter or edit it.

You can also click Choose a template to populate the field with a prepared template. Read Use Templates for Incident Reviews in Jeli for more information.

Key Roles

The Key Roles section allows you to specify who filled each role during the incident. By highlighting key roles, you can see at-a-glance who played a significant part in either the logistics of an incident or its investigation.

Key Roles

Key Roles

These roles are also displayed elsewhere in Jeli. For example, displaying the investigator(s) assigned to an opportunity, on the Opportunities list page.

Key roles on the opportunity page

Key roles on the Opportunities page

Add a Role

Add a key role

Add a key role

📘

Tip

If you are using the Jeli Slackbot, you will have the option to assign yourself a role, e.g., Incident Commander, Communications Lead, or any other custom role you’ve added in the Jeli web app. Jeli will add the user who opened the incident as the Incident Commander by default if you do not choose one using the /jeli open modal. You can always update the Incident Commander later in the incident's lifecycle.

  1. On an opportunity's Reports Overview tab, under Key Roles, click Add.
  2. Select a Role, and under Assign to select your preferred user. Note: Opportunities may have many individuals assigned to the same role (e.g., multiple investigators).
  3. Click Add to add the role.
Add role

Add role

Delete a Role

To delete a role from your opportunity:

  1. On an opportunity's Reports Overview tab, under Key Roles, hover over the user’s name and click the menu to the right.
  2. Select Delete. This will delete the key role assignment, but will not remove the individual as a participant in the opportunity, or impact your opportunity in any other way.
Delete a role

Delete a role


Imported Data Sources

When you import data from Slack or other integrations, you will see a link to the data source(s) along with information on who uploaded them in this section.

Opportunity Tags

Tags are metadata that you can apply to any opportunity. Tagging helps with categorization, correlation and filtering. Read Opportunity Tags for more information.

Related Opportunities

The Related Opportunities section details other opportunities that may share similarities in Technologies, Services, etc., based on Opportunity Tags. Read our Related Opportunities article for more information.

Narrative

The Narrative Builder is designed to help you discover, tell, and share the story of an incident. You'll write an executive summary, and develop a shareable visualization that you can center post-incident meetings around. Read our Narrative Builder article for more information.

People

The People tab provides insights into participants’ incident involvement and roles. Read our View Opportunity Participant Data article for more information.

Takeaways

During the course of an investigation, themes will often grow and change as you learn more and answer newly-surfaced questions. Takeaways provide a place to record themes, to distill them as you prepare for the learning review, and to capture them once they’ve been discussed in the meeting.

  1. In the Jeli web app, navigate to Opportunities select your desired opportunity Report.
  2. Select the Takeaways tab and click the icon on the right to begin editing.
  3. When you're finished making updates, click Save in the bottom right.
Opportunity takeaways

Opportunity takeaways

The Takeaways field supports Markdown, and it also supports templates, which can help ensure that information is recorded in a standardized way for your organization.

📘

Topics of Interest

Consider the following topics while conducting an investigation:

  • What surprised you?
  • What do you think others should know more about?
  • What qualities does this incident share with other incidents?

👍

Further Reading

Please read Jeli's Howie: The Post-Incident Guide for a more detailed breakdown of incident analysis.

Action Items

​​Action items provide a structured way to document and track remedial steps and future improvements identified during a Jeli incident. Read our Collect Action Items article for more information.

Attached Resources

The Attached Resources tab provides a place to upload external files for reference as you conduct your investigation, and to consolidate record keeping when referring to an opportunity in the future.

  1. In Jeli, select your preferred opportunity and navigate to Report Attached Resources.
  2. Click the upload area to select files from your computer, or drag and drop resources into the upload area.

Attached files will appear in the Uploaded Files section below.

📘

Formats and File Size

You can upload files in the following formats: .pdf, .rtf, .txt, .vtt (Zoom). The maximum file size is 200 MB.

Edit an Attached Resource's Display Name

  1. On an opportunity's Attached Resources tab, hover over a file name in the Uploaded Files section and click .
  2. Enter a new file name and click . The original file name will be displayed below.
A detail of the a resource that has been renamed, with the original file name below

Renamed resource

Delete an Attached Resource

  1. On an opportunity's Attached Resources tab, hover over a file name in the Uploaded Files section and click .
  2. In the confirmation modal, click Delete file.

Export a Report

From an opportunity's Report section, click Export Report in the upper right to export your incident analysis in a shareable format.

Clicking Export Report will take you to a preview of your report, which includes the following by default:

  • Summary
  • Key Roles
  • Timeline
    • Includes the exporter's time zone
  • Narrative
    • Includes each narrative marker's summary. For privacy, it does not include notes or supporting evidence.
  • Takeaways
  • Action Items
  • Attached Resources
    • Note: When the report is exported as a .pdf, any attached resources will be converted to clickable links. This means that anyone with access to the .pdf report will also have access to the attached resources.

📘

Example Report

Feel free to reference Jeli Report – Opportunity Butter Side Up for an example report. For more techniques for sharing incident findings check out our Incident 101 blog.

Edit the Report

You can enable or disable report sections in the left hand Report Sections module by turning the toggles on or off. If a section does not contain any information, it will be grayed out in the selection menu.

Report toggles

Report toggles

You can also reorder report sections by selecting the section name, then dragging and dropping to a new location:

Reorder sections

Reorder sections

You can select the report timeline's time zone before you export. This will not change the time zone in the rest of the opportunity, only in the .pdf export.

Generate the Report

To generate a .pdf version of the report, from the report preview click Export Report and choose Save as PDF from the print dialogue. Note: Make sure you have Print backgrounds selected in your print dialog options.


Learn more