Incident management is a process to restore a normal service operation as quickly as possible to minimize the business impact. The process is responsible for managing the lifecycle of all incidents. Incident management ensures that service quality is maintained as defined in the Service Level Agreement (SLA).

Incidents are events reported by monitoring applications or user queries that needs clarification. An incident is created when an intervention is required to restore agreed service to the business. The failure of a component of a service that has not yet impacted service is also an incident.

For example:

  • High CPU utilization in a server.
  • Failure of a sever or disk.

Configuring incident settings

Customize incident details by creating custom fields in addition to the predefined fields.

To configure incident settings:

  1. From All Clients, select the client.
  2. Go to Setup > Service Desk > Configuration > Settings.
  3. Click Incident.
  4. From INCIDENT SETTINGS, configure the property settings.
  5. Click Update.

Creating incidents

Incidents can be created using:

  • Service Desk
  • Email
  • Alerts
  • Closed incidents

Create incidents on Service Desk

To create a new incident on Service Desk:

  1. Select Service Desk from the drop-down menu.
  2. Click the + button and select Incident.
  3. On the New Incident page, provide the required information.
  4. Click Create.
Create New Incident

Create New Incident

Supported fields

Supported Fields
Field nameDescription
Partner NameSelect the partner.
Client NameSelect the Client.
SubjectTitle or short summary of Incident
DescriptionThe information required to describe Incident scenario. This can include the actual behavior, expected behavior, steps to reproduce the issue etc
Attach fileThe artifacts required to support Incident.

Example: error messages, screenshots, excerpt from log files.

Supported file types: `.txt`, `.jpg`, `.zip`, `.docx`, `.odt`, `.odg` and `.xlsx`. File size limit: 32 MB

Requested ByUser who requests Incident
Assignee GroupUser group that manages Incident
Assign toUser who acts on Incident
ResourcesDevices on which Incident is identified
CategoryCategory to which the Incident is mapped
Sub CategorySubcategory under the category to which the Incident is mapped
Business ImpactSeverity of Incident on the business
PriorityMeasure of how soon Incident needs to be resolved
Due dateExpected date to resolve Incident
Attach Problem/Change RequestAttach an existing Problem or Change Request that corresponds to Incident
ToEmail addresses of the users who need to act on Incident
CcEmail addresses of the users who need to be copied in the email notification

Creating incidents through email

To install a new email integration:

  1. Go to Setup > Integrations > Integrations.
  2. In the Available Integrations, click Email Requests.
  3. In the Install Email Requests Integrations screen:
    1. Provide a name of the integration.
    2. Specify Request Type as Incident.
    3. Upload an image file if required.
    4. Click Install.
  4. Click the copy icon in Incoming Email Address.
  5. While composing Incident email,  provide the following in the email fields:
    • To: Incoming Email Address
    • Subject: Incident subject
    • Email Body: Description of Incident
Incident Email Request

Incident Email Request

Create incident from alerts

To create an incident from an existing alert**

  1. Go to Alerts, click alert subject. Alert details page is displayed.
  2. In the Alert Details page, click Create Incident. The Create Incident window appears.
  3. In Create Incident window, provide the incident details.
  4. Click Save.
Alert Incident

Alert Incident

Creating incidents from closed incidents

If a closed incident needs to be reviewed or a similar issue needs to be reported, create a new incident and attach the closed incident to the same.


You need to activate Enable to create a follow-up Incident setting in the Incident Settings page to be able to view Create Follow-up option.

Enable Follow Up Incident

Enable Follow Up Incident

To create a follow-Up incident:

  1. Go to Service Desk, select a closed incident.
  2. Click Create Follow-Up.
  3. From the New Incident page, provide incident details.
  4. Click Create.
Create Follow Up Incident

Create Follow Up Incident

Viewing incidents

Incident details page provides the following attributes.

Incident Tab Description
ConversationsComments added by assignee or creator which can be viewed by all users in assignee group.
Activity LogUser activities on Incident.
ResourcesThe resources on which Incident is identified.
NotesUseful information or hint for Incident Resolution. Viewed by all users of assignee group.
To DoInformation recorded by a user for self-reference. Viewed  by single user.
PropertiesIncident details.
Status FlowThe flowchart representation showing Incident status change.
AlertsAlerts details corresponding to Incident.
ArticlesKnowledge Base articles that refer to the resolution of similar incidents in the past.
Attached Requests
  • Attach any related incidents.
  • View the attached incidents.
Integration LogThe inbound and outbound communication details between OpsRamp entities and third-party entities.

Editing incidents

To edit an Incident:

  1. Click Service Desk
  2. Click Incident. Incident details page appears.
  3. Click the Edit button and edit the required fields.

To edit multiple Incidents:

  1. Click Service Desk.
  2. Click the bulk update button and select the number of incidents to be edited.
  3. Select Apply Actions option. Update Actions window appears.
  4. Select the required changes and click Update.

Associating incidents to other entities

Linking incidents to problem or change request

Link an incident to a problem, change request or another incident while creating or editing the Incident.

To link an incident:

  1. Click Service Desk.
  2. Click Incident ID. The Incident Details page is displayed.
  3. In the right side pane of the Incident Details page, click Problem / Change Request or Link Incident.
    • Clicking Problem / Change Request opens Service Change Request window.
    • Clicking Link Incident opens Select Incident window.
  4. Select the required Request Id. The entity is attached to Incident.

Linking service requests to incidents

Link single or multiple service requests to an incident if there is an existing service request that has already been created and is relevant to your context. As service requests are resolved and closed, incident gets automatically closed.

To link a new Incident to existing Service Request:

  1. From the options in the drop-down menu, click Service Desk.
  2. Click New and then click Incident. The New Incident page is displayed.
  3. In the New Incident page, click Attach Service Requests. The Service Requests page is displayed.
  4. Select the required service request then click Create.

To link an existing Incident to Service Request

  1. Click Incident.
  2. Click Attached Requests, then click Add/Modify.
  3. Select the required service request and click Update.
Link Existing Incident to SR

Link Existing Incident to SR

Converting incidents to service requests

You can convert an incident to a service request if the entity conforms to the service request criteria.

To convert an incident to a service request:

  1. Click Incident.
  2. Click SR and then confirm.
  3. The Incident is converted to service request and the parent Incident number is shown.

Closing incidents

Configure Auto-Close Policies to close Incidents that are resolved and that are in inactive state since a certain elapsed time.

To add an Auto-Close Policy:

  1. Go to Setup > Service Desk > Auto Close Policies.
  2. From AUTO CLOSE POLICIES, select the client and click Auto Close Incidents.
  3. From EDIT AUTO CLOSE POLICY, provide the following:
    • Name: Name of the Auto-Close policy
    • Resolved Tickets Above: The inactive period of a resolved Incident beyond which the Incident needs to be closed
  4. Click Submit.