LogoLogo
Login to CortexBook a DemoCortex Academycortex.io
  • Cortex Docs
  • Cortex Quick Start
  • Ingesting data into Cortex
    • Managing Entities
      • Adding entities
        • Add services
        • Add domains
        • Add teams
        • Add custom entity types
        • Defining dependencies
      • Entity details page
      • Defining ownership
      • Defining relationship types
      • Grouping entities
      • Adding external documentation
      • Adding Deploy data
      • Adding custom data
      • Viewing discovered entities
      • Archiving entities
      • Relationship graph
      • Using On-call Assistant for incidents
      • Managing Terraform infra in Cortex
    • Managing Catalogs
    • Integrations
      • Internally hosted integrations
      • ArgoCD
      • AWS
      • Azure DevOps
      • Azure Resources
      • BambooHR
      • Bitbucket
      • BugSnag
      • Buildkite
      • Checkmarx
      • CircleCI
      • ClickUp
      • Codecov
      • Coralogix
      • Custom webhook integrations
      • Datadog
      • Dynatrace
      • Entra ID (Azure AD)
      • FireHydrant
      • GitHub
      • GitLab
      • Google
      • Grafana
      • incident.io
      • Instana
      • Jenkins
      • Jira
      • Kubernetes
      • LaunchDarkly
      • Lightstep
      • Mend
      • Microsoft Teams
      • New Relic
      • Okta
      • Opsgenie
      • PagerDuty
      • Prometheus
      • Rollbar
      • Rootly
      • Sentry
      • ServiceNow
      • Slack
      • Snyk
      • SonarQube
      • Splunk Observability Cloud (SignalFx)
      • Splunk On-Call (VictorOps)
      • Sumo Logic
      • Veracode
      • Wiz
      • Workday
      • xMatters
  • Scorecards
    • Initiatives and Action items
      • Creating issues based on Initiatives
    • Scorecard rule exemptions
    • Scorecard rule filters
    • Scorecard examples
    • Scorecards as code
  • Reports
    • Executive report
    • All Scorecards report
    • Bird's eye report
    • Progress report
    • Report card
  • Eng Intelligence
    • Custom Metrics
    • Jira Metrics
    • Metrics Explorer (Beta)
  • Cortex Query Language (CQL)
    • Using CQL reports
    • Using JQ in Cortex
  • Workflows
    • Creating a Workflow
      • Workflows as code
    • Blocks
    • Running a Workflow
    • Registering a Scaffolder template
      • Scaffolder advanced usage
    • Using a Workflow to sync in ArgoCD
    • Kicking off a Jenkins pipeline in a Workflow
    • Calling internal service endpoints in a Workflow
  • Plugins
    • Creating a plugin
      • Creating a plugin proxy
    • Migrating Backstage plugins to Cortex
  • Engineering homepage
  • Workspace Settings
    • Using GitOps for Cortex
      • GitOps logs
    • Managing users
      • Roles and permissions
        • Custom roles
        • Team ownership entity editing
      • Configuring SSO
        • Microsoft Entra ID
        • Google
        • Other OIDC providers
        • Okta
          • Okta SCIM
      • Configuring identity mappings
      • Onboarding management
    • API keys, secrets, and tokens
      • Secrets
      • Personal tokens
    • Audit logs
    • Entity settings
      • Data verification
      • Auto archiving entities
    • IP allowlist
    • Notifications
      • Notification logs
    • Customizing your workspace
    • Using search in Cortex
  • Cortex API
    • REST API operations
      • API Keys
      • Audit Logs
      • Catalog Entities
      • Custom Data
        • Custom Data (Advanced)
      • Custom Events
      • Custom Metrics
      • Dependencies
      • Deploys
      • Discovery Audit
      • Docs
      • Eng Intel: User Labels
      • Entity Relationship Types (Beta)
      • Entity Relationships (Beta)
      • Entity Types
      • GitOps Logs
      • Groups
      • Initiatives
      • Integrations APIs
        • Azure Active Directory (Entra ID) API
        • Azure Resources API
        • AWS API
        • Azure DevOps API
        • CircleCI API
        • Coralogix API
        • Datadog API
        • GitHub API
        • GitLab API
        • incident.io API
        • LaunchDarkly API
        • New Relic API
        • PagerDuty API
        • Prometheus API
        • SonarQube API
      • IP Allowlist
      • Notification Logs
      • On call
      • Packages
      • Plugins
      • Queries
      • SCIM
      • Scorecards
      • Secrets
      • Team Hierarchies
      • Teams
      • Workflows
Powered by GitBook
On this page
  • Enable default entity auto-archival settings
  • Enable auto archival per entity type
  • Trigger an entity sync
  • FAQ and Troubleshooting

Was this helpful?

Export as PDF
  1. Workspace Settings
  2. Entity settings

Auto archiving entities

Last updated 1 month ago

Was this helpful?

Cortex can auto archive entities when they are no longer detected in your integrations or whose corresponding YAML files are deleted. For example, if you use AWS to auto-hydrate your catalogs, enabling this feature will automatically archive entities that are deleted in AWS.

We recommend enabling this feature to keep your data up-to-date without manual effort.

It is also possible to manually archive entities. See for more information on manually archiving entities and how archived entities are handled in Cortex.

Cortex checks every day at 7 a.m. UTC for any affected entities, and skips archiving if any errors are detected.

Enable default entity auto-archival settings

To configure the default auto-archival settings for new entity types:

  1. In Cortex, navigate to .

  2. Under "Auto-archiving entities by type," enable the toggle for the setting you want to enable:

    • Enable integration-based auto-archiving for new entity types by default

      • Enable this setting if you want to enable the feature for integration-based archiving. Cortex will automatically archive and un-archive entities based on their existence in a third-party integration.

      • Cortex checks for a deleted or archived repo in your integration. To prevent an entity from being un-archived, make sure you have deleted the associated repo. The entity will be removed the next time the archival sync runs.

      • This option is recommended if you use microservices that all live in different repos.

    • Enable GitOps based auto-archiving for new entity types by default

      • Enable this setting if you want to enable the feature for GitOps-based archiving. Cortex will automatically archive entities if their corresponding YAML file is deleted.

      • If the file is moved rather than deleted, it will not be archived from Cortex. Cortex checks for files that have been deleted.

      • This option is recommended if you use a monorepo.

An cannot be overwritten; attempting to update the x-cortex-tag value via GitOps will create a new entity. The entity will only automatically archive if its original YAML file no longer exists in your Git environment.

To change an entity's x-cortex-tag, you must archive or delete the entity then create a new entity with the desired tag.

Enable auto archival per entity type

Below the option to enable auto archival, all of the entity types (default and custom) are listed alongside a toggle setting. You can enable the toggles individually for each entity type based on your preferred archival option.

Trigger an entity sync

Deleted entities will continue to appear until the next time the auto-archival sync runs. You can also manually trigger the sync:

  1. In the upper right corner, click Import entities, then choose Import discovered entities.

  2. Choose an integration.

    • Entities will automatically sync on the next page.

FAQ and Troubleshooting

Why is an entity unexpectedly re-appearing after it has been archived?

If you are using the integration-based auto-archiving, Cortex is checking whether the entity exists in your third-party integration. When Cortex runs the background sync for entity discovery, if the repo connected to that entity still exists, Cortex will un-archive the entity. To prevent un-archival, you can either delete the associated repo, or you can use the GitOps-based auto-archiving instead.

Why is an entity still appearing after I deleted the YAML file for it or deleted the associated repo?

Navigate to .

The auto-archival feature runs once a day, at 7 a.m. UTC. The entity will continue to appear until the next time the auto-archival sync runs or until you .

Catalogs > All entities
manually trigger the sync
Archiving entities
Settings > Entities > General
entity's x-cortex-tag
Enable auto archive per entity type