Customize the Service Catalog

Docs > Customize the Service Catalog

Service Catalog で、エンジニアリングチームのランディングエクスペリエンスをカスタマイズできます。Developer Home はベータ版の新しいパーソナライズドダッシュボードエクスペリエンスで、開発者が優先度の高いタスク、プルリクエスト、アラート、インサイトに 1 か所でアクセスできるように設計されています。

Developer Homepage エクスペリエンスのプライベートベータにオプトインしてください!

Request Access

自動発見

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

APM を使用すると、Datadog は、データベース、キュー、サードパーティ依存関係など、インスツルメント済みサービスの依存関係を、その依存関係がまだインスツルメントされていない場合でも自動的に検出できます。これらの未インスツルメントの依存関係は、個別の サービス として分類されます。Datadog は、インスツルメント済みサービスの依存関係を表すように、クライアントスパン (span.kind:client) の service 名を変更しました。例えば、サービス auth-dotnet から PostgreSQL データベースへのクライアントコールを表すスパンには、service:auth-dotnet-postgres というタグが付与されます。

APM を使用していて、Service Catalog や Service Map から自動命名された サービス を削除したい場合は、新しい推論済みエンティティエクスペリエンスにオプトインできます。これにより、データベース、キュー、サードパーティ依存関係などのエンティティタイプで Service Catalog のエントリをフィルタリングできます。必要に応じて、service:my-service-http-client のようなサービスオーバーライドを削除して、Service Catalog や Service Map から除外することもできます。

エンドポイントの検出については、APM でエンドポイントを検出するを参照してください。

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

サービスのオンコール、ソースコード、またはドキュメントを指定するには、UI、APIs、またはその他の自動化を使用して、既存の任意のサービスにメタデータを追加できます。推奨バージョンは 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 アクションカタログに移動します。そこで、必要なアクションをフィルタリングしてください。

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

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

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

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