KVS(키-값 저장소) API 가이드 (v1.2)

GIIP 플랫폼의 유연한 데이터 저장소인 KVS(Key-Value Store)를 통해 인프라의 상태 데이터(factor)를 조회하고 기록하는 API를 제공합니다.

🔌 KVS 목록 페이지로 이동 →

📋 개요

KVS API는 에이전트가 수집한 성능 메트릭, 인벤토리 정보, 프로세스 목록 등 다양한 시계열 및 정형 데이터를 효율적으로 추출하는 데 사용됩니다.

🔐 인증 및 보안

• Header: x-giip-ak / x-giip-sk 헤더 기반 인증 수행

📡 API 상세

1. 최신 데이터 조회 (KVSFactorLast)

• 명령:

  text=KVSFactorLast <factorType>, <lssn>, <factor>

• 예시:

  text=KVSFactorLast netinv, 100, netinv

• 설명: 특정 소스(

  lssn

  또는

  kKey

  )에 대해 지정된

  factor

  의 가장 최근 기록 한 건을 반환합니다.

2. 기록 목록 조회 (KVSFactorList)

• 명령:

  text=KVSFactorList <factorType>, <lssn>, <factor>

• 예시:

  text=KVSFactorList lssn, 12345, *

• 설명: 특정 조건에 맞는 factor 데이터들의 이력을 리스트 형식으로 반환합니다.

🛡️ Sk3(고성능 로깅) 활용

네트워크 토폴로지 데이터(

netstat

)나 인벤토리 정보(

netinv

)와 같이 중요한 KVS 상태 데이터를 기록하거나 대량으로 조회할 때

giipApiSk3

엔드포인트를 권장합니다.

• 엔드포인트:

  https://giipfaw.azurewebsites.net/api/giipApiSk3

• 장점: 대량의

  jsondata

  전송 시 데이터 손실을 방지하고, 기록 실패 시 에이전트의 상세 에러 로그(StackTrace)를 함께 저장하여 정합성 확보에 유리합니다.
• 활용 팁:

  KVSPut

  명령 사용 시

  jsondata

  내에

  kType

  ,

  kKey

  ,

  kFactor

  ,

  kValue

  필드를 포함하면 Sk3 엔진이 이를 자동으로 매핑하여 더욱 안정적으로 DB에 기록합니다.

---

버전: 1.3 최종 업데이트: 2026-04-10 소스 파일:

giipv3/public/help/api-kvs.ko.md

---

관련 문서:

• API 결과 코드 가이드 (RstVal)