You are viewing docs on Elastic's new documentation system, currently in technical preview. For all other Elastic docs, visit elastic.co/guide.

Create and manage cases

Learn how to create a case, add files, and manage the case over time.

Required role

The Editor role or higher is required to create and manage cases. To learn more, refer to Assign user roles and privileges.

Open a new case to keep track of issues and share the details with colleagues. To create a case in your Observability project:

  1. In your Observability project, go to Cases.

  2. Click Create case.

  3. Give the case a name, severity, and description.

    Tip

    In the Description area, you can use Markdown syntax to create formatted text.

  4. (Optional) Add a category, assignees, and tags.

    You can add users who are assigned the Editor user role (or a more permissive role) for the project.

  5. (Optional) Under External incident management system, you can select a connector to send cases to an external system. If you've created any connectors previously, they will be listed here. If there are no connectors listed, you can create one.

  6. After you've completed all of the required fields, click Create case.

Tip

You can also create a case from an alert or add an alert to an existing case. From the Alerts page, click the More options icon and choose either Add to existing case or Create new case, and select or complete the details as required.

Add files

After you create a case, you can upload and manage files on the Files tab:

To download or delete the file or copy the file hash to your clipboard, open the action menu (…). The available hash functions are MD5, SHA-1, and SHA-256.

When you upload a file, a comment is added to the case activity log. To view an image, click its name in the activity or file list.

Note

Uploaded files are also accessible under Project settings → Management → Files. When you export cases as saved objects, the case files are not exported.

You can add images and text, CSV, JSON, PDF, or ZIP files. For the complete list, check mime_types.ts.

File size limits

There is a 10 MiB size limit for images. For all other MIME types, the limit is 100 MiB.

Manage existing cases

You can search existing cases and filter them by attributes such as assignees, categories, severity, status, and tags. You can also select multiple cases and use bulk actions to delete cases or change their attributes.

To view a case, click on its name. You can then:

  • Add a new comment.
  • Edit existing comments and the description.
  • Add or remove assignees.
  • Add a connector (if you did not select one while creating the case).
  • Send updates to external systems (if external connections are configured).
  • Edit the category and tags.
  • Change the status.
  • Change the severity.
  • Remove an alert.
  • Refresh the case to retrieve the latest updates.
  • Close the case.
  • Reopen a closed case.

On this page