O Data Service do IoT Platform gera dados de métricas derivadas de forma não contínua. Use o recurso de preenchimento de métricas para processar dados históricos e gerar dados de métricas derivadas sob demanda. Este tópico explica como criar uma tarefa de preenchimento.
Os dados de uma métrica derivada são gerados com base em T+1.
T representa a data em que o IoT Platform recebe os dados brutos de um dispositivo.
Criar uma tarefa de preenchimento
No console do IoT Platform, acesse a página Overview e clique no ID ou no alias da instância Enterprise Edition desejada.
No painel de navegação à esquerda, selecione Data Service > Data Metric e clique em Customize Metric.
Na aba Customized Metric, clique em Metric Task no canto superior direito.
Clique na aba Backfill Instance e, em seguida, clique em Create Backfill Task.
-
No painel Create Backfill Task, configure os parâmetros a seguir e selecione as métricas para preenchimento.
Parâmetro
Descrição
Selecionar data de preenchimento
A data final assume como padrão o dia anterior. É possível selecionar um intervalo de até 30 dias.
Preencher métricas downstream
Define se as métricas downstream da métrica selecionada também devem ser preenchidas.
NotaTodas as métricas derivadas de uma métrica específica são consideradas suas métricas downstream.
-
Se esta caixa de seleção estiver marcada, todas as métricas downstream também serão preenchidas.
-
Se esta caixa de seleção estiver desmarcada, apenas a métrica selecionada será preenchida.
-
-
Clique em OK.
Após a criação da tarefa, uma lista com as tarefas e seus respectivos status aparecerá na aba Backfill Instance.
Para executar a tarefa novamente, clique em rerun.
ImportanteDepois de criar uma tarefa de preenchimento, aguarde até que seu status mude para succeeded antes de utilizar as métricas correspondentes.
O status de uma tarefa de preenchimento evolui de initializing para running e, por fim, para succeeded.
-
(Opcional) Na coluna Actions de uma tarefa de preenchimento, clique em view. Na página Backfill Details, selecione um registro de execução para visualizar o log correspondente.
A seção Instance Information, no topo da página Backfill Details, exibe campos como Metric Task Name, Metric Code, Service Date, Last Submission Time, Last End Time, Last Execution Status e Entity. A área de log de execução abaixo apresenta logs de execução da tarefa no nível INFO, organizados por carimbo de data/hora.
Visualizar instâncias periódicas
A aba Periodic Instance exibe uma lista de estatísticas geradas periodicamente para suas métricas.
Na coluna Actions de uma tarefa de preenchimento, clique em view para consultar as estatísticas de cada ciclo de dados, incluindo Service Date, Last Submission Time, Last End Time, Last Execution Status e run log.
A seção Instance Information na página de detalhes da instância periódica também inclui os campos Metric Task Name, Metric Code e Entity. Na área de run record, visualize o horário de execução e o log detalhado de agendamento DAG de cada execução. Caso uma instância periódica apresente status de falha, clique em rerun. Se as falhas persistirem, clique em view para verificar os detalhes da falha, identificar a causa do erro e atualizar a configuração da métrica.