Cloud de Confiance by S3NS Node.js 애플리케이션을 위한 강력한 모니터링, 로깅, 진단 기능을 제공합니다.
Node.js 클라이언트 라이브러리는 추적 데이터를 내보내도록 계측됩니다. 계측은 선택사항입니다. 명시적으로 사용 설정해야 합니다. 이 문서에서는 사용 가능한 신호와 이를 사용 설정하는 방법을 설명합니다.
사용 가능한 신호
Node.js 클라이언트 라이브러리는 다음 신호를 생성하도록 계측됩니다.
- 각 논리적 클라이언트 요청에 대한
INFO범위입니다. 일반적으로 클라이언트 구조체의 단일 메서드 호출은 이러한 범위를 가져옵니다 (예:SecretManagerServiceClient에서accessSecretVersion호출). - 각 하위 수준 RPC 시도에 대한
INFO범위입니다. 일반적으로 클라이언트 구조체의 단일 메서드는 이러한 범위를 가져오지만 라이브러리가 RPC를 재시도해야 하는 경우 더 많을 수 있습니다.
이러한 범위와 로그는 추가
Cloud de Confiance by S3NS 속성과 함께 OpenTelemetry Semantic
규칙을 따릅니다. 범위와 로그는 모두 프로덕션 모니터링에 적합해야 합니다. 신호에는 표준 OpenTelemetry 속성(예: http.response.status_code 및 rpc.system.name)이 포함됩니다.
표준 속성의 전체 목록은 OpenTelemetry HTTP 및 gRPC 시맨틱 규칙을 참조하세요.
원격 분석 신호 사용 설정
민감한 데이터를 보호하기 위해 원격 분석 신호는 기본적으로 사용 중지됩니다.
Node.js에서는 trace를 내보내도록 클라이언트를 구성해야 하며 이러한 신호를 외부 서비스로 보내도록 구독자와 내보내기 도구를 구성해야 합니다.
클라이언트를 구성하려면 다음 환경 변수를 설정하면 됩니다.
export GOOGLE_SDK_NODE_ENABLE_TRACING=true
추적이 사용 설정되고 클라이언트 라이브러리 메서드를 호출할 때 애플리케이션에 현재 컨텍스트에서 활성 OpenTelemetry 범위가 있는 경우 클라이언트 라이브러리는 범위를 활성 범위의 하위 요소로 자동 연결합니다.
trace 내보내기
클라이언트 라이브러리에서 원격 분석이 사용 설정되면 이 데이터를 관측 가능성 서비스로 수집하고 내보내도록 애플리케이션을 구성해야 합니다.
OpenTelemetry trace 상관관계 데이터를 구성하는 방법에 대한 자세한 안내는 관측 가능성 샘플을 Node.js 저장소 내에서 참조하세요.
클라이언트 라이브러리에서 생성된 tracing 범위를 Cloud de Confiance by S3NS OpenTelemetry로 내보내려면 추적기 제공업체와 내보내기 도구를 설정해야 합니다.
const cloudTraceExporter = new TraceExporter();
const spanProcessor = new BatchSpanProcessor(cloudTraceExporter);
const provider = new NodeTracerProvider({
spanProcessors: [spanProcessor],
});
provider.register();