지도 위젯
지도 위젯 (Geomap Widget)
지도(Geomap) 위젯은 음영 처리된 영역(region)이나 포인트(point)로 지리적 데이터를 시각화해요. 다음과 같은 용도로 사용할 수 있어요:
- 국가별 사용자 세션 보기
- 새 탭에서 모든 세션 목록을 보도록 필터링
- 직원별로 필터링된 사용자 세션 보기
- 로드 시간, Core Web Vitals, 오류가 있는 보기 비율 같은 성능 메트릭 모니터링
- 매장이나 장치 같은 물리적 위치의 상태를 지도에 메트릭으로 표시해 모니터링
출처: 문서
본문
개요
지도 위젯은 음영 처리된 영역이나 포인트로 지리적 데이터를 시각화해요. 국가별 사용자 세션 보기, 필터링된 세션 목록 보기, 성능 메트릭 모니터링, 물리적 위치 상태 모니터링 등에 사용할 수 있어요.
설정
구성
- 시각화 레이어를 선택해요:
- Regions: 국가 또는 국가 하위 구역 수준에서 측정값을 집계해요.
- Points: 이벤트를 지도의 포인트로 오버레이해 지리적 이벤트 데이터를 표시해요.
- 그래프로 표시할 데이터를 선택해요. 참고: 데이터 소스 지원은 선택한 시각화 레이어에 따라 달라져요.
Regions 레이어의 데이터 소스:
| 데이터 소스 | 참고 |
|---|---|
| Log Events | group by 태그는 국가 ISO 코드(alpha-2 ISO 형식) 또는 국가 하위 구역 ISO 코드(ISO-3166-2 형식)를 포함해야 해요. GeoIP Processor를 사용하거나 수집 시 태그를 수동으로 포함할 수 있어요. 로그 이벤트 쿼리를 구성하려면 Log search 문서를 참조해요. |
| Metric | group by 태그는 국가 ISO 코드(alpha-2 ISO 형식) 또는 국가 하위 구역 ISO 코드(ISO-3166-2 형식)를 포함해야 해요. 수집된 로그에서 메트릭을 생성하거나 수집 시 태그를 수동으로 포함할 수 있어요. 메트릭 쿼리를 구성하려면 querying 문서를 참조해요. |
| RUM | RUM 쿼리를 구성하려면 RUM 문서를 참조해요. |
| SLO | SLO 쿼리를 구성하려면 SLO search 문서를 참조해요. |
| Security Signals / App and API Protection / Audit Trail | 쿼리를 구성하려면 Log search 문서를 참조해요. |
Points 레이어의 데이터 소스:
| 데이터 소스 | 참고 |
|---|---|
| Log Events | group by 태그는 alpha-2 ISO 형식의 국가 ISO 코드를 포함해야 해요. GeoIP Processor를 사용하거나 수집 시 태그를 수동으로 포함할 수 있어요. 로그 이벤트 쿼리를 구성하려면 Log search 문서를 참조해요. |
| RUM | RUM 쿼리를 구성하려면 RUM 문서를 참조해요. |
| Metric | 메트릭 쿼리에는 지리적 좌표가 포함되지 않아요. 메트릭을 표시하려면 위도와 경도 좌표를 제공하는 참조 테이블과 쿼리를 조인해요. "참조 테이블로 메트릭 표시"를 참조해요. |
참고: Points 레이어는 한 번에 최대 100,000개의 이벤트를 표시해요.
- (선택) Visual Options에서 Set widget default view 드롭다운을 사용해 지도를 처음에 어디에 초점을 맞출지 선택해요. Custom을 선택해 사용자 지정 영역을 정의하거나 국가, 주, 지방 이름을 검색해요.
참조 테이블로 메트릭 표시하기
메트릭 쿼리에는 지리적 좌표가 포함되지 않아요. Points 레이어에 메트릭을 표시하려면 위도와 경도 좌표를 제공하는 참조 테이블(reference table)과 메트릭 쿼리를 조인해요. 참조 테이블은 지도에 표시할 위치 이름 같은 메타데이터도 제공할 수 있어요.
- 대시보드에 지도 위젯을 추가하고 Points 레이어를 선택해요.
- 데이터 소스로 Metrics를 선택하고 메트릭 쿼리를 작성해요.
store_id같은 공유 키를 사용해 쿼리를 참조 테이블과 조인해요. 참조 테이블은 각 포인트의 위도와 경도, 그리고 표시하려는 메타데이터를 제공해요. 자세한 내용은 Reference Table Joins with Metrics를 참조해요.
또한 다음을 할 수 있어요:
- 메트릭 값을 기준으로 포인트 색상을 지정하고, 초록, 노랑, 빨강 같은 상태를 강조하는 색상 임계값을 정의해요.
- 참조 테이블의 추가 필드를 표시하도록 툴팁을 사용자 지정해요.
옵션
컨텍스트 링크
컨텍스트 링크는 기본적으로 활성화되어 있으며 켜고 끌 수 있어요. 컨텍스트 링크는 대시보드 위젯을 다른 페이지(Datadog 또는 서드파티)와 연결해 줍니다.
시각적 서식 규칙
조건 규칙으로 지도 위젯의 영역 레이어 색상을 사용자 지정해요.