dataflow.utils.logging¶

Logging utilities for the Haive Registry System.

This module provides logging utilities for the registry system, including setup functions for various log types.

Functions¶

log_entity_operation(logger, operation, entity_type, ...)

Log an entity operation with standardized format.

setup_discovery_logger([subtype])

Set up a logger for discovery operations.

setup_import_logger()

Set up a logger for import operations.

setup_logger(name[, log_file, level, format_str, ...])

Set up a logger with file and optional console handlers.

setup_operation_logger()

Set up a logger for registry operations.

Module Contents¶

dataflow.utils.logging.log_entity_operation(logger, operation, entity_type, entity_name, entity_id=None, status='success', details=None, error=None)¶

Log an entity operation with standardized format.

Parameters:

  • logger (logging.Logger) – Logger to use

  • operation (str) – Operation being performed (e.g., ‘register’, ‘update’)

  • entity_type (str) – Type of entity

  • entity_name (str) – Name of entity

  • entity_id (str | None) – Optional ID of entity

  • status (str) – Operation status (‘success’ or ‘failure’)

  • details (dict[str, Any] | None) – Optional additional details

  • error (Exception | None) – Optional exception if operation failed

Return type:

None

dataflow.utils.logging.setup_discovery_logger(subtype=None)¶

Set up a logger for discovery operations.

Parameters:

subtype (str | None) – Optional subtype (e.g., ‘agents’, ‘tools’)

Returns:

Configured logger

Return type:

logging.Logger

dataflow.utils.logging.setup_import_logger()¶

Set up a logger for import operations.

Returns:

Configured logger

Return type:

logging.Logger

dataflow.utils.logging.setup_logger(name, log_file=None, level=logging.INFO, format_str=None, log_to_console=True)¶

Set up a logger with file and optional console handlers.

Parameters:

  • name (str) – Logger name

  • log_file (str | None) – Optional path to log file

  • level (int) – Logging level

  • format_str (str | None) – Optional format string for log messages

  • log_to_console (bool) – Whether to log to console

Returns:

Configured logger

Return type:

logging.Logger

dataflow.utils.logging.setup_operation_logger()¶

Set up a logger for registry operations.

Returns:

Configured logger

Return type:

logging.Logger