기술 자료

지원

Cloud Code

Cloud Code

HTTP API

Query log entries using the Logging REST API with Service Account authentication and filter expressions.
읽는 시간 1분최근 업데이트: 한 달 전
REST API를 사용하여 로깅 서비스를 쿼리할 수 있습니다. 로그 엔드포인트는 Unity 서비스 계정을 사용하여 인증됩니다.

로그 요청

로깅 API에 대한 GET 요청을 만듭니다.
  • Observability API 기술 자료에는 로그 쿼리 실행에 대한 자세한 설명이 포함되어 있습니다.
  • 인증하는 방법에 대한 자세한 내용은 인증을 참고하십시오.
cURL 커맨드 예시는 다음과 같습니다. 
curl https://services.api.unity.com/observability/v1/projects/<PROJECT_ID>/environments/<ENVIRONMENT_ID>/logs \--header 'Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS_ENCODED>' \--url-query 'from=<TIME_FROM>' \--url-query 'to=<TIME_TO>' \--url-query 'query=<FILTER_EXPRESSION>' \--url-query 'limit=<LIMIT>' \--url-query 'offset=<OFFSET>'
필요한 경우 다음 쿼리 파라미터를 추가로 사용할 수 있습니다. 
  • from
    : 반환할 기록의 시작 타임스탬프를 지정하는 데 사용되는 RFC3339 타임스탬프입니다. 예: 
    2023-06-29T11:30:22.939Z
  • to
    : 반환할 기록의 종료 타임스탬프를 지정하는 데 사용되는 RFC3339 타임스탬프입니다.
  • query
    : 필터링의 부울 표현식입니다. 자세한 내용은 로그 필터링을 참고하십시오.
  • limit
    : 반환할 기록의 최대 수로 사용되는 양의 정수입니다. 100보다 작거나 같아야 합니다.
  • offset
    : 쿼리의 첫 번째 결과에서 로그의 오프셋 수로 사용되는 양의 정수입니다.

상대 시간 범위

API에서는 시간 범위를 더 쉽게 사용할 수 있도록 시작 및 종료 파라미터에 대한 상대 시간 표현식도 지원됩니다. 기본 구문은 다음 요소로 구성됩니다.
  • 기본 시간: RFC3999 타임스탬프 또는 
    now
    키워드
  • 연산자: + 또는 -
  • 시간 오프셋: 일, 시, 분 또는 초 단위 정수(예: 12d, 5h, 3m, 17s)
예시:
  • from=now-30m
  • from=2023-08-29T11:30:00.000Z+30s
  • from=now-2d&to=now-6h

API 호출 예시

다음 예시는 cURL을 사용하여 로깅 API에서 로그를 쿼리하는 방법을 보여 줍니다. 인증하는 방법에 대한 자세한 내용은 인증을 참고하십시오. 
curl https://services.api.unity.com/observability/v1/projects/<PROJECT_ID>/environments/<ENVIRONMENT_ID>/logs \--header 'Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS_ENCODED>' \--url-query 'from=2023-09-01T00:00:00.000Z' \--url-query 'to=2023-09-01T13:50:00.000Z' \--url-query 'query=body~=”regular” AND logAttributes.example.myKey=”foo”' \--url-query 'limit=10' \--url-query 'offset=0'
응답의 예시는 다음과 같습니다. 
{   "limit" : 10,   "offset" : 0,   "total" : 600,   "results" : [      {         "severityNumber" : 9,         "severityText" : "Information",         "timestamp" : "2023-09-01T10:45:00.445Z",         "body" : "this is just a regular log message",         "logAttributes" : {            "example.myKey" : "foo",            "log.record.uid" : "a566701a-a9e5-42f7-bd8e-013fa9ef1afa",            "unity.environmentId" : "c288f9e5-423b-4150-a982-5a1a40b1219a",            "unity.projectId" : "2af24fd0-f224-499e-8768-07b54c693aee"         },         "resourceAttributes" : {            "service.name" : "cloud-code"         }      }   ]}
응답에는 다음 필드가 포함됩니다. 
  • limit
    : 반환된 기록의 최대 수
  • offset
    : 쿼리의 첫 번째 결과에서 로그의 오프셋 수
  • total
    : 쿼리와 일치하는 총 기록 수
  • results
    : 로그 엔트리 배열
results
배열 오브젝트는 로그 스키마에 매핑됩니다.