マーケットプレイス連携
マーケットプレイスでは、外部サービスをArchylに接続し、そのデータをアーキテクチャダッシュボード上のライブウィジェットとして表示できます。デプロイメントの監視、コード品質の追跡、メトリクスの監視、セキュリティアラートのレビューがC4モデルと並べて直接行えます。
概要
マーケットプレイス連携は3つの層で動作します:
- プロダクト — 連携可能な外部サービス（Datadog、GitHub、SonarQubeなど）
- コネクション — プロダクトのAPIと認証する組織スコープの資格情報
- ウィジェット — コネクションからのライブデータを表示する、プロジェクトダッシュボード上の視覚カード
1つのコネクションで異なるプロジェクトの複数のウィジェットを動かせます。ウィジェットは30秒ごとに自動更新されます。
対応プロダクト
Datadog
インフラストラクチャとアプリケーションの健全性を監視。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| モニターステータス | ステータス | タグでフィルタされたDatadogモニターの健全性状態 |
| メトリクスクエリ | カウンター | Datadogメトリクスクエリの現在値 |
| アクティブアラート | リスト | 現在トリガーされているモニターのリスト |
| ダッシュボード埋め込み | 埋め込み | 埋め込みDatadogダッシュボードまたはノートブック |
GitHub
リポジトリ、ワークフロー、セキュリティ検出を追跡。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| ワークフローステータス | ステータス | 最新のCIワークフロー実行状態 |
| オープンプルリクエスト | リスト | ステータスバッジ付きのアクティブPR |
| リポジトリ統計 | カウンター | スター、フォーク、Issue、PR数 |
| Dependabotアラート | リスト | 依存関係の脆弱性アラート |
| シークレットスキャンアラート | リスト | リポジトリで検出されたシークレット |
| コードスキャンアラート | リスト | CodeQLまたはサードパーティのコードスキャン結果 |
Prometheus
メトリクスのクエリとターゲットの監視。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| インスタントクエリ | カウンター | PromQLクエリの現在値 |
| 範囲クエリ | グラフ | 設定可能な範囲の時系列折れ線グラフ |
| ターゲットアップステータス | ステータス | ジョブ名によるスクレイプターゲットの健全性 |
SonarQube
コード品質とセキュリティ分析を追跡。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| 品質ゲートステータス | ステータス | プロジェクト品質ゲートの合否状態 |
| プロジェクト指標 | カウンター | カバレッジ、バグ、脆弱性、コードスメル、技術的負債等 |
| Issue | リスト | 重要度別のバグ、脆弱性、コードスメル |
ArgoCD
Kubernetesアプリケーションデプロイメントを監視。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| アプリケーションステータス | ステータス | 単一アプリの健全性と同期状態 |
| アプリケーションリスト | リスト | 健全性と同期インジケーター付きの全アプリ |
| アプリケーションリソース | リスト | 特定アプリのKubernetesリソース |
PagerDuty
インシデント、オンコールスケジュール、サービス健全性を監視。
| ウィジェット | タイプ | 説明 |
|---|---|---|
| インシデントステータス | ステータス | トリガーおよび確認済みインシデントの概要 |
| アクティブインシデント | リスト | 緊急度とサービス付きの現在アクティブなインシデント |
| オンコール中 | リスト | 現在オンコールのチームメンバー |
コネクションの設定
コネクションは組織レベルで管理されます。組織管理者のみが作成・変更可能です。
1. マーケットプレイスに移動
組織設定に移動し、マーケットプレイスタブを選択します。
2. コネクションの追加
- 接続したいプロダクトを見つける
- 接続をクリック
- コネクション名を入力（例: 「本番 Datadog」、「GitHub - バックエンドリポジトリ」）
- 必要な資格情報を入力
3. コネクションのテスト
保存前にコネクションをテストをクリック。Archylが資格情報を検証し、成功またはエラーメッセージを表示します。
4. 保存
テストに合格したら保存をクリック。コネクションは組織内のすべてのプロジェクトで利用可能になります。
ウィジェットの追加
ウィジェットはコネクションからのライブデータをプロジェクトダッシュボードに表示します。
1. 統合タブを開く
プロジェクト内の統合ビューに移動。カスタマイズをクリックして編集モードに入ります。
2. ウィジェットの追加
- ウィジェットを追加ボタンをクリック
- ステップ1 — コネクションを選択: 使用するコネクションを選択
- ステップ2 — ウィジェットタイプを選択: ウィジェットタイプを選択
- ステップ3 — 設定: ウィジェットタイトルとプロダクト固有のオプションを設定
ベストプラクティス
コネクションに明確な名前を付ける
環境と目的を示すわかりやすい名前:
- 「Datadog — 本番」
- 「GitHub — バックエンドチーム」
- 「SonarQube — メインプロジェクト」
セクションで整理
関連するウィジェットをセクションにグループ化:
- 「監視」: DatadogとPrometheusウィジェット
- 「セキュリティ」: SonarQubeとGitHubセキュリティスキャンウィジェット
- 「CI/CD」: ワークフローステータスとデプロイメントウィジェット
ステータスウィジェットから始める
ステータスウィジェットで健全性の概要を素早く把握。重要なメトリクスを特定したら、カウンターやリストウィジェットを追加。
次のステップ
- リリース管理 — アーキテクチャ全体のデプロイメント追跡
- アーキテクチャインサイト — アーキテクチャの問題を検出
- フロー — データがシステムをどのように流れるかを可視化