APM 서비스 토폴로지 크로스 워크스페이스 구성 설명¶

배포 플랜에서 "애플리케이션 성능 모니터링(APM) > 서비스 > 서비스 토폴로지"의 크로스 워크스페이스 페이지 진입점과 Kodo 측 서비스 토폴로지 크로스 워크스페이스 조회 기능은 두 개의 독립적인 구성으로 제어됩니다. 두 구성은 시나리오에 따라 각각 설정하거나 함께 사용하여 페이지 진입점과 크로스 워크스페이스 토폴로지 조회 기능을 모두 제공할 수 있습니다.

설정 항목 설명¶

기능 설명¶

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은 두 개의 독립적인 스위치입니다. 전자는 Studio 페이지 진입점을 제어하고, 후자는 Kodo 측 크로스 워크스페이스 토폴로지 조회 기능을 제어합니다. 두 스위치는 배포 시나리오에 따라 각각 구성하거나 함께 사용할 수 있습니다.
• SaaS 상용 플랜의 데이터 가시 범위는 크로스 워크스페이스 권한 구성에 따릅니다. 배포 플랜에서는 위의 사이트 수준 구성을 통해 기능을 활성화해야 합니다.
• 크로스 사이트 조회 시 한 번의 조회에서 대상 워크스페이스는 동일한 대상 사이트에 속해야 합니다.
• 구성을 변경한 후에는 배포 환경 요구 사항에 따라 관련 구성 요소를 재시작하거나 롤링 업데이트하여 구성이 적용되도록 하세요.

검증 방법¶

1. "APM > 서비스 > 서비스 토폴로지"로 이동합니다.
2. 페이지 상단에 공간 범위 선택기가 표시되는지 확인합니다.
3. 권한이 부여된 다른 워크스페이스 또는 여러 워크스페이스를 선택합니다.
4. 토폴로지 맵, 서비스 수, 호출 관계 및 메트릭 데이터가 선택한 공간 범위에 따라 업데이트되는지 확인합니다.
5. 권한을 취소하거나 구성을 비활성화한 후 다른 워크스페이스의 진입점 또는 데이터에 더 이상 접근할 수 없는지 확인합니다.