harnest.logging

All Python modules · Import and compatibility guidance

Exports

Name	Kind
`Logger`	Class
`get_logger`	Function

Logger

A small structured facade over an agent-scoped standard logger. Obtain this object from the owning Harnest API; its constructor includes runtime bindings. Fields (— means no declared default):

Field	Type	Default
`name`	`str`	`—`

Example

from harnest.logging import Logger

logger: Logger  # returned by Harnest, not constructed directly

Logger.stdlib

Return the underlying standard-library logger.

Example

from harnest.logging import Logger

logger: Logger
value = logger.stdlib

Logger.bind

Logger.bind(**attributes: Any) -> 'Logger'

Return a logger carrying immutable attributes on every record.

Parameters and example

Parameter	Type	Default
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger = logger.bind()

Logger.log

Logger.log(level: int, event: str, *args: Any, exc_info: Any = None, **attributes: Any) -> None

Emit a structured event at an explicit standard logging level.

Parameters and example

Parameter	Type	Default
`level`	`int`	Required
`event`	`str`	Required
`*args`	`Any`	Optional
`exc_info`	`Any`	`None`
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.log(level=..., event=...)

Logger.debug

Logger.debug(event: str, *args: Any, **attributes: Any) -> None

Emit a structured debug event.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.debug(event=...)

Logger.info

Logger.info(event: str, *args: Any, **attributes: Any) -> None

Emit a structured informational event.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.info(event=...)

Logger.warning

Logger.warning(event: str, *args: Any, **attributes: Any) -> None

Emit a structured warning event.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.warning(event=...)

Logger.error

Logger.error(event: str, *args: Any, **attributes: Any) -> None

Emit a structured error event.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.error(event=...)

Logger.critical

Logger.critical(event: str, *args: Any, **attributes: Any) -> None

Emit a structured critical event.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.critical(event=...)

Logger.exception

Logger.exception(event: str, *args: Any, **attributes: Any) -> None

Emit an error event carrying the active exception traceback.

Parameters and example

Parameter	Type	Default
`event`	`str`	Required
`*args`	`Any`	Optional
`**attributes`	`Any`	Optional

from harnest.logging import Logger

logger: Logger
logger.exception(event=...)

get_logger

Create a structured logger in Harnest’s agent logging namespace.

get_logger(name: str = 'agent', **attributes: Any) -> Logger

Parameters and example

Parameter	Type	Default
`name`	`str`	`'agent'`
`**attributes`	`Any`	Optional

from harnest.logging import get_logger

logger = get_logger()

Overview

Get started

Harnest Studio

Guides

API reference

harnest.logging

Exports

Logger

Logger.stdlib

Logger.bind

Logger.log

Logger.debug

Logger.info

Logger.warning

Logger.error

Logger.critical

Logger.exception

get_logger

​Exports

​Logger

​Logger.stdlib

​Logger.bind

​Logger.log

​Logger.debug

​Logger.info

​Logger.warning

​Logger.error

​Logger.critical

​Logger.exception

​get_logger

Exports

Logger

Logger.stdlib

Logger.bind

Logger.log

Logger.debug

Logger.info

Logger.warning

Logger.error

Logger.critical

Logger.exception

get_logger