Escrever no log da execução
PUT/dataset-run-log/:datasetRunId
Acrescenta uma linha ao log da execução, com o nível e um contexto opcional. O Proton mostra o log como Markdown, filtra por nível e destaca alertas e erros, e a busca nos logs acha a linha entre execuções.
- A linha fica no passo que estava aberto quando ela chegou.
- Sem
level, a linha é Informação. Um nível desconhecido também vira Informação. - A mensagem vai até 8 KB (acima disso é cortada), e o contexto, um objeto JSON, até 4 KB (acima disso, fica só o começo).
- Cada execução guarda até 10 mil linhas. A primeira que passa disso vira um aviso do Proton
(
context.code: logTruncated), e as seguintes não entram: o log completo fica no arquivo de log da execução, que o runner sobe.
O texto corrido do log (log, em GET /dataset-run-log) segue com data e hora (UTC) na frente de cada
linha, salvo com disableDateTime, e com o nível na frente das linhas que não são Informação
([Alerta], [Erro], [Crítico]). Perto de 64 KB, ele para de crescer, e a linha fica só no log por
linha (GET /dataset-run/{id}/log-entries).
O id da execução vai no corpo (idDatasetRun); o id do caminho não é usado.
Permissão: Execuções: alterar.
Request
Responses
- 200
- 400
- 401
- 403
- 422
Log atualizado
idDatasetRun não foi enviado
Token ausente, inválido ou vencido
O perfil do usuário do token não tem a permissão da rota
A execução não é da organização do token