> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-34.md).
# 서버 상태 모니터링
## 서버 상태 조회
> \## 기능설명\
> \* API 서버, 데이터베이스, Redis, 디스크 상태 및 배치 현황을 집계하여 반환합니다.\
> \---\
> \## 상태 코드\
> \* \*\*UP\*\* : 정상\
> \* \*\*DOWN\*\* : 장애\
> \* \*\*DEGRADED\*\* : 일부 서비스 이상 (UNKNOWN 포함)\
> \* \*\*UNKNOWN\*\* : 정보 수집 불가
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ServerStatusResponse":{"type":"object","description":"서버 상태 응답 DTO","properties":{"overallStatus":{"type":"string","description":"전체 상태 (UP / DOWN / DEGRADED)"},"checkedAt":{"type":"integer","format":"int64","description":"마지막 조회 시각 (epoch ms)"},"services":{"type":"array","description":"서비스 헬스 목록","items":{"$ref":"#/components/schemas/ServiceStatusInfo"}},"batch":{"$ref":"#/components/schemas/BatchSummary","description":"배치 현황"}}},"ServiceStatusInfo":{"type":"object","description":"개별 서비스 상태","properties":{"name":{"type":"string","description":"서비스 명칭"},"key":{"type":"string","description":"서비스 키 (db / redis / disk / api)"},"status":{"type":"string","description":"상태 (UP / DOWN / UNKNOWN)"},"detail":{"type":"string","description":"상세 정보 (예: 여유 공간 등)"},"responseTimeMs":{"type":"integer","format":"int64","description":"응답 시간 (ms)"}}},"BatchSummary":{"type":"object","description":"배치 현황 요약","properties":{"runningCount":{"type":"integer","format":"int32","description":"오늘 실행 중 배치 수"},"failedCount":{"type":"integer","format":"int32","description":"오늘 실패 배치 수"},"completedCount":{"type":"integer","format":"int32","description":"오늘 완료 배치 수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/server-status":{"get":{"tags":["서버 상태 모니터링"],"summary":"서버 상태 조회","description":"## 기능설명\n* API 서버, 데이터베이스, Redis, 디스크 상태 및 배치 현황을 집계하여 반환합니다.\n---\n## 상태 코드\n* **UP** : 정상\n* **DOWN** : 장애\n* **DEGRADED** : 일부 서비스 이상 (UNKNOWN 포함)\n* **UNKNOWN** : 정보 수집 불가\n","operationId":"getServerStatus","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ServerStatusResponse"}}}},"900":{"description":"업무처리 오류","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 배치 실행 목록 조회 (드릴다운)
> \## 기능설명\
> \* 오늘 실행된 배치 목록을 상태별로 조회합니다 (최신 50건).\
> \* 배치 현황 카드의 드롭다운에서 사용합니다.\
> \---\
> \## status 파라미터\
> \* \*\*RUNNING\*\* : 실행 중 (STARTED / STARTING)\
> \* \*\*COMPLETED\*\* : 완료\
> \* \*\*FAILED\*\* : 실패
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BatchExecutionInfo":{"type":"object","description":"배치 실행 상세 (드릴다운 목록 항목)","properties":{"jobName":{"type":"string","description":"배치 잡 명칭"},"status":{"type":"string","description":"상태 (STARTED / STARTING / COMPLETED / FAILED 등)"},"startTime":{"type":"integer","format":"int64","description":"시작 시각 (epoch ms, 미시작 시 null)"},"endTime":{"type":"integer","format":"int64","description":"종료 시각 (epoch ms, 미종료 시 null)"},"durationMs":{"type":"integer","format":"int64","description":"소요 시간 (ms, 계산 불가 시 null)"},"exitMessage":{"type":"string","description":"종료 메시지 (실패 사유 등, 없으면 null)"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/server-status/batches":{"get":{"tags":["서버 상태 모니터링"],"summary":"배치 실행 목록 조회 (드릴다운)","description":"## 기능설명\n* 오늘 실행된 배치 목록을 상태별로 조회합니다 (최신 50건).\n* 배치 현황 카드의 드롭다운에서 사용합니다.\n---\n## status 파라미터\n* **RUNNING** : 실행 중 (STARTED / STARTING)\n* **COMPLETED** : 완료\n* **FAILED** : 실패\n","operationId":"getBatchExecutions","parameters":[{"name":"status","in":"query","description":"조회 상태 (RUNNING / COMPLETED / FAILED)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BatchExecutionInfo"}}}}},"900":{"description":"업무처리 오류","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 서버 상태 AI 인사이트 조회
> \## 기능설명\
> \* xgen SERVER\_STATUS\_ANALYSIS 워크플로우를 통해 현재 서버 상태에 대한 AI 인사이트를 반환합니다.\
> \---\
> \## 응답 설명\
> \* \*\*available=false\*\*: xgen 비활성화 또는 ST025 코드 미등록 — 인사이트 없음\
> \* \*\*available=true\*\*: xgen 분석 완료 — insight 필드에 한국어 텍스트 인사이트\
> \---\
> \## ST025 등록 필요\
> \* 공통코드 그룹 \*\*ST025\*\*, 코드 \*\*08\*\*, ref1Val 에 xgen workflow\_id 를 등록해야 합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ServerStatusAiInsightResponse":{"type":"object","description":"서버 상태 AI 인사이트 응답","properties":{"available":{"type":"boolean","description":"AI 분석 가능 여부 (xgen 미활성화 또는 코드 미등록 시 false)"},"insight":{"type":"string","description":"AI 인사이트 텍스트 (available=false 이면 null)"},"analyzedAt":{"type":"integer","format":"int64","description":"분석 시각 (epoch ms)"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/server-status/ai-insight":{"get":{"tags":["서버 상태 모니터링"],"summary":"서버 상태 AI 인사이트 조회","description":"## 기능설명\n* xgen SERVER_STATUS_ANALYSIS 워크플로우를 통해 현재 서버 상태에 대한 AI 인사이트를 반환합니다.\n---\n## 응답 설명\n* **available=false**: xgen 비활성화 또는 ST025 코드 미등록 — 인사이트 없음\n* **available=true**: xgen 분석 완료 — insight 필드에 한국어 텍스트 인사이트\n---\n## ST025 등록 필요\n* 공통코드 그룹 **ST025**, 코드 **08**, ref1Val 에 xgen workflow_id 를 등록해야 합니다.\n","operationId":"getServerStatusAiInsight","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ServerStatusAiInsightResponse"}}}},"900":{"description":"업무처리 오류","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```