Creating and Managing Incidents
Create incidents to track and coordinate your team’s response to service disruptions or other issues.
Prerequisites
- Access to a project in Upstat
- At least one status configured in project settings
Creating an Incident
1. Open the New Incident Form
Navigate to Incidents and click New Incident.
2. Enter Incident Details
Fill out the main fields:
Title Enter a clear, descriptive title that summarizes the issue.
Description Use the rich text editor to add context. The editor supports Markdown formatting including headings, lists, code blocks, and links.
3. Configure Incident Properties
In the right panel, set:
Status Select the initial status from your project’s configured statuses.
Severity Choose the severity level that reflects the impact.
Incident Lead Assign a team member to lead the response. Select “Unassigned” if no lead is designated yet.
Reporter The person reporting the incident. Defaults to you but can be changed.
Labels Add labels to categorize the incident for filtering and reporting.
Affected Entities Link catalog entities that are impacted by this incident.
4. Save the Incident
Click Save to create the incident. You’ll be redirected to the incidents list.
Editing an Incident
1. Open the Incident
Click on any incident from the list to open its detail view.
2. Edit Fields
All fields are editable directly from the detail view:
- Click on the title to edit it inline
- Click on the description to edit with the rich text editor
- Use the dropdowns in the right panel to change status, severity, lead, or reporter
- Click on labels to add or remove them
Changes save automatically.
Result
Your incident appears in the incidents list and is visible to all project members. Team members can acknowledge, comment, and collaborate on the response.
Related
- Response Workflow - Learn about acknowledging incidents
- Severity and Status - Understanding incident statuses and labels
- Collaboration - Communicate during incidents