自動発見 Datadog サービスカタログには、APM 、ユニバーサルサービスモニタリング の eBPF ベースのオートディスカバリーや RUM アプリケーションを通じて検出されたエントリが事前に登録されています。
APM を使用すると、Datadog はインスツルメンテーションされたサービスに対する依存関係、例えばデータベース、キュー、サードパーティ API などを、たとえその依存関係がインスツルメンテーションされていなくても自動的に発見できます。これらの未インスツルメンテーションの依存関係は、個別のサービス として分類されます。新しい推論エンティティ機能 を使用すると、データベース、キュー、サードパーティ API などのエンティティタイプごとにサービスカタログのエントリをフィルタリングできます。
自動検出されたサービスにメタデータを追加 サービスにオンコール、ソースコード、またはドキュメントを指定するには、UI や API、その他の自動化ツールを通じて、既存のサービスにメタデータを追加できます。推奨バージョンは 2.2 です。実験的な機能を試すには、リクエストを送信 し、スキーマ 3.0 のベータプログラムに参加できます。
サービス定義スキーマ (v2.2) (推奨) Service Definition Schema は、サービスの基本情報を格納する構造体です。GitHub にあるフルスキーマ を参照してください。
例 Copy
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 オンコールを取得) 他のアクションと連携させることで、重大なイベントに基づいたワークフローをトリガーできます (例: ランブックの実行)。 サービスの色を変更する サービスの色は、トレースの視覚化に使用されます。サービスタイプのアイコンをクリックして変更できます。
サービスタイプと言語を更新する サービスカタログメタデータスキーマ 2.2 を使用すると、ユーザー定義のサービスのタイプと言語を指定したり、インスツルメンテーションされたサービスの自動検出されたタイプと言語を上書きしたりできます。正確にラベル付けすることで、他のチームがそのサービスの機能や操作方法をより理解できるようになります。
参考資料