š£ Getting Started with the Jeli Slackbot
The one command you need to know: /jeli
Getting help from Jeli's Slackbot and additional resources: /jeli help
Contextual help: /jeli help
Contextual help: /jeli help
Contextual help: /jeli help
All of the Jeli Bot Commands can be listed in Slack by running the /jeli help
command at any time from any channel Jeli is added to, itās an ephemeral message, so only you will see it. The help command is contextual, meaning it will suggest different commands depending on whether youāre in an incident channel (in the middle of incident response) or trying to import data from other Slack channels, but you can expand it to provide a list of all our commands.
š¤ Creating an Incident
Open a new incident: /jeli open
Open a new incident: /jeli open
Open a new incident: /jeli open
Initiate incident response with a single click. Include the available information about the incident in the Add More Details section, and utilize any configured integrations in the Use Integrations section.
No field is required, if you do not add a name we will generate one for you from a randomized list of adjectives and nouns.
Weāll send you an ephemeral message **confirming the incident has been created ** with a link to the generated slack channel. Weāll also notify your selected broadcast channels that an incident has been created.
Add More Details
Every field in this section is optional, just add what you know now such as the:
Summary
Severity
Add or remove relevant Broadcast Channels
Assign yourself to a role within response
All of these fields are editable during response as well through various slash commands.
Use Integrations
Currently your Incident Settings will determine the default selections on this page and can be changed on a per-incident basis here, including:
Auto initiation of a Zoom call
Auto initiation of a Google Meet call
Creation of a Primary Jira ticket upon the creation of the incident in Jeli
Please note that using the Primary Jira ticket integration does change the naming scheme of the incident channels.
Incident Channel Naming
When an incident is created the generated Slack channel name will follow this format:
#jeli-[incident number]-[incident name]
such as#jeli-29-docs-pages-are-down
If you elect to have a primary Jira ticket automatically created, it will add the Jira ticket number as a prefix on the channel name as opposed to the
#jeli- prefix: #[jira ticket project and ticket id]-[incident name]
such as#inc-133-payroll-is-down
If you do not add a name we will generate one for you from a randomized list of adjectives and nouns and the channel name will get the #jeli- prefix or the Jira ticket prefix based on your configurations, such as
#eng-34-full-lemon
To distinguish demo incidents from actual events, the naming differs:
#jeli-demo-[incident name]-[YYYY-MM-DD]
such as#jeli-demo-just-testing-2023-06-20
if Jeli is currently undergoing an incident of our own impacting incident creation, we have fallbacks in place which will change the name format to:
#jeli-[incident name]-[YYYY-MM-DD]
such as#jeli-emails-are-delayed-2023-06-21
Aliases: /jeli incident
, /jeli open-incident
, /jeli start
, /jeli start-incident
Add a summary to an incident: /jeli summary
Add a summary to an incident: /jeli summary
Add a summary to an incident: /jeli summary
Type what you know about the issue so far and update it when anything significant changes.
The summary is the main description of the incident. It is displayed in the overview responders can use to get up to speed in the incident channel. As well as in the incident notification sent to the broadcast channels, where those not involved in active response can stay up to date on the status of response.
To quickly update the status without opening a dialog box use /jeli summary [type out summary before hitting enter]
Aliases: /jeli update-summary
Add a severity level to an incident: /jeli sev
Add a severity level to an incident: /jeli sev
Add a severity level to an incident: /jeli sev
Select from the severity options of 0, 1, and 2, provide some in the moment context behind your decision and customize the broadcast based on the severity. Severity is not required and can be disabled by request.
To quickly set the severity without opening a dialog box use /jeli severity [severity level number]
Aliases: /jeli severity
, /jeli set-severity
𤹠Assigning Incident Roles
Set or Update an incident commander: /jeli ic
Set or Update an incident commander: /jeli ic
Set or Update an incident commander: /jeli ic
Select to assign anyone in Slack as the main point of contact for incident coordination. Anyone can use this command in the incident channel to claim or pass off the incident commander responsibilities.
When an incident commander is set, we update the role in the overview and broadcast channels. We also ping the assignee in the incident channel with the role prompt configured in settings, and DM them the same prompt for easy reference.
To quickly assign without opening a dialog box use /jeli incident-commander [@username|me]
Aliases: /jeli incident-commander
, /jeli set-ic
Set or Update a communications lead: /jeli cl
Set or Update a communications lead: /jeli cl
Set or Update a communications lead: /jeli cl
Select to assign anyone in Slack as the main point of contact for incident communication. Anyone can use this command in the incident channel to claim or pass off the communication lead responsibilities. When a communications lead is set, we update the role in the overview and broadcast channels. We also ping the assignee in the incident channel with the role prompt configured in settings, and DM them the same prompt for easy reference.
To quickly assign without opening a dialog box use/jeli communications-lead [@username|me]
Aliases: /jeli communications-lead
, /jeli set-cl
š£ Updating an Incident
Update the status of an incident: /jeli status
Update the status of an incident: /jeli status
Update the status of an incident: /jeli status
Type an update on the current status of the incident to be sent to the incident channel and added to the update thread in the broadcast channels. Think of this like live-tweeting the incident, the status field has a limit of 240 characters.
To quickly update the status without opening a dialog box use /jeli status [type out status message before hitting enter]
Update the status of an incident: emoji or message shortcut
Update the status of an incident: emoji or message shortcut
Update the status of an incident: emoji or message shortcut
You can convert an existing Slack message from any channel into a status update with our message shortcut,
Or react to a message with the š£ :mega:
, š :pushpin:
, or š« :mailbox:
emoji to turn any message in the incident channel into a status update.
Aliases: /jeli status-update
Update an incidentās stage: /jeli stage
Update an incidentās stage: /jeli stage
Update an incidentās stage: /jeli stage
Incidents often donāt follow the same path every time. Throughout response you can change the stage of the incident as you gain new information and pivot into different efforts.
The bot will prompt you to add some context to what led to those changes, to help inform stakeholders and give you a record free of hindsight biases for your incident review.
Our stages are simple: Investigating, Identified, and Mitigated. Having an understanding of āwhere we are within the incidentā breaks the incident into smaller chunks and helps responders, both within engineering and on the customer communication side, reorient themselves around what new tasks they may be expected to perform in the next stage.
There is no single path to resolution: you can easily move back and forth between the stages as you gain new information and pivot your response.
Create follow ups: /jeli remind
Create follow ups: /jeli remind
Create follow ups: /jeli remind
Create follow ups to remind yourself or others to work on once impact is mitigated.
You can view them anytime with /jeli reminders
To quickly create a follow up without opening a dialog box use /jeli remind [me or @user] [type out follw up before hitting enter]
Create and link jira tickets: /jeli jira
Create and link jira tickets: /jeli jira
Create and link jira tickets: /jeli jira
Create new Jira issues and link existing issues. For more information see our docs on:
Create a Statuspage.io incident: /jeli statuspage
Create a Statuspage.io incident: /jeli statuspage
Create a Statuspage.io incident: /jeli statuspage
Use Jeliās Statuspage.io integration to share regular updates on your companyās status page to keep stakeholders and customers informed during an incident.
For more details, see our docs:
ā¹ļø Finding information during an incident
Get the overview for a current incident: /jeli info
Get the overview for a current incident: /jeli info
Get the overview for a current incident: /jeli info
Provides the full overview of the current incident, shown in the incident channel but is only visible to whomever runs the command. This will be shown automatically to everyone as they join the incident channel for the first time (it will only be visible to the individual who has just joined).
The incident overview is also what is visible in the broadcast channels and includes:
Incident Title
Incident Stage
When the incident was opened
Incident Severity
Link to the incident Slack channel
Summary
Assigned Incident Commander
Assigned Communications Lead
Added Links
And the most recent status update
Aliases: /jeli overview
Get the full list of statuses for an incident: /jeli history
Get the full list of statuses for an incident: /jeli history
Get the full list of statuses for an incident: /jeli history
Displays the most recent status update first and lists the entire status history in reverse chronological order. It is shown in the incident channel but is only visible to whomever runs the command.
The full list of status updates is also visible in a thread under the message containing the incident overview in the broadcast channels.
Aliases: /jeli status-history
Get a list of follow ups created: /jeli reminders
Get a list of follow ups created: /jeli reminders
Get a list of follow ups created: /jeli reminders
Displays the full list of followups created during the incident. It is shown in the incident channel but is only visible to whomever runs the command. From here you can edit follow ups and mark them as done.
Aliases: /jeli followups
, /jeli list-followups
, /jeli followups-list
Get a list of active incidents: /jeli active
Get a list of active incidents: /jeli active
Get a list of active incidents: /jeli active
Displays all active incident response using the Jeli IR bot in your Slack workspace.
Helpful for when youāre not sure if someoneās already opened an incident for an issue, if youāre tracking multiple incidents at a time, or even if you lost track of your incident slack channel in a sea of other incident slack channels.
Get a summary of all the status updates in an active incident: /jeli catch-up
Get a summary of all the status updates in an active incident: /jeli catch-up
Get a summary of all the status updates in an active incident: /jeli catch-up
This command is most handy when you are joining an active incident channel or are participating in an incident and want to catch-up on all the latest happenings.
Jeli will use the status updates in the incident channel to create an AI summarized write up of what's happened so far.
Aliases: /jeli ketchup
š£ Escalate an Incident
š Wrapping up an incident
Set an incidentās stage to mitigated: /jeli stage
Set an incidentās stage to mitigated: /jeli stage
Set an incidentās stage to mitigated: /jeli stage
When moving the incident to the mitigated stage, we also begin creating the Jeli opportunity for when youāre ready to begin your incident review. After you provide an optional reason for the stage change, you will be prompted with the option to rename the incident based on all of the information youāve gathered throughout response, and provide a new summary.
The new name and summary will be included in the opportunity created in Jeli, as well as updated in the broadcast channels in Slack. Changing the name of the incident will not change the name of the incident channel created in Slack.
Moving to the mitigated stage also means we will no longer send you status update reminders on your set intervals. We know that the time between mitigation and closing out an incident can be vary depending on your organizationās process, so feel free to take your time in this stage.
*Moving to the mitigated stage is not required to close out an incident, address followups, or create a Jeli opportunity. If you skip this stage, weāll still prompt you with those items upon closing. You can also move back into the identified or investigating stages from mitigated and continue response if need be. (Status reminder intervals will be restored if you return to either identified or investigating stages.)
Address follow ups
Address follow ups
Address follow ups
When an incident is moved to the mitigated stage, we send the incident channel the list of follow up items you asked us to remind you about throughout the incident. You can choose to schedule a reminder on a follow up and weāll ping you again about that item at the time of your choosing.
You can also mark the follow up as done, if youāve already gotten around to it, or edit the follow up to add more details or to remind someone else about that item.
*Scheduled reminders for follow ups will not ping to remind you if the follow up is marked as done, marked as ignored, or the incident is closed.
š Closing out an incident
Close out an incident in a mitigated stage: /jeli close
Close out an incident in a mitigated stage: /jeli close
Close out an incident in a mitigated stage: /jeli close
Moving an incident to closed ends Jeliās IR botās involvement in the incident channel. Since you have already mitigated the incident, closing it will look a little different than if you are closing it from an investigating or identified stage.
You will be prompted to fill out the close modal and any follow-ups you created during the incident will appear after you close the incident with options to:
"Schedule a reminder"
"Edit" the follow-up
"Mark Done" if you've completed the follow-up
We will update the Jeli opportunity with any messages sent in the incident channel since mitigation, and notify you when that is complete. We will also set the final status update with a link to the Jeli opportunity.
The broadcast channels will be updated as well, moving the incident stage to closed, setting an incident closed time, and linking to the Jeli opportunity.
Close out an incident in an investigating or identified stage: /jeli close
Close out an incident in an investigating or identified stage: /jeli close
Close out an incident in an investigating or identified stage: /jeli close
You can close out an incident at any stage, when closing out an incident that is in the investigating or identified stages.
You will be prompted with the option to rename the incident based on all of the information youāve gathered throughout response, update severity, provide a new summary and address any follow-ups. The new name and summary will be included in the opportunity created in Jeli, as well as updated in the broadcast channels in Slack.
Changing the name of the incident will not change the name of the incident channel created in Slack.
Jeli will prompt you when youāre closing out an unmitigated incident, and give you the option to instead change the stage of the incident to mitigated if youād like to do so.
Closing the incident will then ends Jeliās IR botās involvement in the incident channel, and creates an opportunity in Jeli for when youāre ready to begin your incident review. Jeli will then update the channel with a final status indicating that the incident is closed and provide a link to the Jeli opportunity.
The broadcast channels will be updated as well, moving the incident stage to closed, setting an incident closed time, and linking to the Jeli opportunity.
Aliases: /jeli close-incident
, /jeli end
, /jeli end-incident
š„· Running a demo incident
Run a demo incident: /jeli demo
Run a demo incident: /jeli demo
Run a demo incident: /jeli demo
Running a demo incident with Jeliās IR bot gives you all the same features as normal response, but we do not broadcast the incident, or upload the slack channel into Jeli once the incident is closed.
This is great for familiarizing yourself with Jeliās features without creating any false alarms. You can use it when running stress tests, gamedays, or mock incidents to practice response with your team!