콘솔 계측

콘솔 계측은 웹 애플리케이션에서 JavaScript 콘솔에 출력되는 로그, 경고, 오류 메시지를 자동으로 캡처하고 모니터링하는 기능을 제공합니다. console.log, console.warn, console.error 등의 콘솔 API 호출을 실시간으로 수집하여 애플리케이션의 디버깅과 모니터링을 지원합니다.

콘솔 계측은 다음과 같은 콘솔 출력을 추적합니다:

리소스 섹션은 서비스와 환경을 설명하는 속성을 포함합니다:

콘솔 Telemetry는 주로 다음과 같은 인스트루멘테이션 범위를 통해 캡처됩니다:

각 콘솔 로그 항목은 스팬으로 표시됩니다:

각 콘솔 스팬은 다음과 같은 속성을 포함합니다:

콘솔 계측은 다음과 같은 로그 레벨에 해당하는 다른 유형의 콘솔 메서드를 캡처합니다:

일반 정보 메시지입니다. 일반적으로 애플리케이션 상태 정보 및 디버깅에 사용됩니다.

경고 메시지는 애플리케이션 실패를 반드시 초래하지 않는 잠재적인 문제를 나타냅니다.

오류 메시지는 애플리케이션 기능에 영향을 미칠 수 있는 실패나 예외 상황을 나타냅니다.

상세한 디버깅 정보로, 일반적으로 개발 중이나 상세한 문제 해결 시에만 사용됩니다.

console 계측 데이터는 다음과 같은 목적으로 사용될 수 있습니다:

console 계측을 효과적으로 활용하기 위해:

console 로그에는 민감한 정보가 포함될 수 있습니다. IMQA 모니터링 시스템은 적절한 데이터 정제 및 접근 제어를 구현하여 console 로그 데이터가 안전하게 처리되고 관련 데이터 보호 규정을 준수하도록 해야 합니다.

이 스키마는 IMQA 모니터링 시스템으로 Telemetry 데이터를 처리하고 저장하기 전에 콘솔 Telemetry 데이터를 검증하는 데 사용됩니다. 프로덕션 환경에서 애플리케이션의 동작을 모니터링하고 디버깅하는 데 도움이 되는 중요한 정보를 제공합니다.

(boolean 또는 IMQAConsoleInstrumentationConfig, 선택)

콘솔 계측을 활성화하거나 비활성화합니다. true로 설정하면 기본 콘솔 계측이 활성화됩니다. IMQAConsoleInstrumentationConfig 객체를 제공하여 콘솔 계측의 세부 설정을 커스터마이즈할 수 있습니다.

순환객체 주의

이 기능을 활성화할 경우 console의 정보를 계측하기 위해 JSON.stringify()를 통해 직렬화됩니다. 만약 순환 객체가 포함되어 있다면, 이 직렬화 과정에서 순환 참조가 발생할 수 있습니다. 따라서, 이 옵션을 활성화 할 경우 순환 참조가 포함된 객체를 로깅할 경우 주의가 필요합니다.

interface IMQAConsoleInstrumentationConfig
  extends InstrumentationConfig {
  betaMode: boolean;
  loggerOptions: LoggerOptions;
  contextManager?: MutableAsyncLocalStorageContextManager;
}