커스텀 측정항목 사용

이 가이드에서는 커스텀 측정항목을 만들고 사용하는 방법을 설명합니다. 이 정보는 다음 섹션으로 구분됩니다.

  • OpenCensus의 커스텀 측정항목에서는 오픈소스 모니터링 및 추적 라이브러리인 OpenCensus를 사용하여 커스텀 측정항목을 만들고, 측정항목 데이터를 추가하고, Cloud Monitoring으로 내보내는 방법을 설명합니다.

    OpenCensus의 측정항목을 Cloud Monitoring으로 내보내면 Monitoring이 다른 커스텀 측정항목처럼 처리합니다.

  • 커스텀 측정항목 만들기에서는 Cloud Monitoring API를 사용하여 커스텀 측정항목을 만들고 여기에 시계열 데이터를 추가하는 방법을 설명합니다.

    Monitoring API가 API 탐색기, C#, Go, 자바, Node.js, PHP, Python, Ruby 프로그래밍 언어를 사용한 예로 설명되어 있습니다.

다음 정보는 커스텀 측정항목과 Cloud Monitoring에서 제공하는 측정항목에 모두 적용됩니다.

  • 측정항목 찾아보기에서는 커스텀 측정항목 및 900개 이상의 기본 제공 측정항목을 나열하고 살펴보는 방법을 설명합니다.
  • 측정항목 읽기는 Monitoring API를 사용하여 커스텀 및 기본 제공 측정항목에서 시계열 데이터를 검색하는 방법을 설명합니다. 차트 및 알림의 측정항목 데이터를 사용할 수도 있습니다.

측정항목에 대한 이러한 모든 작업을 수행하려면 Cloud Monitoring API v3가 필요합니다. 참조 문서는 Cloud Monitoring API 소개를 확인하세요.

Cloud Monitoring의 측정항목에 대한 개념 설명은 측정항목, 시계열, 리소스를 참조하세요.

시작하기 전에

커스텀 측정항목은 작업공간의 구성원인 Google Cloud 프로젝트에 속합니다. 기본 제공 측정항목만 찾아볼 경우에도, 다음과 같이 작업할 프로젝트가 필요합니다.

  1. 액세스하려는 모니터링 데이터가 있는 Google Cloud Console 프로젝트를 만들거나 선택합니다. 이 가이드에서는 프로젝트의 ID를 {your-project-id}라고 합니다.
  2. Monitoring용으로 프로젝트를 설정합니다.

Google Cloud 프로젝트의 로그를 기반으로 측정항목을 설정하려면 로그 기반 측정항목을 사용하세요.

커스텀 측정항목 정보

커스텀 측정항목은 Monitoring의 기본 제공 측정항목과 동일하지만 다음과 같은 차이가 있습니다.

  • Google Cloud 프로젝트에서 커스텀 측정항목을 만들 수 있습니다.
  • 커스텀 측정항목 이름은 기본 제공 측정항목과 달리 custom.googleapis.com/으로 시작합니다.
  • 커스텀 측정항목에 시계열 데이터를 기록할 수 있습니다.
  • 커스텀 측정항목을 삭제할 수 있습니다.

기본 제공 측정항목에 대한 자세한 내용은 측정항목 목록을 참조하세요.

다음 표에서는 커스텀 메트릭 및 기본 제공 메트릭과 함께 사용할 수 있는 Monitoring API의 메소드를 보여줍니다.

Monitoring API 메소드 커스텀
측정항목과 함께 사용
기본 제공
측정항목과 함께 사용
monitoredResourceDescriptors.get
monitoredResourceDescriptors.list
metricDescriptors.get
metricDescriptors.list
timeSeries.list
timeSeries.create
metricDescriptors.create
metricDescriptors.delete

제한 및 지연 시간

커스텀 측정항목 및 데이터 보관과 관련된 한도는 할당량 및 한도를 참조하세요. 측정항목 데이터를 보관 기간보다 오래 보관하려면 Cloud Storage 또는 BigQuery와 같은 다른 위치로 데이터를 수동으로 복사해야 합니다.

커스텀 측정항목에 데이터를 쓸 때 발생하는 지연 시간에 대한 자세한 내용은 측정항목 데이터의 지연 시간을 참조하세요.