측정항목 모델 설명에서 측정항목 유형 섹션은 측정항목 유형을 설명하는 속성에 대한 일반적인 설명을 제공합니다. 이 섹션에서는 이 두 가지 속성에 대해 자세히 설명합니다.
- 값 유형
- 측정항목 종류
값 유형
값 유형은 측정값의 데이터 유형입니다. 각 시계열은 해당 데이터 포인트의 값 유형(ValueType 유형)을 기록합니다.
부울 값이나 숫자 데이터 같이 한 번에 하나의 값으로 구성된 측정인 경우 값 유형을 통해 데이터가 저장되는 방식을 알 수 있습니다.
BOOL, 부울INT64, 64비트 정수DOUBLE, 배정도 부동 소수점 수STRING, 문자열
분포 측정값의 경우 값은 단일 값이 아니라 값 그룹이 됩니다. 분포 측정의 값 유형은
DISTRIBUTION입니다.분포에는 값 그룹을 요약하는 통계가 포함됩니다. 분포의 값에는 값 그룹에서 계산된 평균, 개수, 최댓값, 기타 통계가 포함됩니다. 분포는 값이 특정 범위에 어떻게 분포되는지를 나타내는 히스토그램도 포함할 수 있습니다.
지연 시간 측정항목은 일반적으로 데이터를 분포로 캡처합니다. 분포에 대한 자세한 내용은 Distribution 참조 페이지를 확인하세요. 이러한 측정항목을 차트에 표시하는 방법에 대한 자세한 내용은 분포 측정항목을 참조하세요.
측정항목 종류
각 시계열에는 데이터 포인트의 측정항목 종류(MetricKind 유형)가 포함됩니다. 측정항목 데이터의 종류를 통해 값을 서로 비교하는 방법을 알 수 있습니다. Cloud Monitoring 측정항목은 다음 세 가지 중 하나입니다.
게이지 측정항목은 값이 시간대의 특정한 순간을 측정합니다. 예를 들어 CPU 사용률을 측정하는 측정항목은 게이지 측정항목이며, 각 지점은 측정 시 CPU 사용률을 기록합니다. 이 측정항목의 또 다른 예로는 현재 온도가 있습니다.
델타 측정항목 값이 시간 간격의 변경을 측정합니다. 읽기의 경우 시간 간격이 절반 개방으로 시작 시간은 제외되지만 종료 시간은 포함됩니다(
(startTime, endTime]). 예를 들어 요청 수를 측정하는 측정항목은 델타 측정항목이며 각 값은 시작 시간 이후 종료 시간까지(종료 시간 포함) 수신된 요청 수를 기록합니다.누적 측정항목은 시간 경과에 따라 값이 지속적으로 증가합니다. 예를 들어 '전송된 바이트'의 측정항목은 누적될 수 있습니다. 각 값은 해당 시점에 서비스에서 전송한 총 바이트 수를 기록합니다.
지원되는 조합
측정항목 종류와 값 유형의 모든 조합이 의미가 있는 것은 아닙니다. 예를 들어 부울 데이터가 포함된 델타 측정항목은 표시되지 않습니다. 함께 사용할 수 있는 특정한 조합들이 있습니다.
다음 표에는 지원되는 측정항목 종류와 값 유형이 나열되어 있습니다.
| 값 유형 | 게이지 | 델타 | 누적4 |
|---|---|---|---|
| BOOL | 예 | 아니요 | 아니요 |
| INT64 | 예 | 예1 | 예 |
| DOUBLE | 예 | 예1 | 예 |
| STRING | 예1 | 아니요 | 아니요 |
| 분포 | 예2 | 예1, 3 | 예 |
1 이 조합은 커스텀 측정항목 custom.googleapis.com에서 허용되지 않습니다.
2 로그 기반 측정항목에서는 이 조합이 허용되지 않습니다.
자세한 내용은 분산 유형 로그 기반 측정항목 구성을 참조하세요.
3 이는 값 유형이 DISTRIBUTION인 로그 기반 측정항목 logging.googleapis.com/user에 허용되는 유일한 조합입니다. 자세한 내용은 Logging API LogMetric 참조에서 metricDescriptor 필드를 참조하세요.
4 누적 측정항목은 Monitoring에서 차트 또는 알림에 직접 사용할 수 없지만 이러한 방식으로 사용할 수 있는 비누적 측정항목으로 집계할 수 있습니다. 자세한 내용은 종류, 유형, 전환을 참조하세요.
또한 자체 측정항목을 만드는 경우 유효한 값 유형과 측정항목 종류의 조합만 사용해야 합니다.
문자열 값 커스텀 측정항목 에뮬레이션
커스텀 측정항목의 문자열 값은 지원되지 않지만 다음과 같은 방법으로 문자열 값 측정항목 기능을 복제할 수 있습니다.
- INT64 값을 문자열 값에 매핑되는 enum으로 사용하여 GAUGE 측정항목을 만듭니다. 측정항목을 쿼리할 때 외부에서 enum을 문자열 값으로 변환합니다.
- BOOL 값과 모니터링할 문자열 중 하나인 라벨을 사용하여 GAUGE 측정항목을 만듭니다. 불리언을 사용하여 값이 활성 값인지 여부를 나타냅니다.
예를 들어 가능한 옵션으로 OK, OFFLINE, PENDING이 있는 'status'라는 문자열 값 측정항목을 만든다고 가정해 보겠습니다. status_value 라벨이 있는 GAUGE 측정항목을 만들 수 있습니다. 각 업데이트는 status_value(OK, OFFLINE 또는 PENDING)마다 3개의 시계열을 작성하며, 값은 'true'이면 1, 'false'이면 0입니다.