이 문서에서는 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 2external.googleapis.com/prometheus/PATH 2 |
Prometheus와 같은 타사 커스텀 측정항목. 이 오픈소스 모니터링 도구는 주로 Kubernetes에서 사용됩니다. 이러한 측정항목에 대한 자세한 내용은 외부 측정항목을 참조하세요. 이러한 측정항목 유형을 정의하는 프로젝트에서만 사용할 수 있습니다. |
custom.googleapis.com/PATH 2external.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개를 초과할 수 없습니다.
- 라벨 키에 소문자(