계측항목(Instrumentations)
Instrumentation for IMQA
개요
이 문서는 IMQA 모니터링 시스템에서 사용되는 다양한 스키마의 구조와 사용 방법을 설명합니다. 모든 스키마는 OpenTelemetry 형식을 따르며, 웹 애플리케이션의 성능, 오류, 사용자 상호작용 등을 모니터링하는 데 사용됩니다.
공통 스키마 구조
ResourceSpans
모든 스키마의 최상위 컨테이너로, 다음과 같은 구성요소를 포함합니다:
resource: Telemetry를 생성하는 서비스에 대한 정보scopeSpans: 인스트루멘테이션 범위별로 그룹화된 스팬 컬렉션
공통 리소스 속성
모든 스키마에서 공통으로 사용되는 리소스 속성들입니다:
| 속성 | 설명 |
|---|---|
service.name | Telemetry를 생성하는 서비스의 이름 |
telemetry.sdk.language | Telemetry SDK의 프로그래밍 언어 |
telemetry.sdk.name | Telemetry SDK의 이름 |
telemetry.sdk.version | Telemetry SDK의 버전 |
process.runtime.name | 런타임 이름 (예: "browser") |
service.version | 서비스 버전 |
os.name | 운영체제 이름 |
os.version | 운영체제 버전 |
imqa.browser.device | 디바이스 타입 |
imqa.browser.name | 브라우저 이름 |
imqa.browser.version | 브라우저 전체 버전 |
imqa.browser.version_major | 브라우저 메이저 버전 |
service.key | 서비스 식별 키 |
imqa.agent.version | IMQA 에이전트 버전 |
rum.version | RUM (Real User Monitoring) 버전 |
rum.scriptInstance | RUM 스크립트 인스턴스 식별자 |
session.id | 사용자 세션 식별자 |
공통 스팬 속성
모든 스팬에서 공통으로 사용되는 속성들입니다:
| 속성 | 타입 | 설명 |
|---|---|---|
location.href | string | 현재 페이지 URL |
environment | string | 환경 이름 |
deployment.environment | string | 배포 환경 |
screen.name | string | 화면/페이지 이름 |
screen.type | string | 화면/페이지 타입 |
session.id | string | 사용자 세션 식별자 |
url.full | string | 요청 전체 URL (예: "https://example.com/articles/4?s=1&t1" ) |
웹에이전트 계측 항목
@imqa/instrumentation-document-load@imqa/instrumentation-connectivity@imqa/instrumentation-user-interaction@imqa/instrumentation-console@imqa/instrumentation-webvitals@imqa/instrumentation-websocket@imqa/instrumentation-fetch@imqa/instrumentation-xml-http-request@imqa/instrumentation-browser-exception@imqa/instrumentation-post-doc-load-resource@imqa/instrumentation-visibility@imqa/instrumentation-route