모니터링 데이터 조회 API 레퍼런스

서버 및 데이터베이스의 실시간 성능 메트릭과 감사 로그를 프로그래밍 방식으로 추출하는 API를 안내합니다.

🔌 서비스 모니터링 페이지로 이동 →

📋 개요

이 API 모듈은 GIIP 에이전트가 수집한 방대한 성능 데이터를 외부 시스템(Grafana, ELK 등)으로 연동하거나 분석하기 위한 인터페이스를 제공합니다.

🔐 인증 및 헤더

모든 요청은 공통 인증 헤더를 포함해야 합니다.

• Header: x-giip-ak: [Your Access Key]
• Header: x-giip-sk: [Your Secret Key]

🚀 주요 API 엔드포인트

1. 실시간 서버 메트릭 조회 (Get Real-time Metrics)

• URL: POST /api/monitoring/server/current
• 설명: 특정 서버의 가장 최신 성능 상태(CPU, MEM, Disk)를 조회합니다.
• Request Body:

{
  "serverIsn": 456
}

2. 성능 이력 조회 (Get Metric History)

• URL: POST /api/monitoring/server/history
• 설명: 특정 기간 동안의 성능 변화 추이 데이터를 시계열로 반환합니다.
• Request Body:

{
  "serverIsn": 456,
  "startTime": "2026-03-19T00:00:00Z",
  "endTime": "2026-03-19T23:59:59Z",
  "interval": "5m"
}

3. 프로세스 목록 조회 (Get Process List)

• URL: POST /api/monitoring/server/processes
• 설명: 서버에서 현재 실행 중인 전체 프로세스 목록과 자원 점유율을 조회합니다.
• Request Body:

{
  "serverIsn": 456
}

🔍 응답 데이터 예시 (Metrics)

{
  "RstVal": 0,
  "RstMsg": "Success",
  "Data": {
    "cpuUsage": 12.5,
    "memUsage": 45.2,
    "diskUsage": 68.1,
    "networkIn": 1024,
    "networkOut": 512
  }
}

💡 활용 사례

• 커스텀 대시보드: 회사 내부의 통합 관제 대시보드에 GIIP의 실시간 데이터를 임베딩합니다.
• 이상 징후 분석: 성능 이력 API로 데이터를 추출하여 머신러닝 모델에 입력하고 장애를 예측합니다.

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

고빈도의 모니터링 데이터 수집이나 대량의 시계열 성능 지표 조회 시, 데이터 전송의 무결성과 정교한 에러 추적을 위해 giipApiSk3 엔드포인트를 권장합니다.

• 엔드포인트: https://giipfaw.azurewebsites.net/api/giipApiSk3
• 장점: 대량의 메트릭 데이터를 jsondata로 전송할 때 발생할 수 있는 데이터 잘림 방지 및 에러 시 에이전트 측의 상세 로그를 자동 수집하여 데이터 수집 파이프라인의 신뢰성을 보장합니다.
• 활용 팁: startTime, endTime, interval 등의 복잡한 조회 조건을 jsondata에 담아 Sk3를 호출하면 쿼리 파라미터 유실 없이 안전하게 통계 데이터를 확보할 수 있습니다.

---

문제 해결

증상	원인	해결
인증 실패 (RstVal이 0이 아님)	x-giip-ak 또는 x-giip-sk 헤더 누락·오타	두 헤더를 모두 유효한 키 값으로 포함하여 재요청
응답 데이터가 비어 있음	요청 Body의 serverIsn 값이 잘못되었거나 숫자가 아님	대상 서버의 올바른 serverIsn(숫자)을 지정
성능 이력 조회 결과 없음	startTime·endTime이 ISO8601(예: 2026-03-19T00:00:00Z) 형식이 아니거나 기간이 역전됨	올바른 시간 형식과 startTime < endTime을 확인하고 interval(예: 5m)을 지정
대량 조회 시 데이터가 잘림	일반 엔드포인트로 대량 jsondata를 전송	giipApiSk3 엔드포인트로 전환하여 데이터 손실 방지

---

버전: 1.1 최종 업데이트: 2026-04-10 소스 파일: giipv3/public/help/api-monitoring.ko.md

---

관련 문서:

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