---
title: Backstage
description: Embed Datadog dashboards and graphs into your Backstage instance.
breadcrumbs: Docs > Integrations > Backstage
---

# Backstage
Supported OS Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

## Overview{% #overview %}

[Backstage](https://backstage.io) is an open platform for building Developer Portals. This integration enables you to embed Datadog graphs and dashboards into your Backstage instance. To sync Backstage catalog entities to the Datadog Software Catalog, use the [Datadog Backstage plugin](https://docs.datadoghq.com/internal_developer_portal/software_catalog/set_up/import_entities.md#sync-backstage-entities-into-datadog-software-catalog).

## Setup{% #setup %}

### Installation{% #installation %}

1. Install the Datadog plugin into Backstage:

   ```shell
   cd packages/app
   yarn add @roadiehq/backstage-plugin-datadog
   ```

1. Add the Datadog plugin widget to your Backstage Overview tab. See the [detailed instructions](https://roadie.io/backstage/plugins/datadog/) for more information.

1. Find or create the [public URL](https://docs.datadoghq.com/dashboards/sharing.md#share-a-dashboard-by-public-url) for your Datadog dashboard.

1. Add the dashboard URL to the plugin's metadata:

   ```yaml
   apiVersion: backstage.io/v1alpha1
   kind: Component
   metadata:
     name: sample-service
     description: |
       A sample service
     annotations:
       datadoghq.com/dashboard-url: <DATADOGURL>
   ```

### Verification{% #verification %}

Open your Backstage instance Overview tab to confirm your Datadog dashboard or graph is rendered as expected.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The Backstage integration does not include any metrics.

### Service Checks{% #service-checks %}

The Backstage integration does not include any service checks.

### Events{% #events %}

The Backstage integration does not include any events.

## Troubleshooting{% #troubleshooting %}

Need help? Reach out to the [Backstage Community](https://backstage.io/community).