용어에 대한 참고사항

이름, 유형, 종류, 측정항목, 리소스라는 단어가 Cloud Monitoring과 관련된 다양한 조합과 환경에 나타나지만, 용례가 항상 일관된 것은 아닙니다. 예를 들어 다음과 같은 일반적인 패턴이 있습니다.

  • 측정항목이라는 용어는 다음과 같은 상황에서 사용될 수 있습니다.

    • 측정할 일반적인 '항목'
    • 측정항목 유형
    • 시계열
    • 측정항목 유형과 연결된 시계열 집합
    • TimeSeries 구조에 삽입된 Metric 구조

  • storage.googleapis.com/api/request_count와 같은 문자열은 다음 중 하나일 수 있습니다.

    • 측정항목
    • 측정항목 이름
    • 측정항목 유형
    • 측정항목 유형 이름

  • gcs_bucket과 같은 문자열은 다음 중 하나일 수 있습니다.

    • 리소스 이름1
    • 모니터링 리소스
    • 모니터링 리소스 유형
    • 모니터링 리소스 이름

1 REST API 참조 자료에서도 리소스 이름 용어를 자주 사용합니다. 이 용어는 일반적으로 모니터링 리소스와는 관련이 없습니다. 이 용어는 리소스 이름에 자세히 설명되어 있습니다.

이 섹션에서는 혼동을 일으킬 수 있는 용어에 대해 안내합니다.

유형 및 이름

측정항목 유형 및 모니터링 리소스의 설명은 이름과 유형을 모두 갖습니다. 용어를 서로 바꿔서 사용하는 것이 일반적입니다.

예를 들어 storage.googleapis.com/api/request_count 문자열은 측정항목 유형이지만 이름 또는 유형 이름이라고도 합니다.

이 측정항목 유형의 설명을 보면 name 및 type이라는 두 개의 키-값 쌍이 표시됩니다.

{
  "name": "projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count",
  ...
  "type": "storage.googleapis.com/api/request_count",
}

측정항목 설명의 type은 데이터를 생성하는 서비스(예: storage.googleapis.com) 및 측정 대상(api/request_count)에 대한 정보를 인코딩하는 문자열입니다.

측정항목 설명에서 name의 값은 측정항목 유형의 정규화된 버전입니다. name 값은 다음 문자열이 프리픽스로 붙는 type 값입니다.

projects/[PROJECT_ID]/metricDescriptors/

모니터링 리소스에 대한 유사한 패턴이 있습니다. type은 특정 유형의 리소스에 대한 라벨이며 name은 이 문자열이 프리픽스로 붙는 type 값으로 구성됩니다.

projects/[PROJECT_ID]/monitoredResourceDescriptors/

다음 예시는 모니터링 리소스 목록의 api 항목에 해당합니다.

{
  "type": "api",
  ...
  "name": "projects/[PROJECT_ID]/monitoredResourceDescriptors/api"
}

프로젝트 내의 name의 값은 type 값에서 완전히 예측할 수 있지만 정확히 동일한 것은 아닙니다. 하지만 이 용어는 일상적인 토론에서 부정확하게 사용되는 경우가 많습니다.

측정항목 종류 및 값 유형

'측정항목 유형'과 혼동될 수 있는 두 가지 다른 용어가 있습니다.

  • 값 유형
  • 측정항목 종류

이러한 용어는 '측정항목 유형'의 대체 용어가 아닙니다.

'값 유형' 및 '측정항목 종류'는 수집된 데이터를 설명합니다. 둘 다 프로그래밍 개념 'datatype'과 관련이 있습니다.

  • 값 유형은 개별 값을 설명합니다.
  • 측정항목 종류는 값이 서로 어떻게 관련되는지 설명합니다.

자세한 내용은 측정항목 종류 및 유형을 참조하세요.

리소스 이름

type(또는 다른) 값에 문자열을 프리픽스로 사용하여 name 값을 만드는 패턴은 측정항목 및 모니터링 리소스 유형에서 그치지 않습니다. 고유하게 식별 가능한 데이터를 만드는 거의 모든 항목에서 나타납니다. 예를 들어 MetricDescriptor 및 AlertPolicy 둘 다 이 패턴을 따릅니다.

name 필드의 값은 참고 문서에서 '리소스 이름'으로 설명되는 경우가 많습니다.

API 참조의 리소스 이름

다음은 리소스 이름이 있는 일부 구조의 예시와 리소스 이름의 파생 방식입니다.

  • 측정항목 설명: 프리픽스 값과 type 필드를 조인합니다.
    • 프리픽스: projects/[PROJECT_ID]/metricDescriptors
    • type(샘플): storage.googleapis.com/api/request_count
    • name: projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count
  • 모니터링 리소스 설명: 프리픽스 값과 type 필드를 조인합니다.
    • 프리픽스: projects/[PROJECT_ID]/monitoredResourceDescriptors
    • type(샘플): api
    • name: projects/[PROJECT_ID]/monitoredResourceDescriptors/api
  • 알림 정책: 프리픽스 값과 생성된 ID 결합
    • 프리픽스: projects/[PROJECT_ID]/alertPolicies
    • 알림 정책 ID: 정책을 만들 때 생성된 번호
    • name: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]

'리소스 이름'이라는 용어는 서비스 API의 계층 구조에 있는 리소스를 나타내며 모니터링 리소스 개념과는 관련이 없습니다. API 디자인의 리소스 이름에 대한 상세 설명은 리소스 이름을 참조하세요.