서비스 맵¶

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

공간 범위¶

서비스 맵 페이지에 진입하면 시스템은 기본적으로 현재 워크스페이스 내의 서비스 노드와 호출 관계만 표시합니다. 교차 작업 공간 권한이 설정되지 않은 경우, 다른 워크스페이스의 서비스 노드, 호출 엣지 및 메트릭 데이터는 표시되지 않습니다.

현재 워크스페이스가 다른 공간의 데이터에 접근할 수 있도록 권한이 부여된 경우, 페이지 상단의 공간 범위 선택기를 사용하여 조회 범위를 전환할 수 있습니다.

현재 공간: 현재 워크스페이스의 서비스 맵만 표시합니다(기본값).
전체 공간: 현재 공간 및 접근 가능한 모든 공간의 서비스 맵을 표시합니다.
권한 부여 공간: 지정된 권한 부여 워크스페이스를 다중 선택하여 해당 공간의 서비스 맵을 조회합니다.

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

주의

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

SaaS 상용 플랜은 교차 공간 권한 설정을 통해 데이터 조회 범위를 구성합니다. 워크스페이스 소유자, 관리자 또는 교차 공간 권한 관리 권한이 있는 역할만 설정할 수 있습니다. 권한이 부여되면 권한을 부여받은 공간에서 ServiceMap의 해당 데이터를 조회할 수 있습니다. 권한이 취소되면 해당 워크스페이스는 더 이상 해당 소스 공간의 ServiceMap 데이터를 조회할 수 없습니다.
배포 플랜은 사이트 차원에서 데이터 조회 범위를 구성합니다.

단일 서비스¶

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

서비스 상세 정보 조회¶

기본으로 열리는 페이지에서는 현재 선택한 공간 범위 내 서비스 간의 호출 관계를 직관적으로 보여줄 뿐만 아니라, 서비스 노드를 클릭하면 사이드 슬라이드 패널을 통해 해당 서비스의 상세 정보를 확인할 수 있습니다. 주요 내용은 다음과 같습니다.

서비스 이름 및 해당 팀, 연락처, 알림 수 등
현재 서비스의 기본 메트릭: 요청 수, 오류율, 평균 응답 시간, P99/P95 응답 시간, 최대 응답 시간
현재 서비스의 업스트림/다운스트림, 서비스 개요, 관련 로그 및 트레이스 조회
메트릭(서비스 요청 응답 시간, 오류 요청 분포) 및 로그(오류 로그 수)의 이상 추세 그래프

토폴로지 관리¶

현재 서비스 맵 확대, 축소 또는 전체 화면으로 표시
서비스 노드 색상에 매핑할 성능 메트릭 선택 지원: 요청 수, P50/P75/P95/P99 응답 시간, 최대 응답 시간, 오류율
사용자 지정 색상: 선택한 채우기 메트릭에 대해 서비스 노드 색상 구간 범위 설정
사용자 지정 구간: 선택한 채우기 메트릭에 대해 서비스 노드 색상 구간 범위를 사용자 지정합니다. 시스템은 선택한 메트릭의 토폴로지 내 최대값과 최소값을 기준으로 5개의 값 구간을 자동으로 나누고, 각 구간에 색상을 할당합니다.
- 노드 크기: 노드 크기는 총 3가지입니다. 서비스 초당 요청 수의 최대값(Max) 과 최소값(Min) 을 3등분하여 생성된 3개의 구간이 3개의 그래픽 크기에 매핑됩니다.

주의

초당 요청 수가 0.01보다 작은 경우, 인터페이스에 표시되는 값은 < 0.01로 통일됩니다. 단, 노드 크기 계산은 여전히 실제 값을 기준으로 수행됩니다.

토폴로지 그래프 설정:
- 환경 및 버전 구분: 서비스(service) 및 서비스 환경 버전(service+env+version)의 두 가지 차원으로 트레이스 토폴로지 그래프를 생성합니다. 활성화하면 시스템은 환경 버전별로 서비스 맵을 생성합니다.
- "요청 수"를 기준으로 노드 크기 계산 여부
- 강조 표시 범위 선택: 직접 연결된 노드(업스트림/다운스트림)/전체 체인 연결 노드(다단계 업스트림/다운스트림)
- 필터 조건과 일치하는 서비스만 표시: 활성화하면 서비스 맵이 현재 필터 조건에 따라 서비스 노드를 필터링하여, 조건을 충족하는 서비스 노드만 유지하고 조건을 충족하지 않는 노드는 숨깁니다.

교차 공간 조회¶

전제 조건

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

동일한 Trace 데이터가 분할되어 여러 워크스페이스에 속하는 경우, 단일 워크스페이스에서 전체 트레이스 데이터를 조회할 수 없습니다. 교차 워크스페이스 Service Map 조회를 사용하면 데이터 조회의 연속성을 보장할 수 있습니다. 현재 워크스페이스에서 버튼을 클릭하여 현재 서비스의 업스트림/다운스트림 호출 토폴로지를 조회할 수 있습니다.

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

자세한 내용은 서비스 맵 데이터 소스 정의를 참조하십시오.