Informes de errores de consultas programadas - Amazon Timestream

Para obtener capacidades similares a las de Amazon Timestream para LiveAnalytics, considere Amazon Timestream para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.

Informes de errores de consultas programadas

En esta sección se describen la ubicación, el formato y los motivos de los informes de errores que genera Timestream para LiveAnalytics cuando se detectan errores al ejecutar consultas programadas.

Motivos de los informes de errores de las consultas programadas

Los informes de errores se generan para los errores recuperables. Los informes de errores no se generan para aquellos que son irrecuperables. Timestream para LiveAnalytics puede inhabilitar las consultas programadas automáticamente en caso de que se produzcan errores irrecuperables. Entre ellos se incluyen:

  • Error AssumeRole

  • Cualquier error 4xx que se produzca al comunicarse con KMS cuando se especifica una clave de KMS administrada por el cliente

  • Cualquier error 4xx que se produzca al ejecutar una consulta programada

  • Cualquier error 4xx que se produzca durante la ingesta de los resultados de la consulta

En el caso de los errores irrecuperables, Timestream para LiveAnalytics envía una notificación de error con un mensaje de error irrecuperable. También se envía una notificación de actualización que indica que la consulta programada está deshabilitada.

Ubicación de los informes de errores de las consultas programadas

La ubicación de un informe de errores de una consulta programada tiene la siguiente convención de nomenclatura:

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

A continuación, se muestra un ejemplo de un ARN de consulta programada:

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>

Auto designa a las consultas programadas automáticamente por Timestream para LiveAnalytics y Manual designa a las consultas programadas activadas manualmente por un usuario mediante una acción de la API ExecuteScheduledQuery en Amazon Timestream para LiveAnalytics Query. Para obtener más información sobre ExecuteScheduledQuery, consulte ExecuteScheduledQuery.

Formato de los informes de errores de consultas programadas

Los informes de errores tienen el siguiente formato JSON:

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

Tipos de error de las consultas programadas

El objeto Error puede ser de tres tipos:

  • Errores de ingesta de registros

    { "reason": <String>, // The error message String "records": [ <Record>, ... ], // One or more rejected records ) }
  • Errores de análisis y validación de filas

    { "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. }
  • Errores generales

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

Ejemplo de informes de errores de consultas programadas

A continuación, se muestra un ejemplo de un informe de errores que se produjo debido a errores de ingesta.

{ "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 } ] } ] }