Naver Cloud Platform Exporter 설정

주의

Cloud Insight API 호출량 안내

Cloud Insight API 호출량은 수집 메트릭 수 × 인스턴스 수에 비례해 증가합니다. 필요한 메트릭만 선택해 수집하시기 바랍니다. 설정 방법은 config.yml 파일 설정을 참고하세요.

사전 준비 사항

NCP 계정 및 권한 요구사항

Exporter는 아래 두 종류의 API를 호출합니다. 사용하는 API 키에 두 권한이 모두 있어야 합니다.

대상 API	엔드포인트	용도
Cloud Insight	`cw.apigw.ntruss.com`	제품 키(`cw_key`) 조회, 메트릭 정의 조회, 메트릭 데이터 조회
NCloud API Gateway	`ncloud.apigw.ntruss.com`	리전 목록 조회, 서비스별 인스턴스 목록 조회

노트

Exporter가 사용하는 NCP API는 모두 조회(읽기) 작업만 수행합니다.

서브 계정의 API 키를 사용하는 경우 해당 서브 계정 또는 소속 그룹에 NCP_CLOUD_INSIGHT_VIEWER와 NCP_VPC_SERVER_VIEWER 정책을 모두 부여하고, API Gateway 접근을 허용하세요. 두 정책 중 하나라도 누락되면 Cloud Insight 메트릭 또는 VPC Server 인스턴스 목록을 조회하지 못해 수집이 실패할 수 있습니다.

필수 정보 수집

Exporter 설정에 필요한 정보를 미리 수집합니다.

항목	설명	발급 위치
Access Key	NCP API 인증 키	마이페이지 → 계정 관리 → 인증키 관리
Secret Key	NCP API 인증 시크릿	위와 동일(발급 시점에만 확인 가능)
리전 코드	수집 대상 리전(예를 들어 `KR`)	미지정 시 전체 리전 자동 조회

팁

서브 계정(IAM)을 사용하는 경우 ncp_iam_으로 시작하는 키가 발급됩니다.

NCloud Exporter 설치

Exporter 다운로드

시스템 아키텍처에 맞는 바이너리를 내려받습니다.

# linux/amd64
wget https://repo.whatap.io/exporter/ncloud_exporter/latest/amd64/ncloud_exporter

# linux/arm64
wget https://repo.whatap.io/exporter/ncloud_exporter/latest/arm64/ncloud_exporter

특정 버전을 지정하려면 latest 대신 버전을 입력합니다.

wget https://repo.whatap.io/exporter/ncloud_exporter/1.0.0/amd64/ncloud_exporter

실행 권한 부여 및 설치

chmod +x ncloud_exporter
sudo mv ncloud_exporter /usr/local/bin/
sudo mkdir -p /etc/ncloud_exporter

config.yml 파일 설정

지원 서비스 목록

Namespace	NCP 서비스
`ncloud.vserver`	VPC Server
`ncloud.vloadbalancer`	VPC Load Balancer
`ncloud.vloadbalancertargetgroup`	Load Balancer Target Group
`ncloud.vmysql`	Cloud DB for MySQL
`ncloud.vpostgresql`	Cloud DB for PostgreSQL
`ncloud.vredis`	Cloud DB for Cache
`ncloud.vmongodb`	Cloud DB for MongoDB
`ncloud.vmssql`	Cloud DB for MSSQL
`ncloud.vautoscaling`	Auto Scaling (VPC)
`ncloud.vnks`	Ncloud Kubernetes Service (New)
`ncloud.vsearchengine`	Search Engine Service
`ncloud.vhadoop`	Cloud Hadoop

12개 서비스에 대해 모두 메트릭 카탈로그를 제공하며, 카탈로그에 담긴 메트릭은 전부 283개입니다. 실제로 조회할 수 있는 지표는 리소스 종류, 노드 역할, 서비스 설정에 따라 달라집니다.

노트

서비스 이름 표기

ncloud.vredis는 NCP 콘솔의 Cloud DB for Cache에 대응합니다. 엔진에 따라 cache_* 또는 redis_* 시리즈를 사용합니다.
ncloud.vnks는 신규 Ncloud Kubernetes Service 지표를 사용합니다.

설치 설정 빌더로 config.yml 만들기

설정 파일을 직접 작성하지 않고, 제품의 NCP 설치 가이드 화면에서 수집할 서비스와 메트릭을 골라 config.yml 내용을 만들 수 있습니다. 만든 내용은 복사하거나 파일로 내려받아 /etc/ncloud_exporter/config.yml 경로에 넣으세요.

동작	결과
빌더 진입	12개 서비스가 모두 꺼진 상태로 시작합니다.
서비스 켜기	해당 서비스의 프리셋 대시보드가 요구하는 메트릭이 자동으로 선택됩니다. VPC Server는 인스턴스 1대당 16개 시리즈를 수집하는 조합입니다.
메트릭 고르기	서비스를 펼치면 카탈로그의 메트릭과 집계를 개별로 켜고 끌 수 있습니다.
내보내기	선택한 내용으로 config.yml을 복사하거나 내려받습니다.

노트

카탈로그에 메트릭이 없어 토글만 제공하는 서비스는 메트릭을 고르지 않아도 내보낼 수 있습니다. 이때 해당 서비스는 config.yml에서 생략되어 전체 수집이 일어나지 않습니다.

빌더의 VPC Server 목록에는 VPC Server 기본 메트릭 표의 27개 중 25개만 나옵니다. dev_nm(STRING 타입)과 mnt_stat_cd(interval: Min1 전용)는 시계열이 생성되지 않아 설정 파일에 넣을 수 없으므로 목록에서 제외했습니다.

프리셋 대시보드

지원 서비스 12종마다 프리셋 대시보드를 제공합니다. 별도로 위젯을 배치하지 않아도 수집이 시작되면 바로 지표를 볼 수 있습니다.

NCP 서비스	대시보드 키
VPC Server	`vpc_server`
VPC Load Balancer	`load_balancer`
Load Balancer Target Group	`target_group`
Cloud DB for MySQL	`mysql`
Cloud DB for PostgreSQL	`postgresql`
Cloud DB for Cache	`cache`
Cloud DB for MongoDB	`mongodb`
Cloud DB for MSSQL	`mssql`
Auto Scaling (VPC)	`auto_scaling`
Ncloud Kubernetes Service (New)	`nks`
Search Engine Service	`search_engine`
Cloud Hadoop	`hadoop`

각 위젯의 제목 옆에는 설명 아이콘이 있습니다. 아이콘에 마우스를 올리면 해당 지표가 무엇을 뜻하는지 확인할 수 있습니다.

NCP 알림 템플릿

NCP 서비스 12종에 대해 31개의 PromQL 알림 템플릿을 제공합니다. 경고 알림 > 이벤트 설정 메뉴에서 이벤트를 추가할 때 템플릿 목록에서 선택하면 PromQL, 감지 조건, 이벤트 레벨, 알림 메시지가 미리 채워집니다.

NCP 플랫폼 프로젝트의 이벤트 생성 화면에는 NCP 템플릿만 표시합니다.
OpenMetrics 프로젝트에서는 OpenMetrics 템플릿 다음에 CloudWatch, Azure, NCP 템플릿을 이어서 표시합니다.
복합 메트릭스 이벤트 생성 화면의 템플릿 목록에도 같은 템플릿을 표시합니다.

Service	Template	Metric	Condition	Level
NCP VPC Server	High CPU	`ncloud_vserver_avg_cpu_used_rto_avg`	`value > 80`	Warning
NCP VPC Server	High Memory	`ncloud_vserver_mem_usert_avg`	`value > 90`	Warning
NCP VPC Server	High Filesystem Usage	`ncloud_vserver_max_fs_usert_max`	`value > 90`	Warning
NCP Load Balancer	Collection Errors	`ncloud_scrape_errors_total{namespace="ncloud.vloadbalancer"}`	`value > 0`	Warning
NCP Target Group	Unhealthy Targets	`ncloud_vloadbalancertargetgroup_unavailable_host_count_max`	`value > 0`	Critical
NCP Target Group	No Healthy Targets	`ncloud_vloadbalancertargetgroup_available_host_count_min`	`value < 1`	Critical
NCP MySQL	High Memory	`ncloud_vmysql_mem_pct_avg`	`value > 90`	Warning
NCP MySQL	High CPU	`ncloud_vmysql_cpu_total_avg`	`value > 80`	Warning
NCP PostgreSQL	Availability Degraded	`ncloud_vpostgresql_pg_up_avg`	`value < 1`	Critical
NCP PostgreSQL	High CPU	`ncloud_vpostgresql_cpu_total_avg`	`value > 80`	Warning
NCP PostgreSQL	High Memory	`ncloud_vpostgresql_mem_used_avg`	`value > 90`	Warning
NCP Cache	High Cache Memory	`ncloud_vredis_cache_memory_pct_avg` 또는 `ncloud_vredis_redis_memory_pct_avg`	`value > 80`	Warning
NCP Cache	High Host Memory	`ncloud_vredis_mem_pct_avg`	`value > 90`	Warning
NCP Auto Scaling	High Group CPU	`ncloud_vautoscaling_avg_cpu_used_rto_avg`	`value > 80`	Warning
NCP Auto Scaling	High Group Memory	`ncloud_vautoscaling_mem_usert_avg`	`value > 90`	Warning
NCP MongoDB	Availability Degraded	`ncloud_vmongodb_ping_avg`	`value < 1`	Critical
NCP MongoDB	High CPU	`ncloud_vmongodb_cpu_total_avg`	`value > 80`	Warning
NCP MongoDB	High Memory	`ncloud_vmongodb_mem_pct_avg`	`value > 90`	Warning
NCP MSSQL	Low Disk Space	`ncloud_vmssql_disk_free_percent_avg`	`value < 10`	Warning
NCP MSSQL	High CPU	`ncloud_vmssql_cpu_avg`	`value > 80`	Warning
NCP Kubernetes	Nodes Not Ready	`ncloud_vnks_node_not_ready_count_max`	`value > 0`	Critical
NCP Kubernetes	Failed Pods	`ncloud_vnks_pod_phase_failed_max{type="PodStatus"}`	`value > 0`	Critical
NCP Kubernetes	Pending Pods	`ncloud_vnks_pod_phase_pending_max{type="PodStatus"}`	`value > 0`	Warning
NCP Search Engine	Process Degraded	`ncloud_vsearchengine_search_engine_process_status_avg`	`value < 1`	Critical
NCP Search Engine	High Heap Usage	`ncloud_vsearchengine_heap_used_percent_avg`	`value > 85`	Warning
NCP Search Engine	High CPU	`ncloud_vsearchengine_cpu_total_avg`	`value > 80`	Warning
NCP Hadoop	Missing HDFS Blocks	`ncloud_vhadoop_missing_blocks_avg{type="HADOOP"}`	`value > 0`	Critical
NCP Hadoop	Unhealthy YARN Nodes	`ncloud_vhadoop_unhealthy_nodes_avg{type="HADOOP"}`	`value > 0`	Critical
NCP Hadoop	High HDFS Usage	`ncloud_vhadoop_hdfs_utilization_avg{type="HADOOP"}`	`value > 85`	Warning
NCP Hadoop	High Node CPU	`ncloud_vhadoop_avg_cpu_used_rto_avg{type="svr"}`	`value > 80`	Warning
NCP Hadoop	High Node Memory	`ncloud_vhadoop_mem_usert_avg{type="memory"}`	`value > 90`	Warning

모든 템플릿은 최근 10분 범위의 데이터를 60초마다 평가하고, 알림이 발생하면 30분 동안 같은 이벤트를 다시 알리지 않습니다. 알림 메시지에는 인스턴스 이름, 인스턴스 번호, 리전 코드와 측정값(Collection Errors는 수집 네임스페이스와 오류 건수)이 치환 변수로 포함됩니다.

노트

임계치는 검토용 예시이며 NCP의 공식 권장값이 아닙니다. 저장하기 전에 워크로드에 맞게 조정하세요. 다음 사항도 함께 확인하세요.

모든 값은 Cloud Insight의 집계 값입니다. 가용성 및 프로세스 상태 템플릿은 평균값을 쓰므로 value < 1은 집계 구간 중 비정상 상태가 섞였다는 뜻이며, 현재 완전히 중단됐다는 뜻은 아닙니다.
Collection Errors 템플릿은 Load Balancer 수집 오류를 알리며, Load Balancer 장애를 뜻하지 않습니다. 오류가 발생하면 Exporter 로그와 API 권한을 확인하세요.
기본 집계 구간 Min5보다 긴 집계 구간을 선택했다면 조회 범위도 함께 조정하세요.

config.yml 예시 파일

/etc/ncloud_exporter/config.yml 경로에 설정 파일을 생성합니다. 아래는 VPC Server를 수집하는 기본 구성입니다.

ncloud:
  access_key: "YOUR_ACCESS_KEY"
  secret_key: "YOUR_SECRET_KEY"

namespaces:
  - name: "ncloud.vserver"
    enabled: true
    regions: ["KR"]          # 빈 배열이면 전체 리전
    interval: "Min5"         # Min1 | Min5 | Min30 | Hour2 | Day1
    aggregations: ["AVG"]    # 아래 metrics의 기본 aggregation
    metrics:
      # CPU
      - name: "avg_cpu_used_rto"     # CPU 사용률(%)
      - name: "max_cpu_used_rto"     # CPU 사용률 피크(%)
        aggregations: ["MAX"]
      - name: "load_average_1m"
      - name: "load_average_5m"
      - name: "load_average_15m"

      # 메모리
      - name: "mem_usert"            # 메모리 사용률(%)
        aggregations: ["AVG", "MAX"]
      - name: "swap_usert"           # swap 사용률(%)

      # 파일시스템
      - name: "avg_fs_usert"
      - name: "max_fs_usert"
        aggregations: ["MAX"]

      # 네트워크
      - name: "avg_rcv_bps"          # 수신(bits/sec)
      - name: "avg_snd_bps"          # 송신(bits/sec)

      # 디스크 I/O
      - name: "avg_read_byt_cnt"
      - name: "avg_write_byt_cnt"
      - name: "avg_read_cnt"
      - name: "avg_write_cnt"

  - name: "ncloud.vloadbalancer"
    enabled: false
    regions: []

설정 항목

항목	설명	기본값
`ncloud.access_key`	NCP API Access Key	(필수)
`ncloud.secret_key`	NCP API Secret Key	(필수)
`namespaces[].name`	수집할 서비스 네임스페이스	-
`namespaces[].enabled`	수집 활성화 여부	`false`
`namespaces[].regions`	대상 리전(빈 배열이면 전체)	`[]`
`namespaces[].interval`	조회 간격(`Min1`~`Day1`)	`Min5`
`namespaces[].aggregations`	네임스페이스 기본 aggregation	(API 제공 전체)
`namespaces[].metrics`	수집할 메트릭 목록	(생략 시 전체)

주의

metrics를 지정하지 않으면 해당 서비스의 모든 메트릭 × 모든 aggregation을 수집합니다. VPC Server의 경우 인스턴스 한 대당 125개 시리즈가 생성되므로, 필요한 메트릭만 지정하시기 바랍니다. 위 예시 설정은 인스턴스당 16개 시리즈를 수집합니다.

서비스별 메트릭 목록은 VPC Server 기본 메트릭을 참고하세요.

자격증명을 환경변수로 주입

설정 파일에 키를 평문으로 저장하지 않으려면 환경변수를 사용합니다. 환경변수가 설정 파일 값보다 우선 적용됩니다.

환경변수	설명
`NCLOUD_ACCESS_KEY`	`ncloud.access_key`를 덮어씀
`NCLOUD_SECRET_KEY`	`ncloud.secret_key`를 덮어씀
`NCLOUD_CW_API_GW`	Cloud Insight 엔드포인트(기본 `https://cw.apigw.ntruss.com`)
`NCLOUD_API_GW`	NCloud API GW 엔드포인트(기본 `https://ncloud.apigw.ntruss.com`)

서비스 등록 및 실행

실행 옵션

플래그	설명	기본값
`--config`	설정 파일 경로	`config.yml`
`--web.listen-address`	HTTP 리스너 주소	`:9850`
`--web.telemetry-path`	메트릭 엔드포인트 경로	`/metrics`
`--log.level`	로그 레벨(`debug`, `info`, `warn`, `error`)	`info`
`--log.format`	로그 포맷(`text`, `json`)	`text`

방법 A: systemd 서비스 등록

sudo tee /etc/systemd/system/ncloud-exporter.service > /dev/null <<'EOF'
[Unit]
Description=NCloud Exporter
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
Environment="NCLOUD_ACCESS_KEY=YOUR_ACCESS_KEY"
Environment="NCLOUD_SECRET_KEY=YOUR_SECRET_KEY"
ExecStart=/usr/local/bin/ncloud_exporter \
  --config=/etc/ncloud_exporter/config.yml \
  --web.listen-address=:9850
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

등록한 다음 서비스를 시작합니다.

sudo systemctl daemon-reload
sudo systemctl enable ncloud-exporter
sudo systemctl start ncloud-exporter
sudo systemctl status ncloud-exporter

팁

설정 파일을 수정한 다음에는 재시작 없이 sudo systemctl reload ncloud-exporter로 반영할 수 있습니다. 자격증명, 네임스페이스, 메트릭 선택이 다시 로드됩니다. 다만 리스너 주소와 경로는 실행 인자이므로 변경 시 재시작해야 합니다.

방법 B: nohup 실행

nohup /usr/local/bin/ncloud_exporter \
  --config=/etc/ncloud_exporter/config.yml \
  --web.listen-address=:9850 > /var/log/ncloud_exporter.log 2>&1 &

메트릭 수집 확인 및 트러블슈팅

메트릭 확인

curl http://localhost:9850/metrics

# 특정 서비스만 확인
curl -s http://localhost:9850/metrics | grep '^ncloud_vserver'

정상 출력 예시

# HELP ncloud_vserver_avg_cpu_used_rto_avg NCloud ncloud.vserver avg_cpu_used_rto (%)
# TYPE ncloud_vserver_avg_cpu_used_rto_avg gauge
ncloud_vserver_avg_cpu_used_rto_avg{instancename="my-server",instanceno="12345678",regioncode="KR",serverinstancetype="Micro"} 0.360744
ncloud_vserver_mem_usert_avg{instancename="my-server",instanceno="12345678",regioncode="KR",serverinstancetype="Micro"} 72.1

Exporter 자체 상태는 아래 메트릭으로 확인합니다.

ncloud_scrape_errors_total{namespace="ncloud.vserver"} 0
ncloud_scrape_duration_seconds 0.264890458

메트릭 이름 변환 규칙

ncloud_{service}_{metric}_{aggregation}

service: 네임스페이스에서 ncloud. 접두사를 제거한 값(ncloud.vserver → vserver)
metric: Cloud Insight 메트릭명(avg_cpu_used_rto)
aggregation: 소문자로 변환한 집계 방식(avg, max, min, sum, count)

예시: ncloud.vserver + avg_cpu_used_rto + AVG → ncloud_vserver_avg_cpu_used_rto_avg

트러블슈팅

증상	원인	해결 방법
`failed to initialize cw_keys` 로그와 함께 기동 실패, `status 401 Authentication Failed`	Access Key/Secret Key 오류 또는 권한 부족	키 값을 확인하고, 해당 키에 Cloud Insight 조회 권한이 있는지 점검합니다.
`read config file: open config.yml: no such file or directory`	설정 파일 경로 오류	`--config`에 절대 경로를 지정합니다.
`unknown aggregation "..."` 또는 `unknown interval "..."`로 기동 실패	설정 파일 오타	`aggregations`는 `AVG`/`MAX`/`MIN`/`SUM`/`COUNT`, `interval`은 `Min1`/`Min5`/`Min30`/`Hour2`/`Day1`만 허용합니다.
`WARN configured metric matched no available metric`	존재하지 않는 메트릭명 지정	메트릭 목록에서 실제 메트릭명을 확인합니다.
`WARN some configured aggregations are not supported`	해당 메트릭, interval이 지원하지 않는 aggregation	로그의 `available` 목록에 있는 값으로 수정합니다.
`/metrics`에 `ncloud_` 메트릭이 없음	해당 리전에 인스턴스가 없거나 `enabled: false`	`regions` 설정과 `enabled` 값을 확인합니다. 리전을 특정하지 않으려면 `regions: []`로 둡니다.
특정 메트릭만 값이 비어 있음	Cloud Insight 수집 지연 또는 해당 인스턴스가 미제공	서버에 모니터링 에이전트가 설치되어 있는지 확인합니다. 최근 10분 내 데이터가 없으면 시계열이 생성되지 않습니다.
`ncloud_scrape_errors_total` 값이 계속 증가	API 호출 실패	`--log.level=debug`로 실행해 실패한 네임스페이스와 원인을 확인합니다.

팁

설정을 검증할 때는 --log.level=debug로 실행하시기 바랍니다. 선택된 메트릭, 매칭에 실패한 설정, API 오류가 모두 로그로 출력됩니다.

OpenAgent 다운로드 및 설정

모든 파일은 동일한 디렉토리에 위치해야 합니다.

디렉토리 구조
/opt/whatap/openagent/
├── openagent           # Executable file
├── whatap.conf         # Configuration file
└── scrape_config.yaml  # Scraping configuration file

다운로드 및 권한 설정

mkdir -p /opt/whatap/openagent
cd /opt/whatap/openagent

## AMD64 (Intel/AMD 64-bit processor)
wget https://repo.whatap.io/openagent/latest/amd/openagent

## ARM64 (ARM processor in Linux environment)
wget https://repo.whatap.io/openagent/latest/arm/openagent

chmod +x openagent

scrape_config.yaml 생성

#scrape_config.yaml
features:
  openAgent:
    enabled: true
    targets:
      - targetName: ncloud-exporter
        type: StaticEndpoints
        endpoints:
          - address: "127.0.0.1:9850"
            path: "/metrics"
            scheme: "http"
            interval: "300s"
            metricRelabelConfigs:
              - source_labels: ["__name__"]
                regex: "ncloud_.*"
                action: keep

주의

Cloud Insight의 최소 수집 주기는 5분입니다.

interval을 그보다 짧게 설정해도 동일한 값이 반복 수집될 뿐이며 API 호출량만 증가합니다. 300s 이상을 권장합니다.

설정 요소

항목	설명
`targetName`	수집 대상 이름
`type`	`StaticEndpoints` 고정
`address`	Exporter 주소(`호스트:포트`)
`path`	메트릭 경로(기본값 `/metrics`)
`scheme`	`http` 또는 `https`
`interval`	수집 주기(`300s` 권장)
`metricRelabelConfigs`	수집할 메트릭 필터링 및 레이블 변경

메트릭 필터링 예시

1. Exporter의 모든 메트릭 수집

주의

Go 런타임 메트릭(go_*, process_*)까지 포함되므로 권장하지 않습니다.

metricRelabelConfigs:
  - source_labels: ["__name__"]
    regex: ".*"
    action: keep

2. NCloud 메트릭만 수집(권장)

metricRelabelConfigs:
  - source_labels: ["__name__"]
    regex: "ncloud_.*"
    action: keep

3. 특정 서비스의 CPU·메모리만 수집

metricRelabelConfigs:
  - source_labels: ["__name__"]
    regex: "ncloud_vserver_(avg_cpu_used_rto|mem_usert)_.*"
    action: keep

4. 정적 레이블 추가

metricRelabelConfigs:
  - target_label: "cloud_provider"
    replacement: "ncloud"
    action: replace

실행

# 기본 실행
./openagent standalone

# 백그라운드 실행
nohup ./openagent standalone > /dev/null 2>&1 &

# 로그 확인
tail -f logs/whatap-boot-$(date +%Y%m%d).log

# 프로세스 확인 및 종료
ps aux | grep openagent
pkill openagent

VPC Server 기본 메트릭 `대시보드 설치 페이지 전용`

Metric	Description	Aggregation (Min5)	Unit	Dimension	Default	Statistic
`avg_cpu_used_rto`	CPU Utilization Average	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	AVG
`max_cpu_used_rto`	CPU used ratio maximum	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	MAX
`load_average_1m`	CPU load 1 minute	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	AVG
`load_average_5m`	CPU load 5 minute average	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	AVG
`load_average_15m`	CPU load 15 minute average	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	AVG
`mem_usert`	Memory Utilization	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=memory)	O	AVG, MAX
`swap_usert`	Swap used ratio	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=memory)	O	AVG
`avg_fs_usert`	File System Utilization Average	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	AVG
`max_fs_usert`	File system used ratio maximum	COUNT, SUM, MAX, MIN, AVG	%	instanceNo (type=svr)	O	MAX
`avg_read_byt_cnt`	Disk read bytes average	COUNT, SUM, MAX, MIN, AVG	bytes/sec	instanceNo (type=svr)	O	AVG
`max_read_byt_cnt`	Disk read bytes maximum	COUNT, SUM, MAX, MIN, AVG	bytes/sec	instanceNo (type=svr)	X	-
`avg_write_byt_cnt`	Disk write bytes average	COUNT, SUM, MAX, MIN, AVG	bytes/sec	instanceNo (type=svr)	O	AVG
`max_write_byt_cnt`	Disk write bytes maximum	COUNT, SUM, MAX, MIN, AVG	bytes/sec	instanceNo (type=svr)	X	-
`avg_read_cnt`	Disk read count per second average	COUNT, SUM, MAX, MIN, AVG	num/sec	instanceNo (type=svr)	O	AVG
`max_read_cnt`	Disk read count per second maximum	COUNT, SUM, MAX, MIN, AVG	num/sec	instanceNo (type=svr)	X	-
`avg_write_cnt`	Disk write count per second average	COUNT, SUM, MAX, MIN, AVG	num/sec	instanceNo (type=svr)	O	AVG
`max_write_cnt`	Disk write count per second maximum	COUNT, SUM, MAX, MIN, AVG	num/sec	instanceNo (type=svr)	X	-
`avg_rcv_bps`	Network In Average	COUNT, SUM, MAX, MIN, AVG	bits/sec	instanceNo (type=svr)	O	AVG
`max_rcv_bps`	Network receive bits/sec maximum	COUNT, SUM, MAX, MIN, AVG	bits/sec	instanceNo (type=svr)	X	-
`avg_snd_bps`	Network Out Average	COUNT, SUM, MAX, MIN, AVG	bits/sec	instanceNo (type=svr)	O	AVG
`max_snd_bps`	Network send bits/sec maximum	COUNT, SUM, MAX, MIN, AVG	bits/sec	instanceNo (type=svr)	X	-
`avg_rcv_pps`	Network receive packets/sec average	COUNT, SUM, MAX, MIN, AVG	packets/sec	instanceNo (type=svr)	X	-
`max_rcv_pps`	Network receive packets/sec maximum	COUNT, SUM, MAX, MIN, AVG	packets/sec	instanceNo (type=svr)	X	-
`avg_snd_pps`	Network send packets/sec average	COUNT, SUM, MAX, MIN, AVG	packets/sec	instanceNo (type=svr)	X	-
`max_snd_pps`	Network send packets/sec maximum	COUNT, SUM, MAX, MIN, AVG	packets/sec	instanceNo (type=svr)	X	-
`dev_nm`	Device name	미지원(Min1 전용)	-	instanceNo (type=fs, mnt_nm=/)	X	STRING 타입으로 지정해도 시계열이 생성되지 않음
`mnt_stat_cd`	Mount state	미지원(Min1 전용)	-	instanceNo (type=fs, mnt_nm=/)	X	`interval: Min1`에서만 사용할 수 있음

사전 준비 사항​

NCP 계정 및 권한 요구사항​

필수 정보 수집​

NCloud Exporter 설치​

Exporter 다운로드​

실행 권한 부여 및 설치​

config.yml 파일 설정​

지원 서비스 목록​

설치 설정 빌더로 config.yml 만들기​

프리셋 대시보드​

NCP 알림 템플릿​

config.yml 예시 파일​

설정 항목​

자격증명을 환경변수로 주입​

서비스 등록 및 실행​

실행 옵션​

방법 A: systemd 서비스 등록​

방법 B: nohup 실행​

메트릭 수집 확인 및 트러블슈팅​

메트릭 확인​

정상 출력 예시​

메트릭 이름 변환 규칙​

트러블슈팅​

OpenAgent 다운로드 및 설정​

다운로드 및 권한 설정​

scrape_config.yaml 생성​

설정 요소​

메트릭 필터링 예시​

실행​

VPC Server 기본 메트릭 대시보드 설치 페이지 전용​