콘텐츠로 이동

Rumable 브라우저 RUM

Rumable은 Beacon의 브라우저 실제 사용자 모니터링(RUM)을 위한 제로 코드 도구입니다. Nginx 또는 IIS를 통해 HTML 응답에 번들 Web SDK를 주입하므로 애플리케이션 소스 코드를 수정할 필요가 없습니다. 브라우저는 RUM 수신기로 직접 데이터를 전송하며 CLI는 배포 후 종료됩니다.

Rumable은 독립적인 rumable 명령과 TOML 설정을 사용합니다. 설치 패키지는 Rumable 릴리스 페이지에서 다운로드합니다.

사전 요구 사항

  • Linux / Nginx: Bash, curl, sudo 및 http_sub_module이 활성화된 Nginx.
  • Windows / IIS: 관리자 권한, 지원되는 PowerShell, URL Rewrite, 정적 콘텐츠 기능 및 시작된 전용 애플리케이션 풀. 원커맨드 설치에는 64비트 OS가 필요합니다.
  • Guance에서 Web 애플리케이션을 생성하고 applicationId를 얻은 후 Web 애플리케이션 연결에 따라 수신 방식을 선택합니다. 공용 OpenWay는 site와 브라우저 clientToken을 사용합니다. DataKit 직접 전송은 datakitOrigin을 사용하며 RUM 수집기를 활성화해야 합니다. 두 방식 중 하나만 선택합니다.

수신 주소는 방문자 브라우저에서 접근할 수 있어야 합니다. 스킴, 호스트 및 선택적 포트만 입력하고 API 경로는 추가하지 않습니다. HTTPS 사이트는 HTTPS 전송 주소를 사용합니다. 서버에 Go나 Node.js는 필요하지 않습니다. 지원 시스템은 호환성 가이드를 참조하세요.

웹사이트 설정

  1. 영어로 제공되는 Rumable 설정 페이지를 엽니다.
  2. 애플리케이션 ID, 전송 방식, 수신 주소 및 필요한 브라우저 Client Token을 입력합니다. Linux / Nginx 또는 Windows / IIS를 선택하고 샘플링과 개인정보 설정을 확인합니다. 기본적으로 번들 SDK는 웹사이트와 같은 출처에서 제공되며 Session Replay는 선택적으로 활성화합니다.
  3. 일치하는 릴리스 매니페스트가 로드되었는지 확인하고 TOML 설정을 저장한 후 생성된 설치 명령을 복사합니다. Base64는 암호화가 아닙니다. 관리 API Key 대신 브라우저 Client Token을 사용합니다.
  4. 대상 Web 서버에서 필요한 관리자 권한으로 명령을 실행합니다. 설치기는 고정 버전의 GitHub Release 패키지를 다운로드하고 SHA256을 검증한 뒤 사이트를 탐색합니다. 후보가 하나이면 자동 선택하며 여러 개이면 대화형 터미널이 필요합니다.

설치는 서버 설정을 변경하고 복구 기록을 보관합니다. Nginx 설정이 다시 로드될 수 있습니다. IIS 작업은 전용 풀을 재활용하여 메모리 세션이 손실될 수 있으며 공유 풀은 거부됩니다. 대상 사이트를 확인하고 출력된 사이트 ID, 실행 파일 경로, 상태 디렉터리 및 백업 위치를 기록합니다. 상태 디렉터리는 사이트 루트 밖에 보관합니다.

연결 검증

REPLACE_SITE_ID를 출력된 사이트 ID로 바꾸고 실제 실행 파일 경로와 상태 디렉터리를 사용합니다.

read -r -p 'Full path to the installed rumable: ' rumable
sudo "$rumable" status --state-dir /var/lib/rumable --site REPLACE_SITE_ID
sudo "$rumable" probe --state-dir /var/lib/rumable --site REPLACE_SITE_ID

$rumable = Read-Host 'Full path to the installed rumable.exe'
$state = Join-Path $env:ProgramData 'Rumable'
$siteId = 'REPLACE_SITE_ID'
& $rumable status --state-dir $state --site $siteId
& $rumable probe --state-dir $state --site $siteId

rumEnabled=true, 비어 있는 drift, pendingTransaction=false 및 probe 성공을 확인합니다. 이후 다음을 확인합니다.

  1. 브라우저에서 사이트를 열고 페이지 조회, 클릭 및 API 요청을 생성합니다.
  2. Console에서 SDK 초기화 오류를 확인하고 Network에서 /v1/write/rum 전송 요청이 성공하는지 확인합니다.
  3. Guance의 RUM > 애플리케이션 목록에서 해당 Web 애플리케이션을 열고 View, Resource 또는 Action 데이터를 확인합니다.

HTTP probe 성공은 주입과 스크립트 접근 가능 여부만 검증합니다. 브라우저 실행과 백엔드 저장은 별도로 확인합니다.

업데이트 및 복구

기존 사이트 ID, 대상 설정, 상태 디렉터리 및 이전 리소스를 유지합니다. CLI만 교체하면 배포된 SDK는 업그레이드되지 않습니다. 새 CLI로 같은 사이트에서 setup 또는 enable을 다시 실행하고 새 브라우저 세션으로 검증합니다. 대상 수동 지정, 비활성화, 롤백 및 제거는 사용자 가이드를 참조하세요.

서버 텔레메트리 연동

브라우저 전송은 TOML의 RUM 설정을 사용합니다. 공통 설정의 OTEL_EXPORTER_OTLP_* 환경 변수는 서버 언어 에이전트용이며 브라우저 수신기를 설정하지 않습니다. 브라우저 RUM은 DataKit OpenTelemetry 수집기를 통해 전송되지 않습니다.

선택적 서버 OpenTelemetry 통합은 별도로 설정해야 합니다. Rumable OTel 가이드를 참조하세요. 브라우저와 서버 트레이스 연결은 APM과 RUM 연결을 참조하세요.

문서 평가

이 페이지가 도움이 되었나요?