로그 API

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

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

앱이 직접 남긴 로그만 가져옵니다. 컨테이너 시작·종료 기록, runtime hook, access log 같은 플랫폼 내부 로그는 서버에서 제외합니다.

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

External API 사용 시 제한

  • start는 최근 7일 이내여야 합니다.
  • 쿼리 기간(end - start)은 1시간 이하여야 합니다.
  • pagination 없이 한 번에 반환합니다.
응답
{
  "events": [
    {
      "timestamp": 1742000000000,
      "message": "Server started on port 8080",
      "instance": "f8a2d91c7e3b"
    },
    {
      "timestamp": 1742000005000,
      "message": "GET /api/users 200 12ms",
      "instance": "f8a2d91c7e3b"
    }
  ]
}

instance는 각 로그를 만든 Lambda 컨테이너를 구분하는 값입니다. 같은 instance의 로그를 모으면 컨테이너가 시작된 뒤 남긴 기록을 이어서 볼 수 있어 cold start(첫 실행 지연)나 컨테이너별 상태를 분석할 때 유용합니다.