히트맵
히트맵은 완료된 트랜잭션의 응답 시간 분포를 원하는 기간으로 조회하는 메뉴입니다. 종합 현황 대시보드와 AI 에이전트 메인 대시보드의 히트맵 위젯이 조회 시각까지 10분 구간만 보여 주는 것과 달리, 날짜와 기간을 지정해 느린 트랜잭션이나 에러가 몰린 구간을 찾을 수 있습니다. 찾은 구간을 드래그하면 그 구간의 트랜잭션을 LLM 트레이스 상세에서 바로 분석할 수 있습니다.
좌측 사이드바에서 분석 > 히트맵을 클릭하여 이동합니다.
화면 구성
| 영역 | 설명 |
|---|---|
| 옵션바 | 시간 선택, 애플리케이션, 조회 버튼으로 조회 조건을 설정합니다. |
| 히트맵 트랜잭션 | 조회 기간에 완료된 트랜잭션의 응답 시간 분포를 표시합니다. |
조회하기
-
시간 선택에서 조회할 기간을 지정합니다.
-
이전에 선택한 시간(다른 화면에서 선택한 시간 포함)이 브라우저에 남아 있으면 그 시간을 기준으로 열리고, 없으면 오늘 0시부터 24시까지가 선택됩니다.
-
조회 기간 옆에 표시된 기간 길이(예: 1일)를 클릭하면 나오는 목록에서 최근 5분, 최근 10분, 최근 1시간, 최근 7일, 최근 14일과 오늘, 어제, 7일 전의 하루(00 ~ 24h)를 바로 고를 수 있습니다.
-
실시간 조회는 지원하지 않습니다.
-
-
애플리케이션에서 조회 대상을 고릅니다. 애플리케이션을 개별로 고르거나, 표시 기준 을 종류별 또는 서버별로 바꿔 묶음 단위로 고를 수 있습니다. 아무것도 고르지 않으면 전체 애플리케이션을 조회합니다.
-
애플리케이션 오른쪽의 조회 버튼(돋보기 아이콘)을 클릭합니다. 메뉴로 처음 들어오면 빈 차트만 보이며, 조회 버튼을 클릭해야 데이터가 표시됩니다.
차트 읽기
히트맵 트랜잭션 차트는 가로축에 트랜잭션 종료 시각, 세로축에 응답 시간(경과 시간)을 두고, 각 칸에 해당하는 트랜잭션 건수를 색으로 표시합니다. 위쪽 칸일수록 응답이 느린 트랜잭션입니다.
-
정상 트랜잭션은 파란색으로 표시하며, 같은 칸의 건수가 많을수록 진한 파란색이 됩니다.
-
에러가 한 건이라도 있는 칸은 에러 색으로 표시하며, 그 칸의 에러 건수가 많을수록 노란색, 주황색, 빨간색 순으로 바뀝니다.
차트 오른쪽 위의 도구는 다음과 같습니다.
| 도구 | 설명 |
|---|---|
| 건수 | 조회 기간의 정상 트랜잭션 건수와 에러 트랜잭션 건수를 차례로 표시합니다. |
| Y축 자동 | 켜면 데이터를 불러올 때마다 Y축 최댓값을 5초부터 다시 정하고, 위쪽 칸에 트랜잭션이 몰려 있으면 80초까지 한 단계씩 넓힙니다. |
| 에러 | 켜면 에러 트랜잭션만 표시합니다. |
| 위·아래 화살표 | Y축 최댓값을 5초, 10초, 20초, 40초, 80초 중에서 한 단 계씩 바꿉니다. 화살표로 직접 바꾸면 Y축 자동은 꺼집니다. |
| 왼쪽·오른쪽 화살표 | 조회 기간과 같은 길이만큼 이전 구간 또는 다음 구간으로 이동해 다시 조회합니다. 다음 구간의 끝은 조회 기간이 1시간 이하이면 현재 시각을, 1시간보다 길면 오늘 24시를 넘지 않습니다. |
구간 분석
차트에서 영역을 드래그하면 그 영역에 들어온 트랜잭션 목록이 LLM 트레이스 상세 새 창으로 열립니다. 창 위쪽에는 "트레이스 분석 N건 조회되었습니다."가 표시됩니다.
-
드래그한 시간 범위와 응답 시간 범위가 그대로 조회 조건이 됩니다.
-
에러를 켠 상태에서 드래그하면 에러 트랜잭션만 조회합니다.
-
애플리케이션에서 애플리케이션을 개별로 골라 조회했다면 그 애플리케이션의 트랜잭션만 조회합니다.
-
다시 조회하거나 왼쪽·오른쪽 화살표로 구간을 옮기면 이전에 드래그한 선택 영역은 지워집니다.
종류별 또는 서버별로 골라 조회한 상태에서 드래그하면 애플리케이션 조건 없이 프로젝트 전체를 기준으로 열립니다. 이 경우 목록에 차트에서 본 것보다 많은 트랜잭션이 나올 수 있습니다.
LLM 트레이스 상세에는 구간의 트랜잭션 목록이 표시되고, 목록에서 트랜잭션을 선택하면 오른쪽에 상세가 열립니다. 상세는 레코드 요약, 테이블 뷰, 트라잭토리 뷰 탭으로 구성됩니다. 탭별 내용은 LLM API 분석 문서를, 트라젝토리의 실행 흐름은 트라젝토리 뷰와 중지 문서를 참조하세요.
참고: APM 히트맵과의 차이
AI Agent Observability의 히트맵은 히트맵 트랜잭션 차트 하나만 제공합니다. APM 히트맵 화면에 있는 애플리케이션 목록과 트랜잭션 목록 위젯, AI 분석은 없으며, 트랜잭션 분석은 드래그로 여는 LLM 트레이스 상세에서 합니다.