Overview

If you already have data or services registered in Backstage or ServiceNow, you can import these services into Datadog directly.

Entities from Backstage

Sync Backstage entities into Datadog Software Catalog

Use the Datadog Backstage plugin to automatically sync your Backstage catalog entities to the Datadog Software Catalog entity model on a configurable schedule. The plugin runs as a Backstage backend service and supports entity filtering (for example, you can sync only entities with a specific Backstage component type, such as services or repositories).

You need a Datadog API key, application key, and Datadog site parameter (for example, datadoghq.com) to configure the plugin. For installation and configuration instructions, see the plugin README.

Import entity descriptor files from Backstage

To import Backstage definitions:

• API or Terraform: Replace the YAMLs in your requests with Backstage YAMLs.
• GitHub integration: Save your Backstage YAMLs in a repository with Datadog read permissions. Datadog scans for files named catalog-info.yaml in your repositories.

During import, Datadog maps Backstage data to Datadog data:

Example YAML for catalog-info.yaml

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: artist-web
  description: The place to be, for great artists
spec:
  type: service
  lifecycle: production
  owner: artist-relations-team
  system: artist-engagement-portal
  dependsOn:
    - service:email-service

Import from ServiceNow

To populate your Datadog Software Catalog with services from your ServiceNow Configuration Management Database (CMDB), use the Service Ingestion feature in the Datadog-ServiceNow integration.

Further reading

Additional helpful documentation, links, and articles:

Import Backstage YAML files into DatadogBLOG Manage your infrastructure with ServiceNow CMDB and DatadogBLOG