모니터링 데이터 조회 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를 호출하면 쿼리 파라미터 유실 없이 안전하게 통계 데이터를 확보할 수 있습니다.

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

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

관련 문서:

API 결과 코드 가이드 (RstVal)