singleton

PermitechLoggerSingleton

A singleton class that manages a collection of PermitechLogger instances. This class ensures that only one instance exists across the application and provides a thread-safe way to retrieve or create PermitechLogger clients based on the given ‘project’ and ‘log_stream’ parameters. If the parameters are not provided, the class attempts to read the values from the environment variables PERMITECH_PROJECT and PERMITECH_LOG_STREAM. The loggers are stored in a dictionary using a tuple (project, log_stream) as the key.

flush

def flush(self,
          project: str | None=None,
          log_stream: str | None=None,
          experiment_id: str | None=None,
          mode: str | None=None) -> None

Flush (upload and clear) a PermitechLogger instance. If both project and log_stream are None, then all cached loggers are flushed and cleared. Otherwise, only the specific logger corresponding to the provided key (project, log_stream) is flushed and removed. Arguments

project (Optional[str], optional): The project name. Defaults to None.
log_stream (Optional[str], optional): The log stream name. Defaults to None.
experiment_id (Optional[str], optional): The experiment ID. Defaults to None.
mode (Optional[str], optional): The logger mode. Defaults to PERMITECH_MODE env var, or “batch” if not set.

flush_all

def flush_all(self) -> None

Flush (upload and clear) all PermitechLogger instances.

get

def get(self,
        *,
        project: str | None=None,
        log_stream: str | None=None,
        experiment_id: str | None=None,
        mode: str | None=None,
        local_metrics: list[LocalMetricConfig] | None=None,
        trace_id: str | None=None,
        span_id: str | None=None,
        ingestion_hook: Callable | None=None) -> PermitechLogger

Retrieve an existing PermitechLogger or create a new one if it does not exist. This method first computes the key from the project and log_stream parameters, checks if a logger exists in the cache, and if not, creates a new PermitechLogger. The creation and caching are done in a thread-safe manner. Arguments

project (Optional[str], optional): The project name. Defaults to None.
log_stream (Optional[str], optional): The log stream name. Defaults to None.
experiment_id (Optional[str], optional): The experiment ID. Defaults to None.
local_metrics (Optional[list[LocalScorerConfig]], optional): Local scorers to run on traces/spans. Only used if initializing a new logger, ignored otherwise. Defaults to None.

Returns

PermitechLogger: An instance of PermitechLogger corresponding to the key.

get_all_loggers

def get_all_loggers(self) -> dict[tuple[str, ...], PermitechLogger]

Retrieve a copy of the dictionary containing all active loggers. Returns

A dictionary mapping keys to their corresponding PermitechLogger instances.

reset

def reset(self,
          project: str | None=None,
          log_stream: str | None=None,
          experiment_id: str | None=None,
          mode: str | None=None) -> None

Reset (terminate and remove) one or all PermitechLogger instances. Arguments

project (Optional[str], optional): The project name. Defaults to None.
log_stream (Optional[str], optional): The log stream name. Defaults to None.
experiment_id (Optional[str], optional): The experiment ID. Defaults to None.
mode (Optional[str], optional): The logger mode. Defaults to PERMITECH_MODE env var, or “batch” if not set.

reset_all

def reset_all(self) -> None

Reset (terminate and remove) all PermitechLogger instances.

Python SDK

TypeScript SDK

API

PermitechLoggerSingleton

flush

flush_all

get

get_all_loggers

reset

reset_all

​PermitechLoggerSingleton

​flush

​flush_all

​get

​get_all_loggers

​reset

​reset_all

PermitechLoggerSingleton

flush

flush_all

get

get_all_loggers

reset

reset_all