Marketplace統合：ツールのライブデータをアーキテクチャ上に
先月、あるチームが7つのブラウザタブで本番インシデントをデバッグする様子を見ました。Datadogでメトリクス。GitHubでデプロイ履歴。SonarQubeで品質ゲート。ArgoCD でPodの実行バージョン確認。そして背景のどこかに、別のタブに座っているアーキテクチャ図。完全に正確で、完全に静的で、目の前の問題には完全に役に立たない。
図はシステムが何であるかを教えてくれました。どういう状態かは教えてくれませんでした。
Marketplace統合はそのギャップを埋めるために構築しました。
アイデア
アーキテクチャ図はすでにシステムの地図です。システムの稼働状況を見る場所でもあるべきではないでしょうか？
ArchylのMarketplaceは外部サービスを接続し、プロジェクトダッシュボード上にライブウィジェットとしてデータを表示できます。スクリーンショットやリンクではなく、30秒ごとにリフレッシュされる実際のライブデータです。
接続できるもの
7つの製品でローンチしました：Datadog、GitHub、GitLab、Prometheus、SonarQube、ArgoCD、PagerDuty。
各製品は複数のウィジェットタイプ（カウンター、ステータスバッジ、リスト、タイムシリーズ、埋め込みiframe）をサポートします。
仕組み
3つのレイヤー：コネクションは組織レベル。ウィジェットはプロジェクトレベル（または要素レベル、組織レベル）。グリッドはウィジェットが視覚的に存在する場所で、名前付きセクションのある12カラムドラッグ＆ドロップレイアウトです。
なぜダッシュボードではなくウィジェットか
Datadogにはダッシュボードがあります。Grafanaにもあります。もう1つのダッシュボードツールは必要ありません。必要なのは正しいコンテキストで正しいデータを見ること——そのコンテキストはアーキテクチャです。
3つのスコープ
組織全体ウィジェットはすべてのプロジェクトで表示。プロジェクトスコープウィジェットは特定プロジェクトのみ。要素スコープウィジェットはC4要素に直接アタッチ。
何が変わるか
以前：システムの運用状態を理解するには複数ツールを開きデータを相互参照。以後：1つのワークスペースを開く。アーキテクチャが何が存在するか教えてくれる。ウィジェットが状態を教えてくれる。リリースが何を出荷したか教えてくれる。ADRがなぜ構築されたかを教えてくれる。
1箇所。1つのコンテキスト。タブ切り替えなし。
はじめかた
- 組織設定 > Marketplaceに移動
- 製品を接続
- プロジェクトの統合タブを開く
- カスタマイズ、ウィジェットを追加をクリック
- コネクション、ウィジェットタイプ、設定を選択して完了
セットアップ全体で5分もかかりません。
他の機能がどのようにアーキテクチャを生き生きさせるか知りたいですか？デプロイ追跡はリリース管理、API仕様の図へのリンクはAPIコントラクトをご覧ください。