커스텀 측정항목 사용

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

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

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

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

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

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

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

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

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

시작하기 전에

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

  1. 액세스하려는 모니터링 데이터가 있는 Google Cloud Console 프로젝트를 만들거나 선택합니다. 이 가이드에서는 프로젝트의 ID를 {your-project-id}라고 합니다.
  2. 다음을 수행하여 프로젝트의 Cloud Monitoring 작업공간을 구성합니다.
    1. Cloud Console에서 Google Cloud 프로젝트를 선택합니다.
      Cloud Console로 이동
    2. 탐색창에서 Monitoring을 선택합니다.

      Cloud Monitoring을 사용한 적이 없는 경우 Google Cloud Console에서 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와 같은 다른 위치로 데이터를 수동으로 복사해야 합니다.

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