Import Entities

문서 > Internal Developer Portal > Software Catalog > Set Up Software Catalog > Import Entities

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

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

You can use the Datadog’s Backstage plugin to map your Backstage entities into Datadog’s Software Catalog definition schemas. The plugin supports entity filtering so you can import only entities that meet certain criteria (for example, only entities with a specific Backstage component type, like services or repositories).

Import entity descriptor files from Backstage

Service panel highlighting backstage metadata, links and definition

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:

Backstage Field	Datadog Mapping
`kind:component` and `kind:system`	Datadog recognizes these; `kind:component` is recognized as a service
`metadata.name`	`dd-service`
`metadata.namespace`	Custom tag with format `namespace:${metadata.namespace}`
`spec.lifecycle`	`lifecycle`
`spec.owner`	`team`
`metadata.links`	`links`
Annotation `github.com/project-slug`	Link with `type=repo` and `url=https://www.github.com/${github.com/project-slug}`
Annotations `pagerduty.com/service-id` and `pagerduty.com/account`	Combined and mapped to `integration.pagerduty`
`metadata.description`	`description`
`spec.system`	`application`
`spec.dependsOn`	`dependsOn`
Other `spec` values	Mapped to custom tags

The Software Catalog processes the entire YAML file as a whole. If any section of the YAML file does not have kind:component or kind:system, the entire catalog-info.yaml file is rejected. Schema version v3.0 is required to use kind:system and the dependsOn field.

Example YAML for catalog-info.yaml

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.