Function Runs

A function run is one function executing inside an execution plan. Every function the plan includes gets its own function run, and each of those is carried out by workers.

A function run sits between the transaction that will commit its output and the worker that does the processing, so it is the level to look at when you want to know how one particular function fared in a plan rather than how the plan as a whole did.

Logs

$ tdk fnrun logs --fnrun FNRUN

Pass --file - to write the log to stdout.

Recovery and replay

A failed function run can be retried on its own:

$ tdk fnrun recover --fnrun FNRUN

A function run that already finished can be run again, which is useful when the code changed but the inputs did not:

$ tdk fnrun replay --fnrun FNRUN

Finding a function run

tdk fnrun list narrows by collection, function, or the plan and transaction a run belongs to:

$ tdk fnrun list [--status R] [--coll C] [--fn F] [--plan P] [--trx T]
$ tdk fnrun get --fnrun FNRUN

See the CLI Guide for the full set of commands and the status codes each accepts.