로그 시각화 가이드: 차트 선택과 집계 기준
오류 로그 건수와 요청 실패율을 구분하고, 시간 범위와 집계 간격을 맞춰 원본 로그까지 확인할 수 있는 대시보드를 만듭니다.
결제 서비스 대시보드에서 5분간 발생한 오류 로그가 120건에서 180건으로 늘었다고 가정해 봅시다. 같은 두 구간의 요청 지표를 보면 처음에는 1,200건 중 24건, 다음에는 3,000건 중 30건이 실패했습니다. 오류 로그는 늘었지만 요청 실패율은 2%에서 1%로 낮아졌습니다. 두 차트는 서로 다른 대상을 셉니다.
로그 시각화는 수집한 이벤트를 집계해 변화와 차이를 살피고 원본 기록까지 찾아갈 수 있게 하는 작업입니다. 차트의 점 하나가 무엇을 세는지, 어느 시간대와 조건을 나타내는지부터 정합니다. 이 글의 수치는 설명을 위한 예시입니다.
무엇을 한 건으로 셀지 정한다
오류 로그 건수는 필터에 걸린 기록의 수입니다. 요청 하나가 재시도되거나 여러 서비스를 거치면 오류 로그를 여러 건 남길 수 있습니다. 샘플링되거나 수집에서 빠진 로그는 집계되지 않고, 중복으로 전달된 로그는 건수를 늘립니다. 오류 로그를 전체 로그로 나누면 수집된 기록에서 오류가 차지하는 비중을 알 수 있습니다. 요청 실패율을 구하려면 서비스, 환경, 시간 범위를 맞춘 뒤 실패 요청 수를 전체 요청 수로 나눕니다. 요청 메트릭이나 요청마다 결과를 한 건씩 남기는 완료 기록을 사용합니다. 분모가 0인 구간의 비율은 계산할 수 없습니다.
서비스 이름, 환경, 정규화된 심각도가 일관되면 같은 조건으로 다시 집계할 수 있습니다. 로그의 처리 시간으로 분포를 그릴 때는 값을 숫자로 파싱하고 단위를 맞춘 뒤, 실제로 값이 들어 있는 기록의 범위를 확인합니다. 원본 텍스트도 검색하거나 건수를 셀 수 있습니다. 구조화된 필드가 있으면 상태나 서비스로 일관되게 묶을 수 있습니다. 로그 형식 모범 사례
시간 범위와 집계 간격을 맞춘다
장애를 조사할 때는 차트와 로그 검색에 같은 절대 시작·종료 시각을 적용하고, 시각을 해석하는 시간대도 맞춥니다. 어떤 타임스탬프로 집계할지도 확인합니다. 이벤트 발생 시각을 기준으로 삼으면 늦게 들어온 로그가 앞선 구간에 포함되어 이미 본 값이 바뀔 수 있습니다. 소스 간 비교에 앞서 수집이나 가공 과정이 어느 시각을 저장하는지 확인합니다.
건수 추세를 볼 때는 같은 길이의 완료된 구간끼리 비교하고, '5분당 오류 이벤트'처럼 단위를 적습니다. 최신 구간은 아직 채워지는 중일 수 있습니다. 날짜별로 비교할 때는 시간대와 날짜 경계도 확인합니다. 차트가 비어 있는 이유는 조건에 맞는 로그가 없어서일 수도 있고, 수집 지연이나 중단 또는 필터에서 제외된 탓일 수도 있습니다. 빈 구간에 0을 넣기 전에 어떤 상황인지 확인합니다.
질문에 맞는 차트를 고른다
| 확인할 질문 | 적합한 보기 | 해석하기 전에 확인할 점 |
|---|---|---|
| 언제 오류 건수가 달라졌나? | 서비스별 시계열 | 집계 간격, 누락, 마지막 구간이 완료됐는지 |
| 어느 서비스에서 오류 기록이 많이 나왔나? | 순위 막대 또는 순위 목록 | 순위 기준, 시간 범위, 잘려 나간 그룹 |
| 서비스별 비중은 어떻게 되나? | 원형 차트 또는 트리맵 | 전체 범위와 표시되지 않은 그룹의 처리 방식 |
| 해당 구간에 어떤 기록이 남았나? | 상세 테이블 또는 필터링한 로그 목록 | 차트에서 넘겨받은 시간, 필터와 식별자 |
숫자 카드로 구간을 요약할 때도 시간 범위와 단위를 붙입니다. 트래픽이 큰 서비스는 실패율이 낮아도 오류 로그 순위에서 앞설 수 있습니다. 상위 10개 밖의 서비스에도 로그가 있을 수 있습니다. 비중을 구할 때는 화면에 보이는 10개 합계를 쓰는지, 전체 서비스 합계를 쓰는지 확인합니다. Guance 시각화 차트
로그를 확인한 뒤 대시보드를 만든다
Guance 로그 탐색기에서 인덱스, 소스와 실제 기록을 확인합니다. 이어서 대시보드에 시계열 차트를 만들고, 간단 쿼리나 DQL로 같은 범위를 지정합니다. 다음 예시는 DataKit과 필요한 Pipeline 처리를 거쳐 checkout 소스의 로그가 default 인덱스에 들어가고, env, status, service 필드가 채워져 있다고 가정합니다.
L("default")::checkout:(count(*) AS error_events)
{ `env` = "prod" AND `status` = "error" }
[1h:5m] BY service
이 쿼리는 최근 1시간 동안 조건에 맞는 행을 서비스별로 나누어 5분마다 집계합니다. count(*)는 선택 항목이 비어 있어도 조건에 맞는 행을 셉니다. 장애 구간을 대조할 때는 같은 절대 시간 범위를 씁니다. 서로 다른 시각에 실행한 두 '최근 1시간' 쿼리는 시작과 끝이 달라집니다. 대시보드 변수로 서비스나 환경을 바꾼 경우 로그 목록에도 같은 조건을 적용하고, 구간 하나를 골라 원본 기록과 대조합니다. 로그 탐색기 · DQL 구문(영어)
알림 조건은 탐지 규칙에 따로 설정한다
대시보드에서 급증을 확인한 뒤 알림이 필요한 조건을 Guance 로그 탐지에 설정합니다. 데이터의 범위는 차트와 맞추되, 평가 주기, 조회 구간, 임곗값, 알림 정책은 각각 정합니다. 매분 최근 5분을 확인하면 평가 구간이 서로 겹칩니다. 차트에 나란히 표시된 5분 구간과 결과가 다를 수 있습니다. 빈 결과와 늦게 도착한 데이터를 어떻게 처리할지 정하고, 알림에서 해당 서비스와 시각의 기록을 찾을 수 있게 합니다. 사용자 영향에 대해 알리려면 요청 결과와 트래픽도 근거로 삼습니다. Guance 로그 탐지 · 로그 모니터링
