デフォルトカタログを強化

自動発見

Datadog サービスカタログには、APMユニバーサルサービスモニタリングの eBPF ベースのオートディスカバリーや RUM アプリケーションを通じて検出されたエントリが事前に登録されています。

APM を使用すると、Datadog はインスツルメンテーションされたサービスに対する依存関係、例えばデータベース、キュー、サードパーティ API などを、たとえその依存関係がインスツルメンテーションされていなくても自動的に発見できます。これらの未インスツルメンテーションの依存関係は、個別のサービスとして分類されます。新しい推論エンティティ機能を使用すると、データベース、キュー、サードパーティ API などのエンティティタイプごとにサービスカタログのエントリをフィルタリングできます。

自動検出されたサービスにメタデータを追加

サービスにオンコール、ソースコード、またはドキュメントを指定するには、UI や API、その他の自動化ツールを通じて、既存のサービスにメタデータを追加できます。推奨バージョンは 2.2 です。実験的な機能を試すには、リクエストを送信し、スキーマ 3.0 のベータプログラムに参加できます。

メタデータスキーマ v3.0 の非公開ベータ版にオプトインしましょう!

Request Access

サービス定義スキーマ (v2.2) (推奨)

Service Definition Schema は、サービスの基本情報を格納する構造体です。GitHub にあるフルスキーマを参照してください。

service.datadog.yaml

schema-version: v2.2
dd-service: shopping-cart
team: e-commerce
application: shopping-app
tier: "1"
type: web
languages:
  - go
  - python
contacts:
  - type: slack
    contact: https://yourorg.slack.com/archives/e-commerce
  - type: email
    contact: ecommerce@example.com
  - type: microsoft-teams
    contact: https://teams.microsoft.com/example
links:
  - name: Runbook
    type: runbook
    url: http://runbook/shopping-cart
  - name: Source
    type: repo
    provider: github
    url: https://github.com/shopping-cart
  - name: Deployment
    type: repo
    provider: github
    url: https://github.com/shopping-cart
  - name: Config
    type: repo
    provider: github
    url: https://github.com/consul-config/shopping-cart
  - name: E-Commerce Team
    type: doc
    provider: wiki
    url: https://wiki/ecommerce
  - name: Shopping Cart Architecture
    type: doc
    provider: wiki
    url: https://wiki/ecommerce/shopping-cart
  - name: Shopping Cart RFC
    type: doc
    provider: google doc
    url: https://doc.google.com/shopping-cart
tags:
  - business-unit:retail
  - cost-center:engineering
integrations:
  pagerduty:
    service-url: https://www.pagerduty.com/service-directory/PSHOPPINGCART
  opsgenie:
    service-url: "https://www.opsgenie.com/service/uuid"
    region: "US"
ci-pipeline-fingerprints:
  - id1
  - id2
extensions:
  additionalProperties:
    customField1: customValue1
    customField2: customValue2

サービスカタログのアクションを検索

サービスカタログに特化したすべてのアクションを確認するには、Datadog アクションカタログに移動します。そこで、必要なアクションをフィルタリングしてください。

  1. アクションカタログにアクセス: Datadog Workflow Automation 環境内でアクションカタログを探します。
  2. 検索機能: 検索バーを使って、“Service Catalog” (サービスカタログ) や “get service dependencies” (サービス依存関係を取得) など、特定のアクションに関連するキーワードを検索します。

利用可能なサービスカタログアクション

以下は、Datadog Workflow Automation のサービスカタログで利用可能なアクションの包括的リストです。このリストは、新しいアクションが追加されることで更新される可能性があります。

  • サービス情報の取得
    • “Get service definition” (サービス定義の取得) で単一のサービスの定義を取得します
    • “List service definitions” (サービス定義の一覧) で Datadog サービスカタログからすべての定義を取得します
    • “Get service dependencies” (サービスの依存関係を取得) でサービスの直接の上流および下流のサービスを取得します
  • インシデントのトリアージ
    • “Get service PagerDuty on call” (サービスの PagerDuty オンコールを取得)
    • 他のアクションと連携させることで、重大なイベントに基づいたワークフローをトリガーできます (例: ランブックの実行)。

サービスの色を変更する

サービスの色は、トレースの視覚化に使用されます。サービスタイプのアイコンをクリックして変更できます。

サービスアイコンをクリックして、別のアイコンカラーを選択します。

サービスタイプと言語を更新する

サービスカタログメタデータスキーマ 2.2 を使用すると、ユーザー定義のサービスのタイプと言語を指定したり、インスツルメンテーションされたサービスの自動検出されたタイプと言語を上書きしたりできます。正確にラベル付けすることで、他のチームがそのサービスの機能や操作方法をより理解できるようになります。

参考資料