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.

Attributes¶

DEFAULT_LOG_DIR

Functions¶

log_entity_operation(→ None)

Log an entity operation with standardized format.

setup_discovery_logger(→ logging.Logger)

Set up a logger for discovery operations.

setup_import_logger(→ logging.Logger)

Set up a logger for import operations.

setup_logger(→ logging.Logger)

Set up a logger with file and optional console handlers.

setup_operation_logger(→ logging.Logger)

Set up a logger for registry operations.

Module Contents¶

dataflow.utils.logging.log_entity_operation(logger: logging.Logger, operation: str, entity_type: str, entity_name: str, entity_id: str | None = None, status: str = 'success', details: dict[str, Any] | None = None, error: Exception | None = None) → None¶

Log an entity operation with standardized format.

Parameters:

  • logger – Logger to use

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

  • entity_type – Type of entity

  • entity_name – Name of entity

  • entity_id – Optional ID of entity

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

  • details – Optional additional details

  • error – Optional exception if operation failed

dataflow.utils.logging.setup_discovery_logger(subtype: str | None = None) → logging.Logger¶

Set up a logger for discovery operations.

Parameters:

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

Returns:

Configured logger

dataflow.utils.logging.setup_import_logger() → logging.Logger¶

Set up a logger for import operations.

Returns:

Configured logger

dataflow.utils.logging.setup_logger(name: str, log_file: str | None = None, level: int = logging.INFO, format_str: str | None = None, log_to_console: bool = True) → logging.Logger¶

Set up a logger with file and optional console handlers.

Parameters:

  • name – Logger name

  • log_file – Optional path to log file

  • level – Logging level

  • format_str – Optional format string for log messages

  • log_to_console – Whether to log to console

Returns:

Configured logger

dataflow.utils.logging.setup_operation_logger() → logging.Logger¶

Set up a logger for registry operations.

Returns:

Configured logger

dataflow.utils.logging.DEFAULT_LOG_DIR¶