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
  • Default catalogs
  • Custom catalogs
  • View catalogs
  • View catalog lists
  • The "All entities" page
  • Manage all catalogs
  • Create custom catalogs
  • Edit catalogs
  • Adding entities to catalogs
  • Configure catalog display

Was this helpful?

Export as PDF
  1. Ingesting data into Cortex

Managing Catalogs

Last updated 3 days ago

Was this helpful?

A catalog is a defined selection of . You can use catalogs to track and store information about all of the components that make up your infrastructure. This includes everything from services and domains to AWS S3 buckets and RDS, Google Cloud resources, or Azure Resources.

While entities are , catalogs themselves are not defined by a YAML file and must be created in the Cortex UI. Think of catalogs as a folder containing a collection of entities, with each entity defined by its own YAML file. An entity can belong to multiple catalogs, so you can also think of a catalog as a filter that defines which entity types to group together.

In the example screen shot below, the Services page contains a list of all entities that belong to the Service catalog:

Default catalogs

By default, Cortex comes with four built-in catalogs:

  • Infrastructure contains all entities representing your infrastructure assets.

You can choose to rename these catalogs to fit your own taxonomy, but note that the custom names of these default catalogs will not override the references to their default names throughout the app. Instead, you could choose to create additional custom catalogs.

Custom catalogs

View catalogs

Click Catalogs from the main nav to view your list of catalogs. You must have the View catalogs permission.

View catalog lists

When you click into a catalog, you can view all of the entities that belong to that catalog.

Include hierarchy in catalog list

If a catalog can be configured with a hierarchy (such as domains, teams, or custom catalogs based on relationship types), you can choose to include the hierarchy in the list view:

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

  2. Click Done.

The "All entities" page

All entities

All entity types

Manage all catalogs

This page will reflect the same list of catalogs you find in the Catalogs dropdown menu in the main nav.

Just like "All entities", "All catalogs" includes a search bar and a sort function, as well as a toggle for displaying or hiding Drafts.

From this page, you can create new catalogs and edit existing ones.

Create custom catalogs

You can create catalogs in the Cortex UI. For each catalog, you set the criteria that determines which entities belong to that catalog. In addition, you can define custom entity types to categorize the entities that live in your catalogs.

Because catalogs are not defined by a YAML file, it is not possible to create them via a GitOps workflow.

To create, edit, and delete catalogs, you must have the Edit catalogs permission.

To create a new catalog:

  1. At the top of the "All catalogs" page, click Create catalog.

  2. Configure the "Create catalog" form:

    • Name: Enter a name for the catalog.

    • Description: Optionally, enter a description of the catalog.

    • Display icon: an icon to appear alongside the catalog throughout the app.

    • URL: Enter a unique URL slug.

      • By default, the URL slug will be generated based on the catalog’s name, but you can use the URL field to create a custom slug.

    • Catalog filter: In this section, you can define the entities that are included in your catalog. All entities that match the criteria defined in this section will be automatically included in the catalog. You can use one filter to define a catalog page — choose an entity type or a relationship type.

      • Option 1: Entity Type: Catalogs can include a combination of any entity types, or can include just one type.

        • Choose whether to include or exclude the entity types you select.

        • Optionally, under "Advanced options," enter a specific CQL expression to fine-tune your catalog based on specific criteria.

      • Option 2: Relationship Type: Catalogs can include one relationship type.

    • Save as draft: Choose whether to save the catalog as a draft or publish it. Only admins and managers have the ability to view drafts.

  3. Click Create.

Once the catalog is created, you’ll find it under Catalogs > All catalogs, automatically populated with all entities that apply based on the entity types you've created. Catalogs with a relationship type filter can be displayed as a hierarchy.

Edit catalogs

To edit a catalog:

  1. In Cortex, go to Catalogs > All catalogs. Click into the catalog you want to edit, then click Edit catalog at the top of the page.

    • This will bring you back to the catalog creation page, with all the details from your last save.

  2. Make any changes necessary to the catalog.

  3. At the bottom of the page, click Save catalog.

Track catalog changes

The Action column will indicate whether a catalog was created, deleted, or updated.

Adding entities to catalogs

For the default catalogs, the entity type criteria is set by default:

  • The Services catalog contains service entity types

  • The Domains catalog contains domain entity types

  • The Teams catalog contains team entity types

  • The Infrastructure catalog contains any entities that are not the types service, domain, or team.

Configure catalog display

You must have the Configure appearance settings permission to configure the catalog display.

By default, catalogs will appear in alphabetical order, but you can manually adjust the order that the catalogs appear in the main nav.

Want to learn more? Check out the , available to all Cortex customers and POVs.

Services contains all .

Cortex pulls in resources directly from , , or , as their corresponding types out of the box. These resources are automatically added to the Infrastructure catalog.

Domains contains all and displays them in a hierarchical view.

Teams contains all and displays them in a hierarchical view alongside a leaderboard based on Scorecards.

To customize your Cortex instance to your organization's needs, you can also define custom catalogs in Cortex to represent your infrastructure. See below.

Enable the toggle next to Display hierarchy.

The "All entities" page includes entities across all catalogs and entities of all types, whether the entity is one of the or whether it is a . To access this page, go to Catalogs > All Entities.

To view all entity types, go to Catalogs > All Entities then click the .

Learn more about entities in .

On the , you’ll find all pre-defined and custom catalogs in Cortex.

You can use the to track changes made to any of your catalogs. Catalog updates will be listed as CATALOG in the Type column, and the updated catalog will be listed under the Entity column.

After an entity is imported or created, it will automatically belong to a catalog based on the entity type criteria set for each catalog. When you , you can set the entity type criteria.

By default, any you create will belong to the Infrastructure catalog. If you do not want the entity type to belong to this catalog, you can add the entity type to a different catalog.

Navigate to to drag and drop catalogs into your preferred order:

Cortex Academy course on Catalogs
service entities
AWS
Azure Resources
Google Cloud
domain entities
team entities
Entity types tab
Managing Entities
All catalogs page
audit log
Settings > Workspace > Main sidebar
Create custom catalogs
create a custom catalog
custom entity types
entities
default types
custom entity type
defined by YAML files
The services catalog displays a list of services.
Click "Catalogs" in the main nav to view catalogs.
The "All catalogs" page displays all catalogs in the workspace.
In the sidebar appearance settings, drag and drop catalogs to reorder them.