Logs API

Logs API

배포한 애플리케이션의 런타임 로그를 가져옵니다. 배포 후 크래시, 오류, 예상치 못한 동작을 디버깅할 때 유용합니다.

GET/organizations/:orgId/projects/:projectId/logs

애플리케이션 로그를 가져옵니다. 본인의 애플리케이션 로그만 반환됩니다. 플랫폼 시스템 로그(라이프사이클 이벤트, 런타임 훅, access log)는 서버에서 필터링됩니다.

  • start: ISO 8601 또는 unix ms. 기본값은 1시간 전입니다.
  • end: ISO 8601 또는 unix ms. 기본값은 현재 시각입니다.
  • filter: CloudWatch 필터 패턴(예: "error", -"health").
  • limit: 1~1000, 기본값은 100입니다.

External API 제약

  • start는 최근 7일 이내여야 합니다
  • 조회 구간(end - start)은 1시간 이하여야 합니다
  • 페이지네이션은 지원하지 않습니다(요청당 단일 호출)
응답
{
  "events": [
    {
      "timestamp": 1742000000000,
      "message": "Server started on port 8080",
      "instance": "f8a2d91c7e3b"
    },
    {
      "timestamp": 1742000005000,
      "message": "GET /api/users 200 12ms",
      "instance": "f8a2d91c7e3b"
    }
  ]
}

instance 필드는 각 로그를 생성한 Lambda 컨테이너를 식별합니다. 같은 instance 값을 가진 로그를 묶으면 단일 컨테이너의 라이프사이클을 추적할 수 있어, 콜드 스타트나 인스턴스별 상태를 디버깅할 때 유용합니다.