logging_utilities Module

Module utilitaire utilisé pour la journalisation.

Fonctions

function_debug_log_wrapped

Ajouter un wrapper de journaux autour de la fonction de classe de transformateur.

function_debug_log_wrapped(log_level: int = 10) -> Callable[[Callable[[...], Any]], Callable[[...], Any]]

Paramètres

log_level
valeur par défaut: 10

get_logger

Créer l’enregistreur d’événements avec un hook de télémétrie.

get_logger(namespace: str | None = None, filename: str | None = None, verbosity: int = 10, extra_handlers: List[Handler] | None = None, component_name: str | None = None) -> Logger

Paramètres

namespace
valeur par défaut: None

Espace de noms pour l’enregistreur d’événements

filename
valeur par défaut: None

Nom du fichier journal

verbosity
valeur par défaut: 10

Verbosité de la journalisation

extra_handlers
valeur par défaut: None

Gestionnaires supplémentaires à attacher à l’enregistreur d’événements

component_name
valeur par défaut: None

nom du composant

Retours

Enregistreur d’événements si le nom du fichier journal et l’espace de noms sont fournis, sinon enregistreur d’événements Null

is_exception_stacktrace_loggable

is_exception_stacktrace_loggable() -> bool

is_non_automl_exception_allowed

is_non_automl_exception_allowed(exception: BaseException) -> bool

Paramètres

exception

is_path_allowed

is_path_allowed(exception_path: str) -> bool

Paramètres

exception_path

is_stdlib_module

Déterminer s’il s’agit d’un module fourni avec Python.

is_stdlib_module(exception_path: str) -> bool

Paramètres

exception_path
Obligatoire

log_activity

Consigner l’état de l’activité avec la durée.

log_activity(logger: Logger, activity_name: str, activity_type: str | None = None, custom_dimensions: Dict[str, Any] | None = None) -> Iterator[Any | None]

Paramètres

logger
Obligatoire

logger

activity_name
Obligatoire

Nom de l’activité

activity_type
Obligatoire

Type d’activité

custom_dimensions
Obligatoire

Dimensions personnalisées

log_system_info

Consigner les informations sur le processeur, la mémoire et le système d’exploitation.

log_system_info(logger: Logger, prefix_message: str = '') -> None

Paramètres

logger
Obligatoire

Objet Logger

prefix_message
Obligatoire

Chaîne située dans le préfixe du journal

Retours

None

log_traceback

Journaliser les traces d’exception.

log_traceback(exception: BaseException, logger: Logger | LoggerAdapter | None, override_error_msg: str | None = None, is_critical: bool | None = True, tb: Any | None = None) -> None

Paramètres

exception
Obligatoire

Exception à consigner.

logger
Obligatoire

Enregistreur d'événements à utiliser.

override_error_msg
valeur par défaut: None

Message à afficher pour remplacer le error_msg actuel.

is_critical
valeur par défaut: True

Si la valeur est is_critical, l’enregistreur d’événements utilise log.critical, sinon log.error.

tb
valeur par défaut: None

Traceback à utiliser pour la journalisation ; s’il n’est pas fourni, l’élément attaché à l’exception est utilisé.

mark_package_exceptions_as_loggable

mark_package_exceptions_as_loggable(module: module) -> None

Paramètres

module

mark_path_as_loggable

mark_path_as_loggable(path: str) -> None

Paramètres

path

mark_path_as_not_loggable

mark_path_as_not_loggable(path: str) -> None

Paramètres

path

remove_blacklisted_logging_keys_from_dict

Supprimer de manière récursive la clé d’un dictionnaire.

remove_blacklisted_logging_keys_from_dict(dict_obj: Dict[str, Any]) -> None

Paramètres

dict_obj

remove_blacklisted_logging_keys_from_json_str

Supprimer de manière récursive la clé d’une chaîne json et retourner une chaîne json.

remove_blacklisted_logging_keys_from_json_str(json_str: str) -> str

Paramètres

json_str