Interface TaskTraceListener


public interface TaskTraceListener
Optional read-only diagnostics. Callbacks must return promptly and never access disk.
  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    execution(String node, String stage, boolean consumed, long nanos, Throwable error)
    A node's execute started or finished.
    default void
    selected(String node, long nanos)
    One selection pass finished.
    default void
    validation(String node, int priority, String result, long nanos, Throwable error)
    One node was considered during selection.
  • Method Details

    • selected

      default void selected(String node, long nanos)
      One selection pass finished.
      Parameters:
      node - the selected node's name, or null when no node validated
      nanos - time the whole pass took
    • validation

      default void validation(String node, int priority, String result, long nanos, Throwable error)
      One node was considered during selection.
      Parameters:
      result - "eligible", "ineligible", "error", "disabled" or "lower_priority" (skipped without asking because a better node was found)
      nanos - time spent in shouldExecute (0 when it was not called)
      error - the exception thrown by shouldExecute, or null
    • execution

      default void execution(String node, String stage, boolean consumed, long nanos, Throwable error)
      A node's execute started or finished.
      Parameters:
      stage - "started" or "finished"
      consumed - the node's return value (always false for "started")
      nanos - execution time (0 for "started")
      error - the exception thrown by execute or getStatus, or null