예약된 쿼리 오류 보고서 - Amazon Timestream
이유위치형식오류 유형예제

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

예약된 쿼리 오류 보고서

이 섹션에서는 예약된 쿼리를 실행하여 오류가 발생할 때 Timestream for LiveAnalytics에서 생성된 오류 보고서의 위치, 형식 및 이유를 설명합니다.

예약된 쿼리 오류는 이유를 보고합니다.

복구 가능한 오류에 대한 오류 보고서가 생성됩니다. 복구할 수 없는 오류에 대해서는 오류 보고서가 생성되지 않습니다. Timestream for LiveAnalytics는 복구할 수 없는 오류가 발생할 때 예약된 쿼리를 자동으로 비활성화할 수 있습니다. 다음이 포함됩니다.

  • AssumeRole 장애

  • 고객 관리형 KMS 키가 지정될 때 KMS와 통신할 때 발생하는 모든 4xx 오류

  • 예약된 쿼리가 실행될 때 발생하는 모든 4xx 오류

  • 쿼리 결과를 수집하는 동안 발생한 모든 4xx 오류

복구할 수 없는 오류의 경우 Timestream for LiveAnalytics는 복구할 수 없는 오류 메시지와 함께 실패 알림을 보냅니다. 예약된 쿼리가 비활성화되었음을 나타내는 업데이트 알림도 전송됩니다.

예약된 쿼리 오류 보고서 위치

예약된 쿼리 오류 보고서 위치에는 다음과 같은 이름 지정 규칙이 있습니다.

s3://customer-bucket/customer-prefix/

다음은 예약된 쿼리 ARN의 예입니다.

arn:aws:timestream:us-east-1:000000000000:scheduled-query/test-query-hd734tegrgfd
s3://customer-bucket/customer-prefix/test-query-hd734tegrgfd/<InvocationTime>/<Auto or Manual>/<Actual Trigger Time>

자동은 Timestream for LiveAnalytics에서 자동으로 예약된 쿼리를 나타내고 수동은 Amazon Timestream for LiveAnalytics 쿼리의 ExecuteScheduledQuery API 작업을 통해 사용자가 수동으로 트리거한 예약된 쿼리를 나타냅니다. ExecuteScheduledQuery에 대한 자세한 내용은 ExecuteScheduledQuery를 참조하세요.

예약된 쿼리 오류 보고서 형식

오류 보고서의 JSON 형식은 다음과 같습니다.

{
    "reportId": <String>,            // A unique string ID for all error reports belonging to a particular scheduled query run
    "errors": [ <Error>, ... ],      // One or more errors
}

예약된 쿼리 오류 유형

Error 객체는 다음 세 가지 유형 중 하나일 수 있습니다.

  • 레코드 수집 오류

    {
    "reason": <String>,              // The error message String
    "records": [ <Record>, ... ],    // One or more rejected records )
}

  • 행 구문 분석 및 검증 오류

    {
    "reason": <String>,        // The error message String
    "rawLine": <String>,       // [Optional] The raw line String that is being parsed into record(s) to be ingested. This line has encountered the above-mentioned parse error.
}

  • 일반 오류

    {
    "reason": <String>,        // The error message
}

예약된 쿼리 오류 보고서 예제

다음은 수집 오류로 인해 생성된 오류 보고서의 예입니다.

{
    "reportId": "C9494AABE012D1FBC162A67EA2C18255",
    "errors": [
        {
            "reason": "The record timestamp is outside the time range [2021-11-12T14:18:13.354Z, 2021-11-12T16:58:13.354Z) of the memory store.",
            "records": [
                {
                    "dimensions": [
                        {
                            "name": "dim0",
                            "value": "d0_1",
                            "dimensionValueType": null
                        },
                        {
                            "name": "dim1",
                            "value": "d1_1",
                            "dimensionValueType": null
                        }
                    ],
                    "measureName": "random_measure_value",
                    "measureValue": "3.141592653589793",
                    "measureValues": null,
                    "measureValueType": "DOUBLE",
                    "time": "1637166175635000000",
                    "timeUnit": "NANOSECONDS",
                    "version": null
                },
                {
                    "dimensions": [
                        {
                            "name": "dim0",
                            "value": "d0_2",
                            "dimensionValueType": null
                        },
                        {
                            "name": "dim1",
                            "value": "d1_2",
                            "dimensionValueType": null
                        }
                    ],
                    "measureName": "random_measure_value",
                    "measureValue": "6.283185307179586",
                    "measureValues": null,
                    "measureValueType": "DOUBLE",
                    "time": "1637166175636000000",
                    "timeUnit": "NANOSECONDS",
                    "version": null
                },
                {
                    "dimensions": [
                        {
                            "name": "dim0",
                            "value": "d0_3",
                            "dimensionValueType": null
                        },
                        {
                            "name": "dim1",
                            "value": "d1_3",
                            "dimensionValueType": null
                        }
                    ],
                    "measureName": "random_measure_value",
                    "measureValue": "9.42477796076938",
                    "measureValues": null,
                    "measureValueType": "DOUBLE",
                    "time": "1637166175637000000",
                    "timeUnit": "NANOSECONDS",
                    "version": null
                },
                {
                    "dimensions": [
                        {
                            "name": "dim0",
                            "value": "d0_4",
                            "dimensionValueType": null
                        },
                        {
                            "name": "dim1",
                            "value": "d1_4",
                            "dimensionValueType": null
                        }
                    ],
                    "measureName": "random_measure_value",
                    "measureValue": "12.566370614359172",
                    "measureValues": null,
                    "measureValueType": "DOUBLE",
                    "time": "1637166175638000000",
                    "timeUnit": "NANOSECONDS",
                    "version": null
                }
            ]
        }
    ]
}