---
title: "Ncloud Kubernetes Service 지표"
slug: "nks-metric"
updated: 2026-10-22T10:47:10Z
published: 2026-10-22T10:47:10Z
canonical: "api-gov.ncloud-docs.com/nks-metric"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ncloud Kubernetes Service 지표

VPC 환경에서 이용 가능합니다.

Ncloud Kubernetes Service 서비스의 성능/운영 지표(메트릭) 관련 정보를 안내합니다. 성능/운영 지표는 네이버 클라우드 플랫폼의 Cloud Insight 서비스를 통해 통합 관리할 수 있으며, 다양한 모니터링에 활용이 가능합니다.

          참고

          

성능/운영 지표를 모니터링에 활용하는 방법은 [Cloud Insight API 가이드](/docs/management-cloudinsight)를 참조해 주십시오.

## Ncloud Kubernetes Service

Ncloud Kubernetes Service 서비스의 성능/운영 지표는 다음과 같습니다.

### 기본 정보

성능/운영 지표를 활용하기 위한 Ncloud Kubernetes Service 서비스의 기본 정보는 다음과 같습니다.

- 상품 이름(`prodName`)
  - System/Ncloud Kubernetes Service
- 상품 키(`cw_key`)
  - 769285093356343296
- 메트릭 유형
  - [CpuMem](/docs/nks-metric#CpuMem): The cpu and memory usage in pod
  - [Network](/docs/nks-metric#Network): Pod's network in / out
  - [Disk](/docs/nks-metric#Disk): The block storage usage and ratio of pod
  - [NodeAvailability](/docs/nks-metric#NodeAvailability): Normal/abnormal number and ratio of nodes in the cluster
  - [PodStatus](/docs/nks-metric#PodStatus): The overview of the overall health and operational status of Pods

### 성능/운영 지표

Ncloud Kubernetes Service 서비스의 성능/운영 지표는 다음과 같습니다.

#### CpuMem

CpuMem 관련 성능/운영 지표는 다음과 같습니다.

- Metric

| Metric name | Data type | Unit | Metric type | Description | Interval | Aggregation |
| --- | --- | --- | --- | --- | --- | --- |
| real_cpu | FLOAT | num | Basic | pod cpu usage | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| real_mem | FLOAT | bytes | Basic | pod mem usage | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
- Dimension

| Dimension name | Data type | idDimension |
| --- | --- | --- |
| clusterUUID | STRING | O |
| type | STRING | - |
| nodeInstanceNo | INTEGER | - |
| namespace | STRING | - |
| controller | STRING | - |
| pod | STRING | - |

#### Network

Network 관련 성능/운영 지표는 다음과 같습니다.

- Metric

| Metric name | Data type | Unit | Metric type | Description | Interval | Aggregation |
| --- | --- | --- | --- | --- | --- | --- |
| network_rx_bytes | FLOAT | bytes | Basic | receive bytes per second | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| network_tx_bytes | FLOAT | bytes | Basic | send bytes per second | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
- Dimension

| Dimension name | Data type | idDimension |
| --- | --- | --- |
| clusterUUID | STRING | O |
| type | STRING | - |
| nodeInstanceNo | INTEGER | - |
| namespace | STRING | - |
| controller | STRING | - |
| pod | STRING | - |
| interface | STRING | - |

#### Disk

Disk 관련 성능/운영 지표는 다음과 같습니다.

- Metric

| Metric name | Data type | Unit | Metric type | Description | Interval | Aggregation |
| --- | --- | --- | --- | --- | --- | --- |
| available_bytes | FLOAT | bytes | Basic | free storage left on block storage in bytes | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| capacity_bytes | FLOAT | bytes | Basic | storage capacity | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| used_bytes | FLOAT | bytes | Basic | used storage space on block storage in bytes | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| disk_used_ratio | FLOAT | num | Basic | storage used ratio | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
- Dimension

| Dimension name | Data type | idDimension |
| --- | --- | --- |
| clusterUUID | STRING | O |
| type | STRING | - |
| nodeInstanceNo | INTEGER | - |
| namespace | STRING | - |
| controller | STRING | - |
| pod | STRING | - |
| pvc | STRING | - |

#### NodeAvailability

NodeAvailability 관련 성능/운영 지표는 다음과 같습니다.

- Metric

| Metric name | Data type | Unit | Metric type | Description | Interval | Aggregation |
| --- | --- | --- | --- | --- | --- | --- |
| node_total_count | INTEGER | num | Basic | total number of nodes in the cluster | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| node_ready_count | INTEGER | num | Basic | number of nodes in the cluster that are ready | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| node_not_ready_count | INTEGER | num | Basic | number of nodes in the cluster that are not ready | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| node_available_ratio | FLOAT | num | Basic | available node ratio | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
- Dimension

| Dimension name | Data type | idDimension |
| --- | --- | --- |
| clusterUUID | STRING | O |
| type | STRING | - |

#### PodStatus

PodStatus 관련 성능/운영 지표는 다음과 같습니다.

- Metric

| Metric name | Data type | Unit | Metric type | Description | Interval | Aggregation |
| --- | --- | --- | --- | --- | --- | --- |
| pod_phase_pending | INTEGER | num | Basic | the pod in pending phase | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_phase_running | INTEGER | num | Basic | the pod in running phase | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_phase_succeeded | INTEGER | num | Basic | the pod in succeeded phase | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_phase_failed | INTEGER | num | Basic | the pod in failed phase | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_phase_unknown | INTEGER | num | Basic | the pod in unknown phase | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_available_ratio | FLOAT | num | Basic | available pod ratio | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
| pod_restart_count | INTEGER | num | Basic | the number of times containers in the pod have been restarted | Min1,Min5,Min30,Hour2,Day1 | MAX, SUM, MIN, AVG |
- Dimension

| Dimension name | Data type | idDimension |
| --- | --- | --- |
| clusterUUID | STRING | O |
| type | STRING | - |
| namespace | STRING | - |
| controller | STRING | - |