커스텀 측정항목 사용

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

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

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

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

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

다음 정보는 커스텀 메트릭과 Stackdriver Monitoring에서 제공하는 메트릭 모두에 적용됩니다.

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

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

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

시작하기 전에

커스텀 측정항목은 Stackdriver Monitoring의 청구 가능 기능이며 커스텀 측정항목에 대한 비용이 청구될 수 있습니다. 가격 책정에 대한 자세한 내용은 Stackdriver 가격 책정을 참조하세요.

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

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

GCP 프로젝트의 Stackdriver 로그에 따라 측정항목을 설정하려면 로그 기반 측정항목을 사용하세요.

커스텀 측정항목 정보

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

  • GCP 프로젝트 내에서 커스텀 측정항목을 만들 수 있습니다.
  • 커스텀 측정항목 이름은 기본 제공 측정항목과 달리 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와 같은 다른 위치로 데이터를 수동으로 복사해야 합니다.

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

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Stackdriver Monitoring
도움이 필요하시나요? 지원 페이지를 방문하세요.