Entity reports

Entity reports allow you to create custom dashboards that appear directly on individual entity pages in your Software Catalog. Built on the same foundation as Data Studio Custom Reports, entity reports give you access to SQL queries, flexible visualizations, and dynamic variables—but scoped to the specific entity you’re viewing rather than displayed as a standalone page.

This per-entity approach makes it easy to surface contextual insights alongside your catalog data. For example, you might create an entity report that shows recent deployment history, error rates, or dependency health metrics for whichever entity you’re currently viewing.

Configuration

Entity reports are configured from the Catalog Settings page. To create a new entity report, navigate to Catalog > Settings and use the Entity Reports section.

Entity type assignment

Each entity report can be configured to display for one or more entity types. This allows you to reuse reports across different types of entities when appropriate. For instance, you might create a “Third-party dependencies” entity report that shows dependency analysis for both Services and Packages.

When you assign an entity report to multiple entity types, it will appear on the detail page for any entity of those types. The queries and visualizations you configure will automatically adapt to the entity being viewed through the use of entity-specific variables.

Variables

Entity reports automatically inject entity-specific variables into your queries, allowing your SQL to dynamically reference the current entity’s properties. The primary variable is $entity_identifier, which contains the unique identifier for the entity currently being viewed. Additionally, variables are available for each alias type configured on the entity type, making it easy to query data from connected systems.

These entity variables work similarly to other Data Studio variables, using simple substitution syntax in your SQL queries. However, unlike standard Custom Reports, the $service_ids variable is disabled in entity reports since the context is already scoped to a single entity.