서비스 토폴로지¶

"서비스 토폴로지" 페이지에서는 토폴로지 뷰를 통해 각 서비스 간의 호출 관계를 직관적으로 확인할 수 있습니다.

공간 범위¶

서비스 토폴로지 페이지에 진입하면 기본적으로 현재 워크스페이스의 서비스 데이터를 조회합니다. 다른 워크스페이스의 서비스 상세 및 메트릭을 조회하려면 해당 데이터 액세스 권한이 필요합니다. 토폴로지 관계에 권한이 부여되지 않은 공간의 서비스 노드가 나타나면 해당 서비스의 제한된 상세 정보와 연결 데이터를 더 이상 확인할 수 없습니다.

현재 워크스페이스에 다른 공간의 데이터 액세스 권한이 부여된 경우 페이지 상단의 공간 범위 선택기를 통해 조회 범위를 전환할 수 있습니다.

현재 공간: 현재 워크스페이스의 서비스 토폴로지만 표시합니다(기본 옵션).
전체 공간: 현재 공간과 액세스 가능한 모든 공간의 서비스 토폴로지를 표시합니다.
권한이 부여된 공간: 권한이 부여된 워크스페이스를 다중 선택하여 해당 공간의 서비스 토폴로지를 확인합니다.

페이지의 검색, 필터, 서비스 수 통계, 노드 색상 및 토폴로지 지표는 모두 현재 선택된 공간 범위를 기준으로 실시간 계산됩니다. 현재 워크스페이스에 크로스 공간 권한이 없으면 페이지에 다른 공간 옵션이 표시되지 않습니다.

한 번의 조회에는 동일한 사이트의 워크스페이스만 포함될 수 있습니다. 다른 공간에 있는 동일 이름의 서비스는 각각의 소스에 따라 구분됩니다. 노드를 클릭하거나 상하위 서비스 및 연결 데이터를 확인할 때는 선택한 노드의 소스 공간을 사용하며, 현재 로그인 공간이나 첫 번째 선택 공간으로 대체하지 않습니다. 일반 조건은 APM 및 RUM 동일 사이트 크로스 공간 조회를 참조하세요.

주의

현재 서비스 토폴로지 데이터의 기본 지연 시간은 5분입니다. max_delay 파라미터를 통해 1~5분(분 단위) 범위에서 조정할 수 있습니다(❗️배포 플랜 사용자만 해당). 비즈니스 실시간성 요구에 따라 유연하게 설정할 수 있습니다.

SaaS 상용 플랜은 크로스 공간 권한 부여를 통해 데이터 표시 범위를 구성합니다. 워크스페이스 소유자, 관리자 또는 크로스 공간 권한 부여 관리 권한이 있는 역할만 구성할 수 있습니다. 권한이 적용되면 권한이 부여된 공간에서 ServiceMap의 해당 데이터를 확인할 수 있으며, 권한이 취소되면 해당 워크스페이스는 즉시 해당 소스 공간의 ServiceMap 데이터를 더 이상 확인할 수 없습니다.
배포 플랜은 사이트 차원에서 데이터 표시 범위를 구성합니다.

단일 서비스¶

단일 서비스 노드에 마우스를 올리면 해당 서비스 및 연결된 노드가 강조 표시되고, 관련 없는 서비스와 연결선은 회색으로 표시됩니다. 호버 지표 카드에는 해당 서비스의 요청 수, 오류율, 평균 응답 시간, P99/P95 응답 시간, 최대 응답 시간 등의 데이터가 표시됩니다.

서비스 상세 보기¶

기본으로 열리는 페이지에서 시스템은 현재 선택된 공간 범위 내 서비스 간 호출 관계를 직관적으로 표시할 뿐 아니라, 해당 데이터 액세스 권한이 있는 서비스 노드를 클릭하면 슬라이드 패널로 상세 정보를 확인할 수 있습니다.

서비스가 속한 공간의 권한 부여 상태	드릴다운 동작
현재 공간에 권한이 부여됨	해당 서비스가 속한 공간 기준으로 상세 정보를 조회합니다. 드릴다운 관점을 전환할 때 해당 서비스의 소스 공간을 유지합니다.
현재 공간에 권한이 부여되지 않음	현재 공간 선택을 유지하고 제한된 차트를 표시하지 않습니다. 상하위 서비스 보기 등 관련 작업은 비활성화되며, 호버 시 해당 공간에 권한이 부여되지 않았음을 안내합니다.

서비스 상세 정보에는 주로 다음 요소가 포함됩니다.

서비스 이름 등과 해당하는 팀, 연락처, 알림 수 등
현재 서비스의 기본 지표: 요청 수, 오류율, 평균 응답 시간, P99/P95 응답 시간, 최대 응답 시간
클릭하여 현재 서비스의 상하위 서비스, 서비스 개요, 연결된 로그 및 분산 추적 확인
지표(서비스 요청 응답 시간, 오류 요청 분포) 및 로그(오류 로그 수)의 이상 추세 차트

세션 리플레이 페이지에서 상세 정보를 연 후 연결된 Profile 상세로 계속 이동했다면, 상세 페이지의 돌아가기 항목을 사용하여 이전 단계로 돌아가 연결 데이터를 계속 확인할 수 있습니다.

토폴로지 관리¶

현재 서비스 토폴로지를 확대, 축소 또는 전체 화면으로 표시합니다.
서비스 노드 색상에 적용할 다양한 성능 지표를 선택할 수 있습니다. 요청 수, P50/P75/P95/P99 응답 시간, 최대 응답 시간, 오류율이 포함됩니다.
사용자 지정 색상: 선택한 "채우기 지표"에 대한 서비스 노드 색상 범위를 설정합니다.
사용자 지정 구간: 선택한 채우기 지표에 대한 서비스 노드 색상 구간 범위를 직접 정의합니다. 시스템은 선택한 지표의 토폴로지 내 최대값과 최소값을 기준으로 5개의 숫자 구간을 자동으로 나누며, 각 구간은 하나의 색상에 대응합니다.
노드 크기: 노드 크기는 총 3가지입니다. 서비스의 초당 요청 수 최대값(Max)과 최소값(Min)을 3등분하여 얻은 세 구간이 3가지 도형 크기에 대응합니다.

주의

초당 요청 수가 0.01보다 작으면 화면에 표시되는 값은 일괄적으로 < 0.01로 표시됩니다. 단, 노드 크기 계산은 실제 값을 기준으로 합니다.

토폴로지 뷰 구성:
- 환경 및 버전 구분: 서비스(service)와 서비스 환경 버전(service+env+version) 두 가지 차원으로 분산 추적 토폴로지 맵을 그립니다. 활성화하면 시스템이 환경 버전별로 서비스 토폴로지 맵을 그립니다.
- 서비스 그룹화: Kubernetes 클러스터, 환경 또는 서비스 태그를 기준으로 토폴로지 노드를 그룹화할 수 있습니다. 서로 다른 그룹은 독립된 영역으로 표시되며, 그룹 간 호출은 여전히 연결선으로 표시됩니다.
  
  서비스 상세의 "서비스 토폴로지 > 전체 경로" 뷰에서도 그룹화 기능을 사용하여 호출 관계를 확인할 수 있습니다.
- 프로젝트별 동일 이름 서비스 구분: 활성화하면 시스템이 project 속성에 따라 동일 이름의 서비스를 분리합니다. 서비스 이름은 같지만 project가 다른 데이터는 서로 다른 노드로 표시되며, project가 설정되지 않은 데이터는 "프로젝트 미설정"으로 분류됩니다.
- 노드 크기를 "요청 수"에 따라 계산할지 여부
- 호버 강조 범위 선택: 직접 연결 노드(상하위 서비스)/전체 트레이스 연결 노드(다단계 상하위 서비스)
- 필터 조건과 일치하는 서비스만 표시: 활성화하면 서비스 토폴로지가 현재 필터 조건에 따라 서비스 노드를 필터링하여 조건에 맞는 서비스 노드만 남기고 조건에 맞지 않는 노드를 숨깁니다.

크로스 공간 조회¶

크로스 공간 드릴다운은 선택한 서비스의 소스 공간을 사용하며, 목록으로 돌아갈 때 원래 조회 범위를 유지합니다. 데이터 권한 구성은 워크스페이스 간 권한 부여를 참조하세요.

전제 조건

모든 상용 플랜 워크스페이스는 동일한 조직 ID에 속합니다. 즉 organization이 동일합니다.

동일한 Trace 데이터가 분산되어 서로 다른 워크스페이스에 속하게 되면 이때 하나의 워크스페이스에서 전체 트레이스 데이터를 확인할 수 없습니다. 그러나 워크스페이스 간 Service Map 조회는 데이터 조회의 연속성을 보장하므로, 현재 워크스페이스에서 버튼을 클릭하기만 하면 현재 서비스의 상하위 호출 토폴로지를 확인할 수 있습니다.

데이터 소스 정의 및 DQL 조회¶

자세한 내용은 서비스 토폴로지 데이터 소스 정의를 참조하세요.