/
Metrics list

Metrics list

Terms

주1 API launch stages(출시 단계)

  • ALPHA, BETA: 배포 전 테스트 단계이며, 사용에는 제한이 없으나, 기술 지원에 제한적임.

  • GA(General Availability): 정식 배포 단계, production에서 사용 가능.

주2 아래 표의 “Metric type" 문자열은 API URI endpoint에 compute.googleapis.com/을 접두어로 시작해야 함. (해당 접두사는 표의 항목에서 생략.)

주3 Basic units (UNIT)

  • bit bit

  • By byte

  • s second

  • min minute

  • h hour

  • d day

  • 1 dimensionless

주4 Metric Kinds

  • GAUGE: 즉각적으로 측정된 값.

  • DELTA: 임의의 시간 간격 동안의 변화량.

  • CUMULATIVE: 누적량.

개요

아래 내용은 Google Cloud에서 제공하는 Metrics 중, 기본 VM instance 인프라를 관리하는 Compute Engine에 해당되는 Metrics만을 정리한 것이다.

전체 서비스(제품)들에 대한 Metrics list는
https://cloud.google.com/monitoring/api/metrics_gcp#gcp에 모두 나와 있다.
API Request 방법은 구조적으로 충분히 일관되어, 필요한 데이터를 유연하게 조합하여 수집 가능하다.

아래 Compute Engine Metrics외의 부분도 필요에 따라 그때 그때 수집하면 될 것이다.

Metrics from Compute Engine

Compute Engine에 대한 지표 수집에는 Monitoring 또는 Logging 에이전트를 설치할 필요가 없음.

단, 그 중 compute.googleapis.com/guest에 대한 Metric을 수집하려면 Container-Optimized OS Health Monitoring 기능 을 활성화해야 함.
자세한 내용은 컨테이너 최적화 OS 를 참조.

 

Metric type 
(Prefix URI: compute.googleapis.com/)

FieldLaunch stage

Display name

Kind, Type, Unit

Description

Metric type 
(Prefix URI: compute.googleapis.com/)

FieldLaunch stage

Display name

Kind, Type, Unit

Description

1

firewall/

dropped_bytes_countGA

Dropped bytes

DELTAINT64By

방화벽에 의해 drop된 수신 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

2

dropped_packets_countGA

Dropped packets

DELTAINT641

방화벽에 의해 drop된 수신 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

3

guest/cpu/

load_15m ALPHA

CPU load average (15m)

GAUGEDOUBLE1

CPU Load (15 minute intervals).
For Container-Optimized OS, or Ubuntu running GKE.

4

load_5m ALPHA

CPU load average (5m)

GAUGEDOUBLE1

CPU Load (5 minute intervals).
For Container-Optimized OS, or Ubuntu running GKE.

5

load_1m ALPHA

CPU load average (1m)

GAUGEDOUBLE1

CPU Load (1 minute intervals).
For Container-Optimized OS, or Ubuntu running GKE.

6

runnable_task_count BETA

Runnable task count

GAUGEDOUBLE1

실행 대기 큐 內, 실행 가능한 작업 수의 평균 값.
For Container-Optimized OS, or Ubuntu running GKE.

7

usage_time BETA

CPU usage

CUMULATIVEDOUBLEs{CPU}

CPU usage, in seconds.
For Container-Optimized OS, or Ubuntu running GKE.

8

guest/disk/

bytes_used BETA

Disk usage

GAUGEINT64By

Number of bytes used on disk for file systems.
For Container-Optimized OS, or Ubuntu running GKE.

9

io_time GA

IO Time

CUMULATIVEINT64ms

진행 중인 I/O 작업에 소요된 누적 시간. 즉, 큐의 실제 시간과 디스크가 사용 중이었던 시간.
병렬로 발행된 요청은 단일 요청으로 계산됨.
For Container-Optimized OS, or Ubuntu running GKE.

10

merged_operation_count BETA

Merged disk operations

CUMULATIVEINT641

병합된 디스크 작업 수.
서로 인접한 디스크 작업은 효율성을 위해 커널에 의해 병합될 수 있음.
For Container-Optimized OS, or Ubuntu running GKE.

11

operation_bytes_count BETA

Disk bytes transferred

CUMULATIVEINT64By

디스크 작업에서 전송된 바이트.
For Container-Optimized OS, or Ubuntu running GKE.

12

operation_count BETA

Disk operations

CUMULATIVEINT641

디스크 작업 수.
For Container-Optimized OS, or Ubuntu running GKE.

13

operation_time BETA

Disk operation time

CUMULATIVEINT64ms

방향 별 디스크 작업에 소요된 시간.
이 측정 항목에는 완료된 작업에 소요된 시간만 포함됨.
For Container-Optimized OS, or Ubuntu running GKE.

14

queue_length GA

Queue Length

GAUGEDOUBLE1

지난 60초 동안 평균을 낸 디스크의 대기열 길이.
For Container-Optimized OS, or Ubuntu running GKE.

15

weighted_io_time GA

IO Time

CUMULATIVEINT64ms

디스크에서 소비한 누적 가중치 IO 시간.
For Container-Optimized OS, or Ubuntu running GKE.

16

guest/memory/

anonymous_used BETA

Anonymous memory usage in Bytes

GAUGEINT64By

바이트 단위의 익명 메모리 사용량.
모든 상태의 값을 합한 사용된 총 익명 메모리가 산출.
For Container-Optimized OS, or Ubuntu running GKE.

17

bytes_used BETA

Memory usage in Bytes

GAUGEINT64By

각 메모리 상태 별 메모리 사용량(바이트).
모든 상태의 값을 합하면 시스템의 총 메모리가 산출됨.
For Container-Optimized OS, or Ubuntu running GKE.

18

dirty_used BETA

Dirty pages usage in Bytes.

GAUGEINT64By

Dirty pages(PageCache안의 데이터와 디스크 데이터 간 정합성이 깨진 영역에 대한 marking 공간) usage, in Bytes
For Container-Optimized OS, or Ubuntu running GKE.

19

page_cache_used BETA

Page cache memory usage in Bytes

GAUGEINT64By

페이지 캐시 메모리 사용량(바이트).
모든 상태의 값을 합하면 사용된 총 익명 메모리가 산출됨.
For Container-Optimized OS, or Ubuntu running GKE.

20

unevictable_used BETA

Unevictable memory usage in Bytes

GAUGEINT64By

Unevictable(회수불가능한) memory usage, in Bytes.
For Container-Optimized OS, or Ubuntu running GKE.

21

guest/system/

os_feature_enabled BETA

OS Feature

GAUGEINT641

GPU 지원, KTD 커널, 알 수 없는 타사 모듈 사용과 같은 OS 기능 활성화 유무.
기능이 활성화된 경우 1,
비활성화된 경우 0.
For Container-Optimized OS, or Ubuntu running GKE.

22

problem_count GA

Problem Count

CUMULATIVEINT641

기계적 문제가 발생한 횟수.
For Container-Optimized OS, or Ubuntu running GKE.

23

problem_state GA

Problem State

GAUGEINT641

문제가 시스템에 영향을 미치는지 여부.
1이면 시스템에 영향을 미치고,
0이면 시스템에 영향을 주지 않음.
For Container-Optimized OS, or Ubuntu running GKE.

24

uptime GA

Uptime

GAUGEINT64s

운영 체제가 실행된 시간(초).
For Container-Optimized OS, or Ubuntu running GKE.

25

instance/cpu/

guest_visible_vcpus BETA

Guest Visible vCPUs

GAUGEDOUBLE1

게스트 내부에 표시되는 vCPU 수입니다.
많은 GCE 머신 유형의 경우 게스트 내부에 표시되는 vCPU 수는 `compute.googleapis.com/instance/cpu/reserved_cores` 측정 항목과 같습니다.
공유 코어 머신 유형의 경우 게스트에 표시되는 vCPU 수가 예약된 코어 수와 다릅니다.
예를 들어 e2-small 인스턴스에는 게스트 내부에 2개의 vCPU가 표시되고 0.5개의 vCPU가 예약되어 있습니다. 따라서 e2-small 인스턴스의 경우 `compute.googleapis.com/instance/cpu/guest_visible_vcpus`의 값은 2이고 `compute.googleapis.com/instance/cpu/reserved_cores`의 값은 0.5입니다.
60초마다 샘플링됩니다. 샘플링 후 데이터는 최대 240초 동안 표시되지 않습니다.

26

reserved_cores GA

Reserved vCPUs

GAUGEDOUBLE1

인스턴스 호스트에 예약된 vCPU 수.

27

scheduler_wait_time GA

Scheduler Wait Time

DELTADOUBLEs{idle}

대기 시간은 vCPU가 실행할 준비가 되었지만 예기치 않게 실행이 스케줄링되지 않은 시간.

28

usage_time GA

CPU usage

DELTADOUBLEs{CPU}

모든 vCPU들의 사용량에 대한 Delta 값(변화량), vCPU-seconds단위

29

utilization GA

CPU utilization

GAUGEDOUBLE10^2.%

이 인스턴스에서 할당된 CPU의 비율 사용률입니다. 값은 일반적으로 0.0에서 1.0 사이의 숫자입니다(그러나 일부 머신 유형에서는 1.0 이상으로 버스트를 허용함).
차트는 값을 0%에서 100%(또는 그 이상) 사이의 백분율로 표시.
이 측정 항목은 VM의 하이퍼바이저에서 보고하며 VM 내부에서 보고되는 'agent.googleapis.com/cpu/utilization'과 다를 수 있습니다.

30

instance/disk/

max_read_bytes_count GA

Peak disk read bytes

GAUGEINT64By

사용자가 지정한 기간 동안 디스크의 최대 초당 읽기 처리량.
기간은 1분 이상이어야 함.

31

max_read_ops_count GA

Peak disk read ops

GAUGEINT641

사용자가 지정한 기간 동안 디스크의 최대 초당 읽기 요청 수.
기간은 1분 이상이어야 함.

32

max_write_bytes_count GA

Peak disk write bytes

GAUGEINT64By

사용자가 지정한 기간 동안 디스크의 최대 초당 쓰기 처리량.
기간은 1분 이상이어야 함.

33

max_write_ops_count GA

Peak disk write ops

GAUGEINT641

사용자가 지정한 기간 동안 디스크의 최대 초당 쓰기 요청 수.
기간은 1분 이상이어야 함.

34

read_bytes_count GA

Disk read bytes

DELTAINT64By

디스크에서 읽은 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

35

read_ops_count GA

Disk read operations

DELTAINT641

디스크 읽기 IO 작업 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

36

throttled_read_bytes_count GA

Throttled read bytes

DELTAINT64By

제한된(throttled) 읽기 작업의 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

37

throttled_read_ops_count GA

Throttled read operations

DELTAINT641

제한된(throttled) 읽기 작업 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

38

throttled_write_bytes_count GA

Throttled write bytes

DELTAINT64By

제한된(throttled) 쓰기 작업의 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

39

throttled_write_ops_count GA

Throttled write operations

DELTAINT641

제한된(throttled) 쓰기 작업 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

40

write_bytes_count GA

Disk write bytes

DELTAINT64By

디스크 쓰기 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

41

write_ops_count GA

Disk write operations

 

디스크 쓰기 IO 작업 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

42

instance/integrity/

early_boot_validation_status BETA

Early Boot Validation

GAUGEINT641

Early Boot 무결성 정책의 유효성 검사 상태.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

Early Boot: UEFI 펌웨어 시작부터 부트로더로 제어를 넘길 때까지의 부팅 순서.
status: One of "passed", "failed", or "unknown".

43

late_boot_validation_status BETA

Late Boot Validation

GAUGEINT641

Late Boot 무결성 정책의 유효성 검사 상태.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

Late Boot:부트로더에서 완료될 때까지의 부팅 순서. 여기에는 운영 체제 커널의 로드가 포함됨.
status: One of "passed", "failed", or "unknown".

44

instance/memory/balloon/

ram_size GA

VM Memory Total

GAUGEINT64By

VM의 총 메모리 양.
e2 machine type에 속하는 VM에만 사용 가능.

45

ram_used GA

VM Memory Used

GAUGEINT64By

VM에서 현재 사용 중인 메모리.
e2 machine type에 속하는 VM에만 사용 가능.

46

swap_in_bytes_count GA

VM Swap In

DELTAINT64By

자체 스왑 공간에서 게스트로 읽은 메모리 양.
e2 machine type에 속하는 VM에만 사용 가능.

47

swap_out_bytes_count GA

VM Swap Out

DELTAINT64By

게스트에서 자체 스왑 공간으로 쓴 메모리 양.
e2 machine type에 속하는 VM에만 사용 가능.

48

instance/network/

received_bytes_count GA

Received bytes

DELTAINT64By

네트워크에서 받은 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

49

received_packets_count GA

Received packets

DELTAINT641

네트워크에서 수신한 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

50

sent_bytes_count GA

Sent bytes

DELTAINT64By

네트워크를 통해 전송된 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

51

sent_packets_count GA

Sent packets

DELTAINT641

네트워크를 통해 전송된 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

52

instance/

uptime GA

Uptime

DELTADOUBLEs{uptime}

VM이 실행되기까지 걸린 시간(초)의 샘플링 델타 값.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.
참고 VM 시작 이후의 총 시간(초)을 얻으려면, compute.googleapis.com/instance/uptime_total을 사용.

53

uptime_total GA

Uptime Total

GAUGEINT64s

VM이 시작된 이후 경과된 시간.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 120초 동안 표시되지 않음.

54

instance_group/

predicted_capacity BETA

Instance group capacity as predicted

GAUGEDOUBLE1

예측 자동 확장이 활성화된 경우 인스턴스 그룹의 예상 용량.
현재 자동 크기 조정된 인스턴스 그룹에만 사용할 수 있으며 예상 제공 VM 수에 사용률 목표를 곱한 것과 같음.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

55

predicted_size BETA

Instance group size as predicted

GAUGEINT641

예측 자동 확장이 사용 설정된 경우 인스턴스 그룹에 포함될 예상 VM 수.
현재 자동 확장된 인스턴스 그룹에만 사용 가능.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

56

predicted_utilization BETA

Instance group utilization as predicted

GAUGEDOUBLE1

예측 자동 크기 조정이 활성화된 경우 모든 제공 VM에 대한 Scaling 측정 항목의 예상 값 합계.
현재 자동 확장된 인스턴스 그룹에만 사용 가능.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

57

size GA

Instance group size

GAUGEINT641

인스턴스 그룹의 VM 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

58

mirroring/

dropped_packets_count GA

Dropped packets

DELTAINT641

드롭된 미러링 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

59

mirrored_bytes_count GA

Mirrored bytes

DELTAINT64By

미러링된 바이트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

60

mirrored_packets_count GA

Mirrored packets

DELTAINT641

미러링된 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 240초 동안 표시되지 않음.

61

nat/

allocated_ports GA

Allocated ports

GAUGEINT64{port}

NAT 게이트웨이가 VM에 할당한 포트 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

62

closed_connections_count GA

Closed connections count

DELTAINT64{connection}

NAT 게이트웨이를 통해 닫힌 연결 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

63

dropped_received_packets_count GA

Received packets dropped count

DELTAINT64{packet}

NAT 게이트웨이에서 삭제(drop)된 수신 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

64

dropped_sent_packets_count GA

Sent packets dropped count

DELTAINT64{packet}

NAT 게이트웨이에서 삭제(drop)한 송신 패킷 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

65

new_connections_count GA

New connections count

DELTAINT64{connection}

NAT 게이트웨이를 통해 생성된 새 연결 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

66

open_connections GA

Open connections

GAUGEINT64{connection}

NAT 게이트웨이에서 현재 열려 있는 연결 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

67

port_usage GA

Port usage

GAUGEINT64{port}

VM에서 단일 인터넷 엔드포인트(IP:Port)로의 최대 연결 수.
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

68

received_bytes_count GA

Received bytes count

DELTAINT64By

NAT 게이트웨이를 통해 수신된 바이트 수(Internet -> VM).
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

69

received_packets_count GA

Received packets count

DELTAINT64{packet}

NAT 게이트웨이를 통해 수신된 패킷 수(Internet -> VM).
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

70

sent_bytes_count GA

Sent bytes count

DELTAINT64By

NAT 게이트웨이를 통해 보낸 바이트 수(VM -> Internet ).
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

71

sent_packets_count GA

Sent packets count

DELTAINT64{packet}

NAT 게이트웨이를 통해 보낸 패킷 수(VM -> Internet ).
60초마다 샘플링되며, 샘플링 후 데이터는 최대 165초 동안 표시되지 않음.

72

quota/instances_per_vpc_network/

exceeded GA

Instances Per VPC Network quota exceeded error

DELTAINT641

할당량 측정항목 compute.googleapis.com/instances_per_vpc_network/limit를 초과하려는 시도 횟수.

73

limit GA

Instances Per VPC Network quota limit

GAUGEINT641

현재 할당량 측정항목 compute.googleapis.com/instances_per_vpc_network의 한도

74

usage GA

Instances Per VPC Network quota usage

GAUGEINT641

할당량 측정항목 compute.googleapis.com/instances_per_vpc_network의 현재 사용량.

75

quota/
internal_lb_forwarding_rules_per_vpc_network/

exceeded GA

Internal Load Balancer Forwarding Rules per VPC Network quota exceeded error

GAUGEINT641

이하, exceeded ,limit, usage 필드들에 대한 설명은 위와 같은 패턴으로 생략함.

76

limit GA

Internal Load Balancer Forwarding Rules per VPC Network quota limit

GAUGEINT641

 

77

usage GA

Internal Load Balancer Forwarding Rules per VPC Network quota usage

GAUGEINT641

 

78

quota/
internal_managed_forwarding_rules_per_vpc_network/

exceeded GA

Internal Managed Forwarding Rules per VPC Network quota exceeded error

GAUGEINT641

 

79

limit GA

Internal Managed Forwarding Rules per VPC Network quota limit

GAUGEINT641

 

80

usage GA

Internal Managed Forwarding Rules per VPC Network quota usage

GAUGEINT641

 

81

quota/
internal_protocol_forwarding_rules_per_vpc_network/

exceeded GA

Internal Protocol Forwarding Rules per VPC Network quota exceeded error

GAUGEINT641

 

82

limit GA

Internal Protocol Forwarding Rules per VPC Network quota limit

GAUGEINT641

 

83

usage GA

Internal Protocol Forwarding Rules per VPC Network quota usage

GAUGEINT641

 

84

quota/ip_aliases_per_vpc_network/

exceeded GA

IP Aliases per VPC Network quota exceeded error

GAUGEINT641

 

85

limit GA

IP Aliases per VPC Network quota limit

GAUGEINT641

 

86

usage GA

IP Aliases per VPC Network quota usage

GAUGEINT641

 

87

quota/
psc_google_apis_forwarding_rules_per_vpc_network/

exceeded GA

PSC Google APIs Forwarding Rules per VPC Network quota exceeded error

GAUGEINT641

 

88

limit GA

PSC Google APIs Forwarding Rules per VPC Network quota limit

GAUGEINT641

 

89

usage GA

PSC Google APIs Forwarding Rules per VPC Network quota usage

GAUGEINT641

 

90

quota/
psc_ilb_consumer_forwarding_rules_per_producer_vpc_network/

exceeded GA

PSC ILB Consumer Forwarding Rules per Producer VPC Network quota exceeded error

GAUGEINT641

 

91

limit GA

PSC ILB Consumer Forwarding Rules per Producer VPC Network quota limit

GAUGEINT641

 

92

usage GA

PSC ILB Consumer Forwarding Rules per Producer VPC Network quota usage

GAUGEINT641

 

93

quota/subnet_ranges_per_vpc_network/

exceeded GA

Subnetwork ranges per VPC Network quota exceeded error

GAUGEINT641

 

94

limit GA

Subnetwork ranges per VPC Network quota limit

GAUGEINT641

 

95

usage GA

Subnetwork ranges per VPC Network quota usage

GAUGEINT641

 

 

Related content

Introduction
Introduction
Read with this
Setting up K8s Metrics Server Addon
Setting up K8s Metrics Server Addon
More like this
About AWS APIs
About AWS APIs
Read with this
Google Cloud Platform Monitoring
Google Cloud Platform Monitoring
More like this
Quick Installation Guide on Server node
Quick Installation Guide on Server node
Read with this