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.
Card | Description |
---|---|
Opportunity Start | By 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 End | By 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 Import | Jeli 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.
These roles are also displayed elsewhere in Jeli. For example, displaying the investigator(s) assigned to an opportunity, on the Opportunities list page.
Add a 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.
- On an opportunity's Reports Overview tab, under Key Roles, click Add.
- 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).
- Click Add to add the role.
Delete a Role
To delete a role from your opportunity:
- On an opportunity's Reports Overview tab, under Key Roles, hover over the user’s name and click the menu to the right.
- 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.
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.
- In the Jeli web app, navigate to Opportunities select your desired opportunity Report.
- Select the Takeaways tab and click the icon on the right to begin editing.
- When you're finished making updates, click Save in the bottom right.
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.
- In Jeli, select your preferred opportunity and navigate to Report Attached Resources.
- 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:
.rtf
,.txt
,.vtt
(Zoom). The maximum file size is 200 MB.
Edit an Attached Resource's Display Name
- On an opportunity's Attached Resources tab, hover over a file name in the Uploaded Files section and click .
- Enter a new file name and click . The original file name will be displayed below.
Delete an Attached Resource
- On an opportunity's Attached Resources tab, hover over a file name in the Uploaded Files section and click .
- 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.
- Note: When the report is exported as a
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.
You can also reorder report sections by selecting the section name, then dragging and dropping to a new location:
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.
Updated 2 months ago