Custom Entities

문서 > Internal Developer Portal > Catalog > Entity Model > Custom Entities

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

Overview

As of schema definition v3.0+, you can define custom entity types beyond the native types (such as service, datastore, or queue).

Custom entities allow you to represent any component or resource that is important to your organization but does not fit into the standard categories. For example, you might create custom entity types for libraries, pipelines, ML models, or infrastructure components.

See GitHub for full schema definitions.

Create a custom entity type

You can create custom entity types in Datadog or through the Catalog API. After creating the type, you can add entities of that type in Datadog or programmatically through the Catalog APIs, GitHub integration, or Terraform module.

In Datadog

Navigate to APM > Catalog, and click Manage.
Click Manage Custom Entity Types to view existing entity types, native and custom.
Click Add Custom Entity Type to add a type.

If you close the window and select Create New Entry, your custom type appears in the kind dropdown at the top of the pop-up window.

The Create New Entry pop-up window, showing the kind dropdown which includes custom entity types

Through the API

Alternatively, define your custom types through the Catalog API.

Example entity

In the following example, a user defines an entity of custom type library with links, tags, and owning teams:

entity.datadog.yaml

apiVersion: v3
kind: library
metadata:
  name: my-library
  displayName: My Library
  tags:
    - tag:value
  links:
    - name: shopping-cart runbook
      type: runbook
      url: https://runbook/shopping-cart
    - name: shopping-cart architecture
      provider: gdoc
      url: https://google.drive/shopping-cart-architecture
      type: doc
    - name: shopping-cart Wiki
      provider: wiki
      url: https://wiki/shopping-cart
      type: doc
    - name: shopping-cart source code
      provider: github
      url: http://github/shopping-cart
      type: repo
  contacts:
    - name: Support Email
      type: email
      contact: team@shopping.com
    - name: Support Slack
      type: slack
      contact: https://www.slack.com/archives/shopping-cart
  owner: myteam
  additionalOwners:
    - name: opsTeam
      type: operator