서버 상태 모니터링

서버 상태 조회

get

기능설명

API 서버, 데이터베이스, Redis, 디스크 상태 및 배치 현황을 집계하여 반환합니다.

상태 코드

UP : 정상
DOWN : 장애
DEGRADED : 일부 서비스 이상 (UNKNOWN 포함)
UNKNOWN : 정보 수집 불가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

서버 상태 응답 DTO

overallStatusstringOptional

전체 상태 (UP / DOWN / DEGRADED)

checkedAtinteger · int64Optional

마지막 조회 시각 (epoch ms)

900

업무처리 오류

*/*

get/v1/system/server-status

GET /api/bo/v1/system/server-status HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "overallStatus": "text",
  "checkedAt": 1,
  "services": [
    {
      "name": "text",
      "key": "text",
      "status": "text",
      "detail": "text",
      "responseTimeMs": 1
    }
  ],
  "batch": {
    "runningCount": 1,
    "failedCount": 1,
    "completedCount": 1
  }
}

배치 실행 목록 조회 (드릴다운)

get

기능설명

오늘 실행된 배치 목록을 상태별로 조회합니다 (최신 50건).
배치 현황 카드의 드롭다운에서 사용합니다.

status 파라미터

RUNNING : 실행 중 (STARTED / STARTING)
COMPLETED : 완료
FAILED : 실패

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

statusstringRequired

조회 상태 (RUNNING / COMPLETED / FAILED)

Example: FAILED

Responses

200

성공

*/*

배치 실행 상세 (드릴다운 목록 항목)

jobNamestringOptional

배치 잡 명칭

statusstringOptional

상태 (STARTED / STARTING / COMPLETED / FAILED 등)

startTimeinteger · int64Optional

시작 시각 (epoch ms, 미시작 시 null)

endTimeinteger · int64Optional

종료 시각 (epoch ms, 미종료 시 null)

durationMsinteger · int64Optional

소요 시간 (ms, 계산 불가 시 null)

exitMessagestringOptional

종료 메시지 (실패 사유 등, 없으면 null)

900

업무처리 오류

*/*

get/v1/system/server-status/batches

GET /api/bo/v1/system/server-status/batches?status=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "jobName": "text",
    "status": "text",
    "startTime": 1,
    "endTime": 1,
    "durationMs": 1,
    "exitMessage": "text"
  }
]

서버 상태 AI 인사이트 조회

get

기능설명

xgen SERVER_STATUS_ANALYSIS 워크플로우를 통해 현재 서버 상태에 대한 AI 인사이트를 반환합니다.

응답 설명

available=false: xgen 비활성화 또는 ST025 코드 미등록 — 인사이트 없음
available=true: xgen 분석 완료 — insight 필드에 한국어 텍스트 인사이트

ST025 등록 필요

공통코드 그룹 ST025, 코드 08, ref1Val 에 xgen workflow_id 를 등록해야 합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

서버 상태 AI 인사이트 응답

availablebooleanOptional

AI 분석 가능 여부 (xgen 미활성화 또는 코드 미등록 시 false)

insightstringOptional

AI 인사이트 텍스트 (available=false 이면 null)

analyzedAtinteger · int64Optional

분석 시각 (epoch ms)

900

업무처리 오류

*/*

get/v1/system/server-status/ai-insight

GET /api/bo/v1/system/server-status/ai-insight HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "available": true,
  "insight": "text",
  "analyzedAt": 1
}

이전대시보드 상품

다음배치 관리 조회

마지막 업데이트 1일 전