As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Esta seção descreve a localização, o formato e os motivos dos relatórios de erro gerados pelo Timestream para LiveAnalytics quando erros são encontrados ao executar consultas agendadas.
Motivos dos relatórios de erros de consulta agendados
Os relatórios de erros são gerados para erros recuperáveis. Os relatórios de erros não são gerados para erros não recuperáveis. O Timestream for LiveAnalytics pode desativar as consultas agendadas automaticamente quando erros não recuperáveis são encontrados. Isso inclui:
-
AssumeRole
falha -
Quaisquer erros 4xx encontrados ao se comunicar com o KMS quando uma chave KMS gerenciada pelo cliente é especificada
-
Quaisquer erros 4xx encontrados quando uma consulta agendada é executada
-
Quaisquer erros 4xx encontrados durante a ingestão dos resultados da consulta
Para erros não recuperáveis, o Timestream for LiveAnalytics envia uma notificação de falha com uma mensagem de erro não recuperável. Também é enviada uma notificação de atualização que indica que a consulta agendada está desativada.
Localização dos relatórios de erros da consulta agendada
Um local de relatório de erro de consulta agendada tem a seguinte convenção de nomenclatura:
s3://
customer-bucket
/customer-prefix
/
Veja a seguir um exemplo de ARN de consulta agendada:
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
indica consultas programadas programadas automaticamente pelo Timestream para LiveAnalytics e Manual
indica consultas agendadas acionadas manualmente por um usuário por meio da ação de ExecuteScheduledQuery
API no Amazon Timestream for Query. LiveAnalytics Para obter mais informações sobre o ExecuteScheduledQuery
, consulte ExecuteScheduledQuery.
Formato de relatórios de erros de consulta agendada
Os relatórios de erro têm o seguinte 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 erro de consulta agendada
O Error
objeto pode ser de um dos três tipos:
-
Erros de ingestão de registros
{ "reason": <String>, // The error message String "records": [ <Record>, ... ], // One or more rejected records ) }
-
Erros de análise e validação de linhas
{ "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. }
-
Erros gerais
{ "reason": <String>, // The error message }
Exemplo de relatórios de erros de consultas agendadas
Veja a seguir um exemplo de um relatório de erro produzido devido a erros de ingestão.
{
"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
}
]
}
]
}