사용자 에이전트 통계
클라이언트 환경 분석
목차
- 개요
- 주요 지표
- 화면 구성
- 상호작용 기능
- 예외 상황 처리
- 연관 메뉴
- 실전 예시
1. 개요
사용자 에이전트 통계란?
사용자 에이전트(브라우저, OS)별 접속 현황을 집계 분석하는 도구
언제 사용하나요?
- 사용자 브라우저 점유율을 파악할 때
- 특정 브라우저 호환성 이슈를 분석할 때
- 모바일/데스크톱 사용 비율을 확인할 때
- OS별 사용자 분포를 파악할 때
해결하는 문제
사용자 에이전트별로 집계된 데이터를 통해 어떤 브라우저와 OS를 사용하는지, 특정 환경에서 문제가 발생하는지 신속하게 파악할 수 있습니다.
2. 주요 지표
핵심 성능 지표
| 지표 | 의미 | 정상 범위 |
|---|---|---|
| 총 방문자수 | 기간 내 총 방문자 수 | 서비스별 상이 |
| 총 세션수 | 기간 내 총 세션 수 | 서비스별 상이 |
| 평균 세션 시간 | 방문자별 평균 체류 시간 | 길수록 좋음 |
| 이탈률 | 단일 페이지 방문 후 이탈 비율 | 낮을수록 좋음 |
3. 화면 구성
ObjectSelector란?
모니터링할 오브젝트(서버, 서비스, 인스턴스)를 선택하는 컴포넌트
위치: 화면 좌측 사이드바
주요 기능:
- 오브젝트 트리 탐색
- 다중 오브젝트 선택
- 오브젝트별 필터링
사용법: 단계 1: ObjectSelector 버튼을 클릭하세요 단계 2: 트리에서 원하는 오브젝트를 체크하세요 (다중 선택 가능) 단계 3: 선택된 오브젝트 수가 버튼에 표시됩니다
오브젝트 상태 정보:
- 전체 실행 개수: 현재 실행 중인 오브젝트 수
- 라이선스 없는 개수: 라이선스 없이 실행 중인 오브젝트 수
- 전체 정지 개수: 정지된 오브젝트 수
3계층 레이아웃 구조:
1층 (검색 조건 영역)
- 날짜 범위 선택
- 서버 선택 드롭다운
- 검색 버튼
- 리셋 버튼
2층 (오브젝트 목록 영역)
- ObjectSelector (오브젝트 목록): 모니터링 대상 오브젝트 목록
- noPadding 옵션 적용 (최대 공간 활용)
- 오브젝트별 필터링 지원
3층 (컨텐츠 영역)
- 상단 요약 정보: 총 방문자수, 총 세션수, 평균 세션 시간, 이탈률
- 하단 차트 영역: 일별 차트 + 파이 차트 + 상세 테이블
- 일별 차트: 날짜별 사용자 에이전트 추이
- 파이 차트: 브라우저/OS별 점유율
- 상세 테이블: 에이전트별 상세 통계
특징:
- ThreeLayerLayout 기반 3계층 구조
- 차트/테이블 동적 분할 (6:6)
- fill 옵션 적용 (남은 공간 채움)
- 파이 차트: 브라우저/OS별 점유율 시각화
초기 상태 안내
⚠️ 중요 사항 ⚠️ 중요: 오브젝트를 선택하지 않으면 화면이 비어있는 것이 정상입니다. 빈 화면인 경우:
- ObjectSelector에서 모니터링할 오브젝트를 선택했는지 확인하세요
- 오브젝트가 등록되어 있는지 확인하세요 데이터가 표시되지 않는 경우:
- 선택한 오브젝트가 데이터를 수집 중인지 확인하세요
- 시간 범위를 조정해 보세요
4. 상호작용 기능
날짜 범위 검색
단계 1: 1층 검색 조건 영역에서 날짜 범위를 선택하세요
단계 2: 서버를 선택하세요
단계 3: "검색" 버튼을 클릭하세요
오브젝트 필터링
단계 1: 2층 오브젝트 목록 영역에서 필터링할 오브젝트를 선택하세요
단계 2: 다중 선택 가능
단계 3: 선택된 오브젝트의 통계만 3층 컨텐츠 영역에 표시됩니다
상세 테이블 토글
단계 1: 3층 컨텐츠 영역에서 상세 테이블 토글 버튼을 클릭하세요
단계 2: 차트와 테이블이 6:6 비율로 분할됩니다
단계 3: 다시 클릭하면 차트가 전체 화면을 차지합니다
파이 차트 확인
- 브라우저별 점유율 파이 차트
- OS별 점유율 파이 차트
- 디바이스별 점유율 파이 차트
특수 기능
User Agent 클릭 → XLOG 다이얼로그 연동:
- 상세 테이블에서 특정 User Agent 행을 클릭하면 XLOG 다이얼로그가 열립니다
- 자동 필터링: 선택된 User Agent(userAgentHash)로 자동 필터링된 XLOG 표시
- 환경 분석: 특정 브라우저/디바이스의 트랜잭션 패턴 분석
- 문제 격리: 특정 환경에서만 발생하는 이슈 신속 식별
사용 예시:
- 상세 테이블에서 문제가 되는 User Agent 찾기
- 해당 행 클릭 → XLOG 다이얼로그 자동 오픈
- 해당 User Agent의 모든 트랜잭션 확인
- 환경별 성능 차이 및 에러 패턴 분석
5. 예외 상황 처리
⚠️ 중요 사항
⚠️ 자주 발생하는 문제
문제: 데이터가 표시되지 않음 원인: 날짜 범위가 너무 짧거나 오브젝트가 사용자 에이전트 데이터를 수집하지 않음 해결: 날짜 범위를 넓히고 오브젝트 데이터 수집 상태를 확인하세요 문제: 특정 브라우저 데이터만 표시됨 원인: 오브젝트 필터링이 활성화됨 해결: ObjectSelector에서 필터를 초기화하거나 모든 오브젝트를 선택하세요 문제: 파이 차트에 "Unknown"이 너무 많음 원인: 사용자 에이전트 파싱 오류 또는 봇 트래픽 해결: 봇 트래픽을 필터링하거나 사용자 에이전트 파싱 로직을 개선하세요 문제: 구버전 브라우저 사용자가 너무 많음 원인: 특정 브라우저에서만 호환성 문제 발생 해결: 해당 브라우저 호환성을 개선하고 업데이트를 권장하세요
6. 연관 메뉴
함께 사용하면 좋은 메뉴:
| 메뉴 | 함께 사용하는 이유 |
|---|---|
| 방문자 통계 | 시간대별/일별 방문자 추이 분석 |
| 클라이언트 IP 통계 | 지역별 사용자 분포 파악 |
| URL 통계 | 특정 브라우저의 서비스 이용 패턴 분석 |
7. 실전 예시
시나리오: IE 브라우저 호환성 문제 해결
상황: Internet Explorer에서만 페이지 렌더링 오류 발생
해결 과정:
- 사용자 에이전트 통계 1층에서 최근 30일 날짜 범위 선택
- 서버 선택 후 검색 실행
- 3층 요약 정보에서 총 방문자수 확인
- 파이 차트에서 IE 사용자가 5% 차지하는 것 확인
- 상세 테이블에서 IE 버전별 분포 확인 (IE 11: 3%, IE 10: 2%)
- 에러 통계와 연계하여 IE에서 에러가 3배 더 많은 것 확인
- IE 호환성을 위한 폴리필 추가 및 CSS 수정
- 사용자 에이전트 통계에서 IE 에러율 개선 확인
결과: IE에서 에러율 15% → 2%로 개선
이 페이지가 도움이 되었나요?