Skip to main content

Use comments with incidents

The APEX AIOps Incident Management Comments feature lets you collaborate with other users and provides a place to share information about an incident. This feature lets you create a general comment, add a resolving step, and send announcements to a list of watchers (added through the Comments panel) associated with the incident. You can add comments, resolving steps, incident watchers, and announcements to any incident you have selected, either on the Incidents page or in the Situation Room.

For general information on the Comments feature, see Comments overview.

Access all comments

To view all comments associated with an incident, including resolving steps:

  1. Navigate to the Incidents page.

  2. Select an incident.

    NOTE: You can also access the Situation Room at this step.

  3. Click the Comments icon.

    ViewAllCommentsColumns.png

    A panel opens, displaying the comments for the incident.

Access resolving steps, announcements, and incident watchers

To view the items of a specific type:

  1. Navigate to the Incidents page.

  2. Select an incident.

    NOTE: You can also access the Situation Room at this step.

  3. Do one of the following to select the specific items to view:

    • Click the Resolving Steps icon.

      ViewResolvingStepsColumns.png
    • Click the Announcements icon.

      ViewAnnouncementsColumns.png
    • Click the Watchers icon.

      ViewWatchersColumns.png

    A panel opens, displaying the selected items for the incident.

Add a comment

To create a new comment:

  1. Access the comments for an incident.

  2. In the box provided at the bottom of the panel, type the text of your comment.

    • Only plain text entries are allowed, no formatting or other styling is supported.

    • Simple hyperlinks are supported.

  3. Click Post.

    NOTE: If you navigate away from the Comments panel without clicking Post, then your comment is discarded.

    After you click Post, your comment displays with the other comments posted for the selected incident.

Edit a comment

To edit a comment (including resolving steps):

  1. Access the comments or resolving steps for an incident.

  2. Locate the comment you want to change, and click the pencil icon in the comment box.

  3. Click Edit Comment in the menu.

  4. In the text box, make the changes to your existing comment.

  5. Click the check mark () icon to save and display your changes.

    Click the X icon to discard your changes.

Note

You can only edit your own comments.

Delete a comment

To delete a comment (including resolving steps):

  1. Access the comments or the resolving steps for an incident.

  2. Locate the comment you want to change, and click the pencil icon in the comment box.

  3. Click Delete Comment in the menu.

    A confirmation box displays.

  4. Click Delete to confirm you want to delete the comment.

    NOTE: Deleted comments cannot be restored. There is no undo option.

Note

You can only delete your own comments.

Work with resolving steps

You can perform the following tasks with resolving steps.

Add a resolving step

To add a step to the list of comments that you already know is a resolving step for the incident:

  1. Access the resolving steps for an incident.

  2. In the box provided at the bottom of the panel, type the text describing the resolving step.

    • Only plain text entries are allowed, no formatting or other styling is supported.

    • Simple hyperlinks are supported.

  3. Click Post Resolving Step.

    NOTE: If you do not click Post Resolving Step and you navigate away from the Comments panel, then your comment is discarded.

Identify an existing comment as a resolving step

To mark a comment already associated with an incident as a resolving step:

  1. Access the comments for an incident.

  2. Locate the comment that is a resolving step in the list.

  3. Click Mark resolving step inside the comment.

    MarkResolvingStep1.png

    The comment is now a resolving step. The icon turns green, and the comment displays with a green outline.

Revert a resolving step

To remove the resolving step identification from a comment:

  1. Access the comments or the resolving steps for an incident.

  2. Locate the resolving step in the list.

  3. Click the green Unmark resolving step icon inside the comment.

    The icon turns gray, and the green outline around the resolving step is removed.

    The comment is no longer considered a resolving step, and only displays as a regular comment.

Work with incident watchers and announcements

You can perform the following tasks with incident watchers and announcements.

Add a watcher

You can add Incident Management users and groups to a list of watchers who are associated with a particular incident. Watchers receive an email whenever an announcement is added for the incident.

  1. Access the watchers list for an incident.

  2. Click Add Watcher.

  3. Select a user or group from the Recent Users and Groups list, or search for a specific user or group at the top of the dialog.

  4. When you locate the right entity, click the + Add Watcher icon to the right of the name.

Note

Users can add themselves as watchers from the Incidents page. See Understand incidents.

Delete a watcher

Remove an Incident Management user or group from a list of watchers:

  1. Access the watchers list for an incident.

  2. Click the trash can icon to the right of the watcher name.

The watcher is removed from the list.

Add an announcement

Send an email to all of the watchers for a selected incident by sending an announcement:

  1. Access the announcements list for an incident.

  2. In the box provided at the bottom of the panel, type the text of your announcement.

  3. Click Send to N Watchers where N is the number of watchers currently added to the incident.

Your announcement is emailed to all of the watchers for the incident. If there are no watchers for the selected incident, the announcement is added to the list of comments, but no emails are sent.

Note

Because the users on the watchers list receive the announcements in their email, the content cannot be deleted or edited.