Transloadit

O parâmetro ignore_errors

O parâmetro ignore_errors é suportado por todos os Robots no nível do Step. Ele permite que você mantenha uma Assembly em andamento quando certos erros por arquivo são aceitáveis para o seu fluxo de trabalho.

Por que isso pode ser útil

ignore_errors é útil quando um sucesso parcial é melhor do que uma falha total. Exemplos comuns:

  • Processamento em lote em que se espera que alguns arquivos estejam malformados ou não sejam suportados.
  • Pipelines em que a extração de metadados é opcional.
  • Importações grandes em que arquivos ausentes ou temporariamente indisponíveis não devem interromper todos os outros arquivos.

Valores suportados

Todos os Robots suportam meta e execute. Os Robots de importação suportam adicionalmente import.

ValorEfeito
(omitir), false ou []Comportamento padrão: não ignorar erros.
trueIgnora todas as fases suportadas desse Robot.
["meta"]Ignora erros de extração de metadados.
["execute"]Ignora erros de execução/transcodificação.
["meta", "execute"]Ignora tanto erros de metadados quanto erros de execução.
["import"]Somente Robots de importação: ignora erros de importação/obtenção.
["meta", "import", "execute"]Somente Robots de importação: ignora todas as fases suportadas.

Exemplos

Ignorar erros de extração de metadados em um Step de redimensionamento de imagem:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "resized": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 1200,
      "ignore_errors": ["meta"]
    }
  }
}

Ignorar erros de importação em um Step de importação:

{
  "steps": {
    "imported": {
      "robot": "/s3/import",
      "credentials": "YOUR_S3_CREDENTIALS",
      "path": "/incoming/",
      "ignore_errors": ["import"]
    },
    "encoded": {
      "use": "imported",
      "robot": "/video/encode",
      "preset": "ipad-high"
    }
  }
}

Ignorar todas as fases suportadas:

{
  "steps": {
    "imported": {
      "robot": "/http/import",
      "url": "https://example.com/multi-file-feed.json",
      "ignore_errors": true
    }
  }
}

Notas e boas práticas

  • Use ignore_errors de forma intencional. Ele melhora a resiliência, mas pode ocultar problemas se for usado em excesso.
  • Prefira arrays direcionados (por exemplo, apenas ["meta"]) em vez de true quando possível.
  • Monitore o seu Assembly Status em busca de falhas ignoradas. Os erros ignorados são informados em campos como ignored_errors e ignored_error_count.
  • Se, em alguns cenários de importação, você ainda precisar emitir arquivos diante de problemas relacionados a metadados, revise também as opções específicas de cada Robot, como import_on_errors em 🤖/http/import  (English).