統合カタログ¶
統合カタログ（Unified Catalog）は、Guanceのアセット管理センターです。企業内のシステムサービス、クラウドリソース、インフラストラクチャエンティティを一元管理するために使用します。自動化されたアセット収集、柔軟なタイプ拡張、可視化された関係トポロジーを通じて、ユーザーが完全なアセットライフサイクル管理体系を構築し、アセットと可観測データの深い連携を実現します。
コア機能¶
1. 多チャネルアセット連携
自動検出、DataKit による報告、クラウドアセット収集、YAML 宣言の4つのデータソースをサポートし、サービス、ホスト、データベース、クラウドリソースなど多様なエンティティをカバーします。
2. 柔軟なタイプ拡張
システム、サービス、ホスト、データベース、クラウドリソースの5つの標準エンティティタイプがプリセットされており、カスタム拡張をサポートし、企業の個別のアセット管理ニーズに適応します。
3. 動的アセット管理
エンティティリストは、タイプに応じて動的に列定義をレンダリングし、カスタム表示フィールド、ワンクリックCSVエクスポートをサポートし、エンティティ数の統計とクイック追加機能を提供します。
4. 関係トポロジー分析
コールチェーンと依存関係に基づいてエンティティトポロジーを構築し、依存ビュー（呼び出し関係と包含関係を表示）と階層ビュー（帰属関係を表示）の2つの視点による分析、および全体アーキテクチャトポロジーの可視化をサポートします。
5. アセットと観測の連携
エンティティ詳細ページは、ログ、トレース、イベント、メトリクスなどの可観測データを自動的に関連付け、アセット情報から実行時データへの迅速なジャンプと障害特定を実現します。
データソース¶
統合カタログは、自動収集と手動入力のシナリオをカバーする4つのエンティティデータソースをサポートします。
| ソース方式 | 収集メカニズム | ユースケース |
|---|---|---|
| 自動検出 | APM トレースの Span から Service と呼び出し関係を自動的に導出 | マイクロサービスアーキテクチャにおけるサービス検出 |
| DataKit による報告 | ホストまたは K8s にデプロイされた DataKit Agent が直接収集して報告 | インフラストラクチャの管理 |
| クラウドアセット収集 | AWS、Alibaba Cloud などのクラウドベンダーAPIを定期的に同期し、RDS、S3、ECS などのメタデータを取得 | マルチクラウドリソースの一元管理 |
| YAML 宣言 | コードリポジトリ内の catalog-info.yaml ファイルで宣言（GitOps） |
開発プロセスと統合されたアセット管理 |
機能¶
統合カタログには、アセットの登録から関係分析までの全体的な管理をサポートする以下の機能が含まれています。
| モジュール | 機能説明 |
|---|---|
| エンティティリスト | アセットのメインリスト。動的列表示、カスタム表示項目、CSVエクスポート、エンティティの追加・削除・変更・検索、およびクイック追加をサポート |
| エンティティタイプ管理 | プリセットタイプとカスタムタイプを管理し、関連ビュー（組み込みビューとエクスプローラー）およびアイコン表示を設定 |
| トポロジービュー | ワークスペース内のエンティティ全体アーキテクチャ図を自動生成。フィルタリング、グループ表示、検索ハイライト、ビュー保存をサポート |
| エンティティ詳細 | スライドパネルでエンティティのメタデータ、連絡先、外部リンク、関係トポロジー（依存/階層）、および関連する観測データを表示 |
コア概念¶
エンティティ（Entity）¶
統合カタログにおける最小の管理単位であり、特定のシステム、サービス、ホスト、データベース、またはクラウドリソースのインスタンスを表します。各エンティティは一意のタイプ識別子と名前を持ち、詳細ページで完全なメタデータ、関係グラフ、および関連する観測データを確認できます。
エンティティ間では、以下の2つの関連付け方法をサポートします。
-
呼び出し関係：サービス間の呼び出し依存関係を表し、上流エンティティが下流エンティティを呼び出します。
-
包含関係：階層的な帰属関係を表し、子エンティティは親エンティティに帰属します。
エンティティタイプ（Entity Type）¶
エンティティを分類するための定義テンプレートであり、エンティティの属性フィールドと表示方法を決定します。システム、サービス、ホスト、データベースなどの標準タイプがプリセットされており、ユーザーによるカスタム拡張をサポートします。各タイプには、組み込みビュー、ログ、トレース、イベントなどのエクスプローラーを含む、統一された関連ビューを設定できます。