측정항목 이름 지정 규칙

이 문서에서는 Cloud Monitoring이 측정항목에 적용하는 이름 지정 규칙을 설명합니다.

측정항목 리소스 이름

측정항목 유형의 리소스 이름은 3개의 기본 하위 구조가 포함된 문자열로 구성됩니다.

  • 특정 프로젝트의 식별자
  • 문자열이 측정항목 설명을 나타냄을 표시하기 위해 항상 metricDescriptors로 설정되는 마커
  • 측정항목 유형

측정항목 유형의 리소스 이름은 다음 패턴을 따릅니다.

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

하위 문자열 METRIC_TYPE은 측정항목 유형을 나타내는 식별자입니다. 다양한 형식이 있으며 예를 들면 다음과 같습니다.

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/anthos/APIServiceOpenAPIAggregationControllerQueue1_adds

측정항목 설명에서 name 필드는 측정항목 유형의 리소스 이름을 저장하고 type 필드는 METRIC_TYPE 하위 문자열을 저장합니다.

다음 표에서는 리소스 이름에 포함된 METRIC_TYPE 하위 문자열을 파싱하는 방법을 보여줍니다.

가능한 구조 설명
SERVICE_NAME 1.googleapis.com/PATH 2 Google Cloud 제품 및 서비스의 측정항목. 이러한 측정항목의 전체 목록은 Google Cloud 측정항목을 참조하세요.
agent.googleapis.com/SERVICE_NAME 1/PATH 2 Google Cloud나 AWS의 VM 인스턴스에서 실행되는 Monitoring 및 Logging 에이전트의 측정항목. 이러한 측정항목의 전체 목록은 에이전트 측정항목을 참조하세요.
kubernetes.io/anthos/PATH 2 온프렘과 클라우드 모두에서 Kubernetes 클러스터를 실행할 수 있게 해주는 Google Cloud 서비스인 GKE Enterprise의 측정항목입니다. 이러한 측정항목의 전체 목록은 Anthos 측정항목을 참조하세요.
aws.googleapis.com/SERVICE_NAME 1/PATH 2 Amazon Web Services의 측정항목. 이러한 측정항목의 전체 목록은 AWS 측정항목을 참조하세요.
istio.io/PATH 2 Google Cloud용 Istio의 측정항목. 이러한 측정항목의 전체 목록은 Istio 측정항목을 참조하세요.
kubernetes.io/PATH 2 Google Kubernetes Engine의 측정항목. 이러한 측정항목의 전체 목록은 Kubernetes 측정항목을 참조하세요.
knative.dev/PATH 2 Knative의 측정항목. 이러한 측정항목의 전체 목록은 Knative 측정항목을 참조하세요.
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2
Prometheus와 같은 타사 커스텀 측정항목. 이 오픈소스 모니터링 도구는 주로 Kubernetes에서 사용됩니다. 이러한 측정항목에 대한 자세한 내용은 외부 측정항목을 참조하세요. 이러한 측정항목 유형을 정의하는 프로젝트에서만 사용할 수 있습니다.
custom.googleapis.com/PATH 2
external.googleapis.com/user/PATH 2
사용자 정의 측정항목. 이러한 측정항목 유형을 정의하는 프로젝트에서만 사용할 수 있습니다.
logging.googleapis.com/PATH 2 Cloud Logging의 로그 기반 측정항목. 사전 정의된 측정항목을 사용하거나 커스텀 측정항목을 만들 수 있습니다. 커스텀 측정항목을 정의하는 프로젝트에서만 사용할 수 있습니다.

1 SERVICE_NAME는 Compute Engine용 compute와 같은 Google Cloud 제품을 식별합니다.
2 PATH는 제품 내에서 측정항목(예: instance/cpu/utilization)을 식별합니다.

측정항목 유형 및 라벨 규칙

이 목록에는 커스텀 측정항목 유형을 만들 때 따라야 하는 규칙이 포함되어 있습니다. 측정항목 유형과 연결된 라벨은 LabelDescriptor 유형의 키-값 쌍으로 지정됩니다. 키는 라벨 이름 역할을 합니다.

  • 측정항목 유형

    • 문자열에 대문자와 소문자(A-Z, a-z), 숫자(0-9), 마침표(.), 밑줄(_)을 사용합니다.
    • 슬래시(/)를 사용하여 경로 요소를 구분합니다.
    • 각 경로 요소는 문자 또는 숫자로 시작해야 합니다.
    • 측정항목 유형 문자열의 최대 길이는 200자입니다.
  • 라벨 키

    • 라벨 키에 소문자(a-z), 숫자(0-9), 밑줄(_)을 사용합니다.
    • 라벨 키는 문자로 시작해야 합니다.
    • 라벨 키의 최대 길이는 100자입니다.
    • 각 키는 측정항목 유형 내에서 고유해야 합니다.
    • 측정항목 유형당 라벨은 30개를 초과할 수 없습니다.