APM サービスマップ クロスワークスペース設定説明¶

デプロイメントプランでは、「アプリケーションパフォーマンスモニタリング（APM）> サービス > サービスマップ」のクロスワークスペースページエントリと、Kodo 側のサービスマップクロスワークスペースクエリ機能は、2 つの独立した設定で制御されます。それぞれのシナリオに応じて個別に設定することも、併用してページエントリとクロスワークスペースのトポロジクエリ機能を同時に提供することもできます。

設定項目説明¶

機能説明¶

enableApmServiceTopology はサイトレベルのページエントリスイッチです。有効にすると、デプロイメントプランのワークスペースがバージョンと権限の条件を満たした場合、サービスマップページにワークスペース範囲セレクターが表示され、現在選択されたワークスペース範囲に基づいてサービスノード、呼び出し関係、トポロジメトリクスをクエリできるようになります。

cross_workspace_on は Kodo 側のサービスマップクエリスイッチで、kodo-inner の ConfigMap に設定します。有効にすると、Studio バックエンドがサービスマップをクエリする際に、ユーザーが権限付与した対象ワークスペースを Kodo クエリパラメータに変換し、Kodo が対応するワークスペース範囲に基づいてサービスノードと呼び出しエッジを返します。

設定場所¶

Studio バックエンド¶

Launcher で Studio バックエンド設定を見つけ、対応する設定ファイルに以下を追加または変更します。

enableApmServiceTopology: true

この設定はデフォルトで無効です。true に設定すると、フロントエンドはデプロイメントプランのサービスマップページにクロスワークスペース選択エントリを表示します。

kodo-inner¶

Launcher で KodoInner 設定を見つけます。対応する Kubernetes ConfigMap は kodo-inner です。servicemap 設定セクションに以下を追加または変更します。

servicemap:
  cross_workspace_on: true

有効範囲¶

有効にすると、サービスマップページでは現在のワークスペース、アクセス可能なすべてのワークスペース、または指定された権限付与ワークスペースに基づいて ServiceMap データを表示できます。ページ内の検索、フィルター、サービス数統計、ノードの色、トポロジメトリクスはすべて、現在選択されているワークスペース範囲に基づいて計算されます。

クロスワークスペースの権限付与が設定されていない場合、ユーザーは現在のワークスペースのデータのみを表示でき、他のワークスペースのサービスノード、呼び出しエッジ、メトリクスデータをデフォルトで表示することはできません。

注意事項¶

• enableApmServiceTopology と cross_workspace_on は独立した 2 つのスイッチです。前者は Studio ページエントリを制御し、後者は Kodo 側のクロスワークスペーストポロジクエリ機能を制御します。デプロイメントシナリオに応じて個別に設定することも、併用することもできます。
• SaaS 商用プランのデータ可視範囲は、クロスワークスペース権限付与設定に準拠します。デプロイメントプランでは、上記のサイトレベル設定によって機能を有効にする必要があります。
• クロスサイトクエリを行う場合、1 回のクエリ内の対象ワークスペースはすべて同じ対象サイトに属している必要があります。
• 設定を変更した後は、デプロイメント環境の要件に従って、関連コンポーネントを再起動またはローリングアップデートして設定を反映させてください。

確認方法¶

1. 「APM > サービス > サービスマップ」に移動します。
2. ページ上部にワークスペース範囲セレクターが表示されることを確認します。
3. 権限付与された他のワークスペース、または複数のワークスペースを選択します。
4. トポロジグラフ、サービス数、呼び出し関係、メトリクスデータが選択したワークスペース範囲に従って更新されることを確認します。
5. 権限付与を解除するか、設定を無効にした後、他のワークスペースのエントリやデータにアクセスできなくなることを確認します。