Archiving entities

Overview

Archiving an entity in Cortex hides it from view without losing any of its history or data, so you can always restore it later. Entities can be archived manually (one at a time or in bulk) or automatically when Cortex no longer detects them in your integrations or their YAML file is deleted. All changes are recorded in your audit log.

Auto-archival applies to entities that are no longer backed by any discovery provider (e.g., Git, Kubernetes, your cloud account). If one reappears, it's unarchived automatically. Entities that failed to sync due to errors are skipped, so a temporary integration issue won't cause anything to disappear. Admins can disable this behavior to manage archiving manually instead.

Archived entities are not included in the following Cortex features:

• Scorecards and Initiatives

• Reports

• Eng Intelligence

• Cortex Query Language (CQL) features, including CQL reports and query builder

• Relationship graphs

• Workflows

Cortex tags detected changes to signify whether an entity or repository has been archived. Learn more in Viewing discovered entities.

Displaying archived entities in Cortex

Displaying archived entities in the Entities list

By default, archived entities do not appear in the All entities list, but you can choose to include them in your view.

This setting resets when you leave the page, so you'll need to toggle it on it each time you want to view archived entities.

To include archived entities:

1. From the main sidebar, expand Catalogs, then select All entities.

2. At the top of the list, click Display.

   
3. Toggle on Show archived.

Displaying an Archived label next to an entity

The Overview section on an entity's details page only shows active dependencies, child entities, and parent entities; anything archived is hidden. If the entity itself is archived, an Archived label appears next to its name: