로그 및 분석
CDN 트래픽, 캐시 적중률, 상태 코드, 지역별 정보를 확인하고 개별 요청을 조회하며 사이트 진단을 실행합니다.
CDN 통계는 에지 노드가 기록하는 액세스 로그를 기반으로 생성됩니다. 계정 전체의 트래픽 분석 페이지, 각 도메인의 트래픽 분석 탭, 방화벽 페이지의 WAF 분석 및 이벤트 로그 탭에서 확인할 수 있습니다. 각 도메인에는 구성 문제를 해결하기 위한 진단 도구도 있습니다.
액세스 로그가 에지에서 분석 시스템으로 전달되기까지 시간이 조금 걸리므로 최근 몇 분간의 트래픽은 아직 표시되지 않을 수 있습니다.
계정 전체 트래픽 분석
CDN → 트래픽 분석으로 이동합니다. 콘솔 URL은 /cdn/analytics입니다.
- 도메인 필터: 기본적으로 모든 CDN 도메인의 합계를 표시합니다. 대신 단일 도메인을 선택할 수 있습니다.
- 시간 범위: 기본값은 최근 7 days입니다. 초 단위까지 지정할 수 있습니다.
페이지에는 다음 항목이 표시됩니다.
| 항목 | 내용 |
|---|---|
| 총트래픽 | 지정한 시간 범위 동안 에지가 방문자에게 보낸 응답 본문의 바이트 수 |
| 총요청 수 | 에지가 처리한 요청 수 |
| 캐시 적중률 | 전체 요청 중 에지 캐시에서 응답한 요청(HIT 또는 STALE)의 비율 |
| 국가/지역 수 | 트래픽이 발생한 국가 또는 지역의 수 |
| 상위 도메인 | 도메인별 트래픽, 요청 수, 캐시 적중률 |
| 지역별 트래픽 | 국가 또는 지역별 트래픽 및 요청 수 |
| 상위 URL | 쿼리 문자열을 제외하고 요청이 가장 많은 경로 |
| HTTP 상태 코드 | 상태 코드별 요청 수 |
| 브라우저 | User-Agent를 통해 식별한 브라우저 |
도메인별 트래픽 분석
도메인을 열고 트래픽 분석을 선택합니다. 콘솔 URL은 /cdn/domains/<domain>/traffic입니다. 오른쪽 위에서 시간 범위를 선택합니다. 기본값은 최근 7 days입니다.
개요
- 총요청 수, 총트래픽, 캐시 적중률, 평균 응답 시간입니다. 평균 응답 시간은 에지가 요청을 처리하는 데 걸린 시간이며 seconds 단위로 표시됩니다.
- 2xx 성공, 3xx 리디렉션, 4xx 클라이언트 오류, 5xx 서버 오류의 요청 수입니다.
- 경로별 요청 수와 트래픽을 보여 주는 상위 URL입니다.
- HTTP 상태 코드별 내역입니다.
5xx 응답이 급증하면 보통 원본 서버에 문제가 있는 것입니다. 아래의 진단을 실행하여 에지가 원본 서버에 연결할 수 있는지 확인합니다. 4xx 응답이 증가하면 방화벽의 이벤트 로그에서 보안 규칙이 요청을 차단하는지 확인합니다.
지역별 정보
세계 지도와 국가·지역 목록에 각 지역의 요청 수와 트래픽이 표시됩니다. 방문자의 위치는 클라이언트 IP 주소를 기준으로 결정됩니다.
요청 조회
선택한 시간 범위 내에서 개별 액세스 로그 항목을 조회합니다.
- 요청 ID(정확히 일치), URI(포함), 상태 코드, 클라이언트 IP 필터 중 필요한 항목을 입력합니다.
- 조회를 클릭합니다. 결과는 최신순으로 나열되며 페이지당 20, 50, 100 또는 200개 항목이 표시됩니다.
- 항목의 상세 보기를 클릭하면 다음 정보를 확인할 수 있습니다.
- 기본 정보: 시간, 호스트, 메서드, 상태, 전체 URL, 스킴, 클라이언트 IP, 요청 및 응답 크기, 소요 시간, 캐시 상태입니다.
- 요청 헤더: User-Agent, Referer, X-Forwarded-For, Accept-Language 등입니다.
- 응답 헤더: Content-Type, Cache-Control, ETag, Last-Modified 및 원본 서버가 반환한 값입니다.
- 업스트림: 원본 서버 주소, 원본 응답 상태, 연결·헤더 수신·응답 소요 시간입니다.
- SSL: TLS 프로토콜 버전과 암호 스위트입니다.
- 지역 정보: 국가, 지역, 도시, ISP, ASN입니다.
- CDN: 요청을 처리한 노드와 캐시 상태입니다.
모든 응답에는 X-Request-ID 헤더가 포함되며, 이 값이 여기서 사용하는 요청 ID입니다. 문제 해결이나 지원팀 문의 시 이 값으로 특정 요청을 찾을 수 있습니다.
WAF 분석 및 이벤트 로그
보안 이벤트는 방화벽 페이지에 있습니다. WAF 및 보안을 참조합니다.
- WAF 분석에는 총이벤트 수, 차단 수, 공격 IP, 실행된 규칙이 표시됩니다. 이벤트 타임라인, 가장 많이 실행된 규칙, 주요 공격 IP도 제공됩니다. 최근 1 hour, 24 hours, 7 days, 30 days 중 선택하거나 사용자 지정 범위를 설정할 수 있습니다.
- 이벤트 로그에는 차단, 챌린지 또는 요청 속도 제한이 적용된 각 요청이 표시됩니다. 동작, IP, URI로 필터링할 수 있습니다. 항목을 펼치면 규칙 ID, 규칙 유형, 메시지, 일치한 키와 값을 확인할 수 있습니다.
진단
도메인을 열고 진단을 선택합니다. 콘솔 URL은 /cdn/domains/<domain>/diagnostics입니다.
- 확인할 호스트 이름을 선택합니다.
- 진단 시작을 클릭하고 완료될 때까지 기다립니다.
진단은 아래 검사를 실행합니다. 각 검사는 설명과 함께 통과, 정보, 경고 또는 오류를 반환합니다.
| 검사 | 확인 항목 |
|---|---|
| DNS 이름 확인 | 호스트 이름이 CDN을 가리키도록 확인되는지 여부 |
| 원본 서버 연결 | 에지가 원본 서버에 연결할 수 있는지 여부 |
| 원본 리디렉션 | 원본 서버의 HTTP-to-HTTPS 리디렉션이 현재 SSL 모드에서 리디렉션 루프를 일으키는지 여부 |
| SSL 모드 일관성 | SSL 모드가 원본 프로토콜 및 포트 설정과 일치하는지 여부 |
| 원본 SSL 인증서 | 원본 인증서가 유효하고 호스트 이름과 일치하는지 여부 |
| HTTPS 강제 적용 | HTTPS 강제 적용이 인증서 상태와 충돌하는지 여부 |
| 혼합 콘텐츠 | HTTPS 페이지가 HTTP 리소스를 로드할 위험 |
| 프로토콜 스위치 | HTTP와 HTTPS 설정의 조합이 적절한지 여부 |
페이지 상단에는 도메인의 현재 SSL 모드, HTTPS 강제 적용, HTTP 및 SSL 상태도 표시되므로 결과와 비교할 수 있습니다.
API
모든 통계 엔드포인트에는 startTime과 endTime이 필요하며, YYYY-MM-DD HH:mm:ss 형식을 사용합니다. 결과를 하나의 도메인으로 제한하려면 domain_id를 추가합니다.
curl -G "https://api.yeap.cloud/api/user/traffic/stats" \
-H "Authorization: Bearer <token>" \
--data-urlencode "startTime=2026-10-01 00:00:00" \
--data-urlencode "endTime=2026-10-07 23:59:59" \
--data-urlencode "domain_id=123"응답에는 total_requests, total_traffic, avg_response_time, cache_hit_rate가 포함됩니다. 기타 엔드포인트는 다음과 같습니다.
| 엔드포인트 | 반환 내용 |
|---|---|
GET /api/user/traffic/map | 국가 또는 지역별 통계 |
GET /api/user/traffic/top-urls | 상위 URL |
GET /api/user/traffic/status-codes | 상태 코드별 내역 |
GET /api/user/traffic/browsers | 브라우저별 내역 |
GET /api/user/traffic/top-domains | 상위 도메인 |
GET /api/user/cdn/domains/{domain}/traffic | 단일 도메인의 개요 및 시계열 데이터 |
GET /api/user/traffic/logs | 요청 로그 항목입니다. request_id, uri, status, client_ip, page, pageSize를 지원하며, pageSize의 최댓값은 200입니다 |
POST /api/user/cdn/diagnostics/run | 진단을 실행합니다. 본문에 {"hostname": "www.example.com"}을 전송합니다 |
현재 원시 로그 파일 다운로드, 실시간 로그 스트리밍, 외부 스토리지로의 로그 전송은 지원되지 않습니다. 데이터를 내보내려면 요청 로그 엔드포인트에서 페이지를 순차적으로 조회합니다.