Google Cloud Java 애플리케이션을 위한 강력한 모니터링, 로깅, 진단 기능을 제공합니다.
Java 클라이언트 라이브러리는 추적, 측정항목, 로깅 데이터를 내보내도록 계측됩니다. 계측은 선택사항입니다. 명시적으로 사용 설정해야 합니다. 이 문서에서는 사용 가능한 신호와 이를 사용 설정하는 방법을 설명합니다.
사용 가능한 신호
골든 시그널에는 OpenTelemetry 시맨틱 규칙을 준수하는 다음 원격 분석 데이터가 포함됩니다.
- trace: 클라이언트 라이브러리에서 수행한 네트워크 요청을 나타내는 하위 수준 HTTP/gRPC trace입니다.
- 측정항목: 지연 시간과 요청률을 추적하는 클라이언트 요청 측정항목입니다. 기본 측정항목은
gcp.client.request.duration입니다. - 로그: 최종적으로 성공적으로 재시도되더라도 전송 계층에서 실패한 요청에 대한 세부정보를 제공하는
DEBUG수준의 실행 가능한 오류 로그입니다.
신호에는 표준 OpenTelemetry 속성 (예:
http.response.status_code 및 rpc.system.name)과 Google Cloud-별
커스텀 속성이 포함되며, 여기에는 다음과 같은 속성 및 유사한 속성이 포함될 수 있습니다.
gcp.client.service: 서비스 이름 (예:pubsub또는storage).gcp.client.repo: 클라이언트 라이브러리 저장소 (예:googleapis/google-cloud-java).gcp.client.version: 클라이언트 라이브러리 버전.gcp.client.artifact: 특정 모듈 경로 (예:com.google.cloud:google-cloud-secretmanager).gcp.resource.destination.id: 작업이 수행되는 리소스의 ID입니다.gcp.errors.domain: 실행 가능한 오류 로그의 오류 도메인입니다.gcp.errors.metadata.<key>: 실패한 요청의 추가 오류 메타데이터 키 (평면화됨).
표준 속성의 전체 목록은 OpenTelemetry HTTP 및 gRPC 시맨틱 규칙을 참조하세요.
원격 분석 사용 설정
민감한 정보를 보호하기 위해 원격 분석 신호는 기본적으로 사용 중지되어 있습니다. 이를 사용 설정하려면 명시적으로 선택해야 합니다.
추적 및 측정항목
생성된 Java 클라이언트 라이브러리에서 초기화 중에 클라이언트 설정에 적절한 추적기 팩토리를 제공하여 추적 및 측정항목을 프로그래매틱 방식으로 사용 설정해야 합니다.
- 추적:
OpenTelemetryTracingFactory로 클라이언트를 구성합니다. - 측정항목:
OpenTelemetryMetricsFactory로 클라이언트를 구성합니다. - 둘 다: 추적과 측정항목을 모두 사용 설정하려면 두 팩토리를 모두 래핑하는
CompositeTracerFactory로 클라이언트를 구성합니다.