Link to this section모니터링#

Ultralytics Platform은 배포된 엔드포인트에 대한 모니터링을 제공합니다. 자동 폴링을 통해 요청 메트릭을 추적하고 로그를 확인하며 상태를 점검할 수 있습니다.

Link to this section배포 대시보드#

사이드바의 Deploy 페이지는 모든 배포를 위한 모니터링 대시보드 역할을 합니다. 이 페이지는 세계 지도, 개요 메트릭, 배포 관리를 하나의 화면에 통합하여 보여줍니다. 배포 생성 및 관리에 대한 내용은 Dedicated Endpoints를 참조하십시오.

graph TB
    subgraph Dashboard
        Map[World Map] --- Cards[Overview Cards]
        Cards --- List[Deployments List]
    end
    subgraph "Per Deployment"
        Metrics[Metrics Row]
        Health[Health Check]
        Logs[Logs Tab]
        Code[Code Tab]
        Predict[Predict Tab]
    end
    List --> Metrics
    List --> Health
    List --> Logs
    List --> Code
    List --> Predict

    style Dashboard fill:#f5f5f5,color:#333
    style Map fill:#2196F3,color:#fff
    style Cards fill:#FF9800,color:#fff
    style List fill:#4CAF50,color:#fff

Link to this section개요 카드#

페이지 상단에 있는 4개의 요약 카드는 다음 정보를 표시합니다:

Link to this section세계 지도#

대화형 세계 지도는 다음 정보를 보여줍니다:

• 지역 핀: 사용 가능한 43개 모든 지역
• 녹색 핀: 배포된 지역
• 애니메이션 파란색 핀: 배포가 진행 중인 활성 지역
• 핀 크기: 배포 상태 및 지연 시간에 따라 다름

Link to this section배포 목록#

개요 카드 아래의 배포 목록에는 프로젝트 전반의 모든 엔드포인트가 표시됩니다. 보기 모드 토글을 사용하여 다음 모드로 전환할 수 있습니다:

Link to this section배포별 메트릭#

각 배포 카드(카드 보기 모드)는 실시간 메트릭을 보여줍니다:

Link to this section메트릭 행#

메트릭은 스파크라인 API 엔드포인트에서 가져오며 60초마다 새로 고쳐집니다.

Link to this section상태 확인#

실행 중인 배포에는 상태 점검 표시기가 나타납니다:

상태 점검은 비정상 상태일 때 20초마다 자동 재시도됩니다. 새로 고침 아이콘을 클릭하여 수동으로 상태 점검을 트리거할 수 있습니다. 상태 점검은 scale-to-zero 엔드포인트의 콜드 스타트를 수용하기 위해 55초의 제한 시간을 사용합니다.

Link to this section로그#

각 배포 카드에는 최근 로그 항목을 볼 수 있는 Logs 탭이 포함되어 있습니다:

Link to this section로그 항목#

각 로그 항목은 다음을 보여줍니다:

UI에는 최근 항목 20개가 표시됩니다. API는 요청당 기본적으로 50개 항목을 제공하며 최대 200개까지 가능합니다.

Link to this section코드 예제#

각 배포 카드에는 실제 엔드포인트 URL 및 API 키가 포함된 즉시 사용 가능한 API 코드를 보여주는 Code 탭이 있습니다:

import requests

# Deployment endpoint
url = "https://predict-abc123.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

Link to this section배포 모델 예측#

각 배포 카드에 있는 Predict 탭은 인라인 예측 패널을 제공합니다. 이는 모델의 Predict 탭과 동일한 인터페이스이지만, 공유 서비스 대신 배포 엔드포인트를 통해 추론을 실행합니다. 이는 브라우저에서 직접 배포된 엔드포인트를 테스트할 때 유용합니다. 매개변수 세부 정보 및 응답 형식은 Inference를 참조하십시오.

Link to this sectionAPI 엔드포인트#

Link to this section모니터링 개요#

GET /api/monitoring

인증된 사용자가 소유한 모든 배포에 대한 집계된 메트릭을 반환합니다. 선택적 owner 쿼리 매개변수를 통해 워크스페이스를 인식합니다.

Link to this section배포 메트릭#

GET /api/deployments/{deploymentId}/metrics?sparkline=true&range=24h

특정 배포에 대한 스파크라인 데이터 및 요약 메트릭을 반환합니다. 새로 고침 간격: 60초.

Link to this section배포 로그#

GET /api/deployments/{deploymentId}/logs?limit=50&severity=ERROR,WARNING

선택적 심각도 필터 및 페이지네이션을 포함하여 최근 로그 항목을 반환합니다.

Link to this section배포 상태#

GET /api/deployments/{deploymentId}/health

응답 지연 시간과 함께 상태 확인 결과를 반환합니다.

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142,
    "serverTiming": { "db": 8, "ping": 142, "total": 150 }
}

Link to this section성능 최적화#

모니터링 데이터를 사용하여 배포를 최적화하십시오:

Link to this sectionFAQ#

Link to this section데이터는 얼마나 오래 보관됩니까?#

Link to this section외부 모니터링을 설정할 수 있습니까?#

네, 엔드포인트 URL은 외부 모니터링 도구와 함께 작동합니다:

• 가동 시간 모니터링 (Pingdom, UptimeRobot)
• APM 도구 (Datadog, New Relic)
• /health 엔드포인트를 통한 사용자 지정 상태 확인

Link to this section지연 시간 수치는 얼마나 정확합니까?#

지연 시간 메트릭 측정 항목:

• P50: 중앙값 응답 시간
• P95: 95번째 백분위수
• P99: 99번째 백분위수

이는 사용자까지의 네트워크 지연 시간을 제외한 서버 측 처리 시간을 나타냅니다.

Link to this section메트릭이 지연되는 이유는 무엇입니까?#

메트릭은 다음과 같은 이유로 약 2분 정도 지연됩니다:

• 메트릭 집계 파이프라인
• 집계 윈도우
• 대시보드 캐싱

실시간 디버깅을 하려면 즉각적인 확인이 가능한 로그를 확인하십시오.

Link to this section여러 엔드포인트를 함께 모니터링할 수 있습니까?#

네, 배포 페이지에는 모든 엔드포인트가 집계된 개요 카드로 표시됩니다. 테이블 뷰를 사용하여 배포 간 성능을 비교하십시오.