Skip to main content

Well-known Status fields of Catalog Entities

This section lists well known entity statuses, that have defined semantics. They can be attached to catalog entities and consumed by plugins as needed.

If you are looking to extend the statuses, see Extending the model.

Common Fields

The status object of an entity is currently left unrestricted, except for the items field. Its structure is defined in the descriptor format section.

We reserve the right to extend this model in the future. This status is in active development and its format will change unexpectedly. Do not consume it in your own code until such a time that this documentation has been updated.

Status Item Types

This is a (non-exhaustive) list of status.items.[].type values that are known to be in active use.

backstage.io/catalog-processing

Expresses an aspect of the current status of the catalog's ingestion of this entity. Errors that may appear here include inability to read from the remote SCM provider, syntax errors in the YAML file, and similar.

Note that the entity data itself may be of an older version, when errors are present. The ingestion system keeps the old valid entity data untouched when possible, so the errors described in this state may not seem to align with the rest of the entity, because they pertain to a remote that could not be successfully ingested. This is normal.

# Example:
status:
items:
- type: backstage.io/catalog-processing
level: error
message: 'NotFoundError: File not found'
error:
name: NotFoundError
message: File not found
stack: ...