nvflare.app_common.utils.error_handling_utils module

get_error_handling_message(ignore_result_error: bool | None, client_name: str, error_code: Any, current_round: int | None, controller_name: str, failed_clients: Set[str], num_targets: int, min_responses: int) → str

Generate appropriate log message based on error handling mode.

Parameters:

• ignore_result_error – The error handling mode (None, False, or True).

• client_name – Name of the client with the error.

• error_code – The return code from the client result (ReturnCode constant or None).

• current_round – Current training round (may be None if not set in result).

• controller_name – Name of the controller class.

• failed_clients – Set of client names that have failed.

• num_targets – Total number of target clients.

• min_responses – Minimum number of responses required.

Returns:

Appropriate message string for logging.

should_ignore_result_error(ignore_result_error: bool | None, client_name: str, failed_clients: Set[str], num_targets: int, min_responses: int) → bool

Determine whether a client result error should be ignored or cause a panic.

This function implements the three-mode error handling policy: - None (Dynamic): Ignore errors if min_responses can still be reached, panic otherwise. - False (Strict): Never ignore errors, always panic. - True (Resilient): Always ignore errors, never panic.

Note: This function can be safely called multiple times for the same client error. The failed_clients set uses idempotent add() operations, so duplicate calls for the same client will not affect the remaining count calculation.

Parameters:

• ignore_result_error – The error handling mode. - None: Dynamic mode - ignore if min_responses still reachable. - False: Strict mode - always panic on error. - True: Resilient mode - always ignore errors.

• client_name – Name of the client with the error.

• failed_clients – Set of client names that have already failed (will be updated in dynamic mode only).

• num_targets – Total number of target clients for the current task.

• min_responses – Minimum number of responses required.

Returns:

True if the error should be ignored (no panic needed). False if a panic should be triggered.