계측 방법 선택

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

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

GKE
Compute Engine
Cloud Run
Cloud Run 함수
App Engine
로깅 프레임워크

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

GKE

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

유형 권장사항

측정항목

유형	권장사항
측정항목	Google Cloud Managed Service for Prometheus를 사용하는 것이 좋습니다. 계측의 경우 다음 중 하나를 수행합니다. Prometheus 클라이언트 라이브러리 사용: 이 접근 방법을 사용하는 경우 일반 애플리케이션을 위한 복사 붙여넣기 가능 내보내기 도구 설치 안내가 포함된 관리형 컬렉션을 사용하는 것이 좋습니다. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구 사용: Prometheus용 관리형 서비스에 OTLP 측정항목을 보고하도록 OpenTelemetry 수집기를 구성해야 합니다. 자세한 내용은 OpenTelemetry 수집기 시작하기를 참조하세요.
추적	다음 단계를 따르세요. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다. OTLP trace를 Google Cloud로 전송하도록 OpenTelemetry 수집기를 구성합니다.
로그	JSON 구조화된 로그를 `stdout` 및 `stderr`로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요. GKE는 `stdout` 및 `stderr`에 기록된 로그를 자동으로 수집합니다. 자세한 내용은 GKE 로그 소개를 참조하세요.

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

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

Prometheus 클라이언트 라이브러리 사용:

이 접근 방법을 사용하는 경우 일반 애플리케이션을 위한 복사 붙여넣기 가능 내보내기 도구 설치 안내가 포함된 관리형 컬렉션을 사용하는 것이 좋습니다.
해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구 사용:

Prometheus용 관리형 서비스에 OTLP 측정항목을 보고하도록 OpenTelemetry 수집기를 구성해야 합니다. 자세한 내용은 OpenTelemetry 수집기 시작하기를 참조하세요.

추적

다음 단계를 따르세요.

로그

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

GKE는 stdout 및 stderr에 기록된 로그를 자동으로 수집합니다. 자세한 내용은 GKE 로그 소개를 참조하세요.

Compute Engine

Compute Engine에 대한 일반적인 정보는 가상 머신 인스턴스를 참조하세요.

유형	권장사항
측정항목 및 trace	다음 단계를 따르세요. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다. 운영 에이전트를 사용하여 측정항목과 trace를 수집합니다. 예시를 보려면 OpenTelemetry 프로토콜(OTLP) 측정항목 및 trace 수집을 참조하세요. 또는 Prometheus 형식 측정항목에 대한 컬렉션만 구성하려는 경우 운영 에이전트 Prometheus 수신자를 사용하여 Prometheus 클라이언트 라이브러리 또는 OpenTelemetry SDK로 계측된 측정항목을 수집할 수 있습니다.
로그	다음 단계를 따르세요. JSON 구조화된 로그를 파일로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요. 운영 에이전트를 설치하고 수신기를 구성합니다. 예시를 보려면 로깅 수신자를 참조하세요.

유형

권장사항

측정항목 및 trace

다음 단계를 따르세요.

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

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

로그

다음 단계를 따르세요.

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

Cloud Run

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

유형 권장사항

측정항목 및 trace

유형	권장사항
측정항목 및 trace	다음 단계를 따르세요. 해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다. 측정항목 및 trace를 수집하도록 OpenTelemetry 사이드카를 구성합니다. 예시를 보려면 OpenTelemetry 사이드카를 사용하여 OTLP 측정항목 작성하기를 참조하세요. Cloud Run에서 항상 할당되도록 CPU를 설정합니다. OpenTelemetry 계측이 백그라운드 프로세싱을 수행하므로 계측된 Cloud Run 서비스는 항상 할당된 CPU를 사용하는 것이 좋습니다. 자세한 내용은 CPU 할당(서비스)을 참조하세요.. 또는 Prometheus 형식 측정항목에 대한 컬렉션만 구성하려는 경우 Cloud Run용 Prometheus 사이드카를 사용하여 Prometheus 클라이언트 라이브러리 또는 OpenTelemetry SDK로 계측된 측정항목을 수집할 수 있습니다.
로그	JSON 구조화된 로그를 `stdout` 및 `stderr`로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요. Cloud Run은 `stdout` 및 `stderr`에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 컨테이너 로그 작성을 참조하세요.

다음 단계를 따르세요.

해당 언어에 맞는 OpenTelemetry SDK 및 OTLP 내보내기 도구를 사용합니다.
측정항목 및 trace를 수집하도록 OpenTelemetry 사이드카를 구성합니다. 예시를 보려면 OpenTelemetry 사이드카를 사용하여 OTLP 측정항목 작성하기를 참조하세요.
Cloud Run에서 항상 할당되도록 CPU를 설정합니다. OpenTelemetry 계측이 백그라운드 프로세싱을 수행하므로 계측된 Cloud Run 서비스는 항상 할당된 CPU를 사용하는 것이 좋습니다. 자세한 내용은 CPU 할당(서비스)을 참조하세요..

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

로그

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

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

Cloud Run 함수

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

유형 권장사항

측정항목 Cloud Run 함수에서는 측정항목 직접 쓰기가 지원되지 않습니다. 측정항목을 생성하려면 로그 기반 측정항목을 사용하는 것이 좋습니다.

추적 사용 언어의 SDK 및 클라우드 trace 내보내기 도구를 사용하세요.

로그

유형	권장사항
측정항목	Cloud Run 함수에서는 측정항목 직접 쓰기가 지원되지 않습니다. 측정항목을 생성하려면 로그 기반 측정항목을 사용하는 것이 좋습니다.
추적	사용 언어의 SDK 및 클라우드 trace 내보내기 도구를 사용하세요.
로그	JSON 구조화된 로그를 `stdout` 및 `stderr`로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요. Cloud Run 함수는 `stdout` 및 `stderr`에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 Cloud Run 함수 로그 보기 및 작성을 참조하세요.

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

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

App Engine

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

유형 권장사항

측정항목 사용 언어의 SDK 및 Cloud Monitoring 내보내기 도구를 사용하세요.

추적 사용 언어의 SDK 및 클라우드 trace 내보내기 도구를 사용하세요.

로그

유형	권장사항
측정항목	사용 언어의 SDK 및 Cloud Monitoring 내보내기 도구를 사용하세요.
추적	사용 언어의 SDK 및 클라우드 trace 내보내기 도구를 사용하세요.
로그	JSON 구조화된 로그를 `stdout` 및 `stderr`로 출력하도록 앱을 구성합니다. 프레임워크 목록은 권장 로깅 프레임워크를 참조하세요. App Engine은 `stdout` 및 `stderr`에 작성된 로그를 자동으로 수집합니다. 자세한 내용은 로그 작성 및 보기를 참조하세요.

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

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

권장 로깅 프레임워크

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

Go: slog
Python: logging
JavaScript: Pino.
Java: Log4j2를 사용하는 SLF4J

코드 샘플

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

OpenTelemetry 참조

이 섹션에서는 OTLP, 클라우드, trace, Cloud Monitoring용 내보내기 도구와 OpenTelemetry SDK에 대한 링크를 제공합니다.

계측 방법 선택 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

GKE

Compute Engine

Cloud Run

Cloud Run 함수

App Engine

권장 로깅 프레임워크

코드 샘플

OpenTelemetry 참조

Go

Java

JavaScript

Python

계측 방법 선택