문제 해결

액세스

서비스 계정에 Timeseries Insights DataSet Owner를 추가할 수 없음

"시계열 통계 데이터 세트 소유자" 역할은 UI에 표시되지 않을 수 있습니다. gcloud 명령어와 함께 역할 ID roles/timeseriesinsights.datasetsOwner를 사용하여 필요한 액세스 권한을 부여할 수 있습니다.

 gcloud projects add-iam-policy-binding "${PROJECT_ID}" \
      --member="serviceAccount:${SVC_ACCOUNT}" \
      --role=roles/timeseriesinsights.datasetsOwner \
      --condition=None

이상 감지

이 섹션에서는 예상과 다른 Timeseries Insights API 응답을 파악하기 위한 일반적인 디버깅 단계를 설명합니다.

비어 있는 슬라이스

로드된 데이터 세트에서 시계열 통계 쿼리를 실행할 때 빈 응답이 수신될 수 있습니다.

Example empty response,
{'name': 'projects/demo-project/datasets/demo-dataset',
'slices': []}

빈 slices 값은 요청된 시간 간격 [detectionTime - TimeseriesParams.forecastHistory, detectionTime + TimeseriesParams.granularity] 이내에 데이터 포인트가 없음을 나타냅니다.

또는 evaluateSlice API를 사용하여 데이터 세트에 있을 것으로 예상되는 명시적 슬라이스에 대해 쿼리할 수도 있습니다. 이렇게 하면 시스템이 지정된 슬라이스의 시계열과 해당 평가 상태를 강제로 반환합니다.

ForecastResult.label INSUFFICIENT_DATA

Timeseries Insights API 쿼리 또는 evaluateSlice를 실행하면 INSUFFICIENT_DATA이(가) 슬라이스당 ForecastResultLabel임을 관찰할 수 있습니다. 이는 특정 슬라이스를 구분하기에는 데이터가 충분하지 않음을 의미합니다.

상태 코드: 3. 메시지: Got density = xx. Min density = yy

다음 코드 예시에서 사용자는 Timeseries Insights API에 데이터 포인트의 90%가 요청된 시간 간격 [detectionTime - TimeseriesParams.forecastHistory, detectionTime] 이내에 있는 경우 분류를 수행하도록 요청했습니다. Timeseries Insights API는 시계열 간격에서 데이터 포인트의 1%만 비어 있지 않으므로 분류를 제공할 수 없습니다.

"status": {
  "code": 3,
  "message": "Got density = 1. Min density = 90"
}

데이터 포인트가 존재하지 않을 수 있는 이유를 알아내기 위해 요청에서 다음 매개변수를 실험해 보세요.

  • detectionTime 및 TimeseriesParams

    • Timeseries Insights API가 작동하기에 충분한 기록을 확보할 수 있도록 [detectionTime - TimeseriesParams.forecastHistory, detectionTime + TimeseriesParams.granularity]이(가) 데이터 세트에 제공되는 모든 이벤트의 하위 범위인지 확인합니다. 이를 위해서는 시계열의 끝 부분에 가까운 detectionTime을(를) 선택해야 할 수도 있습니다.

    • Timeseries Insights API는 detectionTime 이전 과거 시간으로 돌아가서 시계열을 빌드합니다. 소급 기간과 시계열에 포함되는 데이터 포인트의 수는 TimeseriesParams.forecastHistory 및 TimeseriesParams.granularity에 의해 결정됩니다.

    • 데이터 세트의 이벤트 실제 밀도가 확실하지 않은 경우 minDensity = 0.0(으)로 시작합니다. 나중에 정밀도를 높이려면 매개변수를 미세 조정합니다.

또한 매개변수 정의는 시계열 개념을 참조하세요.