계측 방식 선택

이 페이지에는 Google Kubernetes Engine(GKE) 및 Cloud Run과 같은 다양한 Google Cloud 플랫폼에서 앱을 계측하기 위한 권장사항이 포함되어 있습니다. 앱이 아직 계측되지 않은 경우 Google Cloud로 원격 분석 데이터를 전송하도록 앱을 계측하는 방법에 대한 안내로 이 권장사항을 사용하세요. 이 페이지의 권장사항이 유일한 솔루션은 아니며 다른 방법도 사용할 수 있습니다. 자세한 안내는 Google Cloud 지원팀에 문의하세요.

다음에 대한 권장사항을 확인하세요.

계측 예시에 대한 자세한 내용은 코드 샘플 섹션에 나열된 문서를 참조하세요.

GKE

GKE에 대한 일반적인 내용은 GKE 개요를 참조하세요.

유형 추천
측정항목

Google Cloud Managed Service for Prometheus를 사용하는 것이 좋습니다.

계측의 경우 다음 중 하나를 수행합니다.
추적

다음 단계를 따르세요.

  1. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다.
  2. OTLP trace를 Google Cloud로 전송하도록 OpenTelemetry 수집기를 구성합니다.
로그

JSON 구조화된 로그를 stdout 및 stderr로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요.

GKE는 stdout 및 stderr에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 GKE 로그 정보를 참조하세요.

Compute Engine

Compute Engine에 대한 일반적인 내용은 가상 머신 인스턴스를 참조하세요.

유형 추천
측정항목 및 trace

다음 단계를 따르세요.

  1. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다.
  2. 운영 에이전트를 사용하여 측정항목 및 trace를 수집합니다. 예시를 보려면 OpenTelemetry 프로토콜(OTLP) 측정항목 및 trace 수집을 참조하세요.

또는 Prometheus 형식 측정항목에 대한 컬렉션만 구성하려는 경우 운영 에이전트 Prometheus 수신자를 사용하여 Prometheus 클라이언트 라이브러리 또는 OpenTelemetry SDK로 계측된 측정항목을 수집할 수 있습니다.
로그

다음 단계를 따르세요.

  1. JSON 구조화된 로그를 파일에 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요.
  2. 운영 에이전트를 설치하고 수신자를 구성합니다. 예시를 보려면 로깅 수신자를 참조하세요.

Cloud Run

Cloud Run에 대한 일반적인 내용은 Cloud Run이란 무엇인가요?를 참조하세요.

유형 추천
측정항목 및 trace

다음 단계를 따르세요.

  1. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다.
  2. 측정항목 및 trace를 수집하도록 OpenTelemetry 사이드카를 구성합니다. 예시를 보려면 OpenTelemetry 사이드카를 사용하여 OTLP 측정항목 작성을 참조하세요.

또는 Prometheus 형식 측정항목에 대한 컬렉션만 구성하려는 경우 Cloud Run용 Prometheus 사이드카를 사용하여 Prometheus 클라이언트 라이브러리 또는 OpenTelemetry SDK로 계측된 측정항목을 수집할 수 있습니다.
로그

JSON 구조화된 로그를 stdout 및 stderr로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요.

Cloud Run은 stdout 및 stderr에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 컨테이너 로그 작성을 참조하세요.

Cloud Functions

Cloud Functions에 대한 일반적인 내용은 Cloud Functions 개요를 참조하세요.

유형 추천
측정항목 Cloud Functions에서는 측정항목 직접 쓰기가 지원되지 않습니다. 측정항목을 생성하려면 로그 기반 측정항목을 사용하는 것이 좋습니다.
추적 해당 언어에 대한 SDK 및 Cloud Trace 내보내기 도구를 사용합니다.
로그

JSON 구조화된 로그를 stdout 및 stderr로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요.

Cloud Functions는 stdout 및 stderr에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 Cloud 함수 로그 보기 및 작성을 참조하세요.

App Engine

App Engine에 대한 일반적인 내용은 App Engine 개요를 참조하세요.

유형 추천
측정항목 해당 언어에 대한 SDK 및 Cloud Monitoring 내보내기 도구를 사용합니다.
추적 해당 언어에 대한 SDK 및 Cloud Trace 내보내기 도구를 사용합니다.
로그

JSON 구조화된 로그를 stdout 및 stderr로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요.

App Engine은 stdout 및 stderr에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 로그 작성 및 보기를 참조하세요.

권장 로깅 프레임워크

로그를 수집하려면 직렬화된 JSON 객체를 stdout, stderr 또는 파일로 출력하도록 구성할 수 있는 프레임워크를 사용하는 것이 좋습니다. 통합 또는 설치 여부에 관계없이 로깅 에이전트가 파일을 스크래핑하고 Cloud Logging의 구조화된 로그를 작성합니다. 로그 데이터를 작성하려면 다음을 사용하는 것이 좋습니다.

코드 샘플

Google Cloud로 원격 분석을 전송하기 위해 애플리케이션을 계측하는 방법을 보여주는 코드 샘플은 다음을 참조하세요.

OpenTelemetry에 대한 참조

이 섹션에서는 OpenTelemetry SDK에 대한 링크와 OTLP, Cloud Trace, Cloud Monitoring의 내보내기를 제공합니다.

일반 참조:

Go

Java

JavaScript

Python