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 detect 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. To include archived entities:- From the main sidebar, expand Catalogs, then select All entities.
-
At the top of the list, click Display.
- 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: