Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion aws_lambda_powertools/logging/buffer/functions.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ def _create_buffer_record(
exc_info: logging._ExcInfoType = None,
stack_info: bool = False,
extra: Mapping[str, object] | None = None,
depth: int = 4,
) -> dict[str, Any]:
"""
Create a structured log record for buffering to save in buffer.
Expand Down Expand Up @@ -47,7 +48,7 @@ def _create_buffer_record(
"""
# Retrieve the caller's frame information to capture precise log context
# Uses inspect.stack() with index 3 to get the original caller's details
caller_frame = sys._getframe(3)
caller_frame = sys._getframe(depth)

# Get the current timestamp
timestamp = time.time()
Expand Down
207 changes: 96 additions & 111 deletions aws_lambda_powertools/logging/logger.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
from typing import IO, TYPE_CHECKING, Any, TypeVar, cast, overload

from aws_lambda_powertools.logging.buffer.cache import LoggerBufferCache
from aws_lambda_powertools.logging.buffer.functions import _check_minimum_buffer_log_level, _create_buffer_record
from aws_lambda_powertools.logging.buffer.functions import _create_buffer_record
from aws_lambda_powertools.logging.constants import (
LOGGER_ATTRIBUTE_HANDLER,
LOGGER_ATTRIBUTE_POWERTOOLS_HANDLER,
Expand Down Expand Up @@ -567,8 +567,9 @@ def decorate(event, context, *args, **kwargs):

return decorate

def debug(
def _log(
self,
level: int | str,
msg: object,
*args: object,
exc_info: logging._ExcInfoType = None,
Expand All @@ -580,18 +581,16 @@ def debug(
extra = extra or {}
extra = {**extra, **kwargs}

# Logging workflow for logging.debug:
# 1. Buffer is completely disabled - log right away
# 2. DEBUG is the maximum level of buffer, so, can't bypass if enabled
# 3. Store in buffer for potential later processing
level_num = logging.getLevelName(level) if isinstance(level, str) else level
if not isinstance(level_num, int):
raise ValueError(f"Unknown level: {level!r}")

# MAINTAINABILITY_DECISION:
# Keeping this implementation to avoid complex code handling.
# Also for clarity over complexity
if level_num >= logging.ERROR:
if self._buffer_config and self._buffer_config.flush_on_error_log:
self.flush_buffer()

# Buffer is not active and we need to log immediately
if not self._buffer_config:
return self._logger.debug(
return self._logger.log(
level_num,
msg,
*args,
exc_info=exc_info,
Expand All @@ -600,41 +599,10 @@ def debug(
extra=extra,
)

# Store record in the buffer
self._add_log_record_to_buffer(
level=logging.DEBUG,
msg=msg,
args=args,
exc_info=exc_info,
stack_info=stack_info,
extra=extra,
)

def info(
self,
msg: object,
*args: object,
exc_info: logging._ExcInfoType = None,
stack_info: bool = False,
stacklevel: int = 2,
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
extra = extra or {}
extra = {**extra, **kwargs}

# Logging workflow for logging.info:
# 1. Buffer is completely disabled - log right away
# 2. Log severity exceeds buffer's minimum threshold - bypass buffering
# 3. If neither condition met, store in buffer for potential later processing

# MAINTAINABILITY_DECISION:
# Keeping this implementation to avoid complex code handling.
# Also for clarity over complexity

# Buffer is not active and we need to log immediately
if not self._buffer_config:
return self._logger.info(
return self._logger.log(
level_num,
msg,
*args,
exc_info=exc_info,
Expand All @@ -644,8 +612,9 @@ def info(
)

# Bypass buffer when log severity meets or exceeds configured minimum
if _check_minimum_buffer_log_level(self._buffer_config.buffer_at_verbosity, "INFO"):
return self._logger.info(
if level_num > logging.getLevelName(self._buffer_config.buffer_at_verbosity):
return self._logger.log(
level_num,
msg,
*args,
exc_info=exc_info,
Expand All @@ -656,15 +625,15 @@ def info(

# Store record in the buffer
self._add_log_record_to_buffer(
level=logging.INFO,
level=level_num,
msg=msg,
args=args,
exc_info=exc_info,
stack_info=stack_info,
extra=extra,
)

def warning(
def debug(
self,
msg: object,
*args: object,
Expand All @@ -674,48 +643,57 @@ def warning(
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
extra = extra or {}
extra = {**extra, **kwargs}

# Logging workflow for logging.warning:
# 1. Buffer is completely disabled - log right away
# 2. Log severity exceeds buffer's minimum threshold - bypass buffering
# 3. If neither condition met, store in buffer for potential later processing

# MAINTAINABILITY_DECISION:
# Keeping this implementation to avoid complex code handling.
# Also for clarity over complexity

# Buffer is not active and we need to log immediately
if not self._buffer_config:
return self._logger.warning(
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel,
extra=extra,
)
return self._log(
logging.DEBUG,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

# Bypass buffer when log severity meets or exceeds configured minimum
if _check_minimum_buffer_log_level(self._buffer_config.buffer_at_verbosity, "WARNING"):
return self._logger.warning(
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel,
extra=extra,
)
def info(
self,
msg: object,
*args: object,
exc_info: logging._ExcInfoType = None,
stack_info: bool = False,
stacklevel: int = 2,
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
return self._log(
logging.INFO,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

# Store record in the buffer
self._add_log_record_to_buffer(
level=logging.WARNING,
msg=msg,
args=args,
def warning(
self,
msg: object,
*args: object,
exc_info: logging._ExcInfoType = None,
stack_info: bool = False,
stacklevel: int = 2,
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
return self._log(
logging.WARNING,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

def error(
Expand All @@ -728,24 +706,15 @@ def error(
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
extra = extra or {}
extra = {**extra, **kwargs}

# Workflow: Error Logging with automatic buffer flushing
# 1. Buffer configuration checked for immediate flush
# 2. If auto-flush enabled, trigger complete buffer processing
# 3. Error log is not "bufferable", so ensure error log is immediately available

if self._buffer_config and self._buffer_config.flush_on_error_log:
self.flush_buffer()

return self._logger.error(
return self._log(
logging.ERROR,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

def critical(
Expand All @@ -758,26 +727,42 @@ def critical(
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
extra = extra or {}
extra = {**extra, **kwargs}

# Workflow: Error Logging with automatic buffer flushing
# 1. Buffer configuration checked for immediate flush
# 2. If auto-flush enabled, trigger complete buffer processing
# 3. Critical log is not "bufferable", so ensure error log is immediately available

if self._buffer_config and self._buffer_config.flush_on_error_log:
self.flush_buffer()
return self._log(
logging.CRITICAL,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

return self._logger.critical(
def log(
self,
level: int | str,
msg: object,
*args: object,
exc_info: logging._ExcInfoType = None,
stack_info: bool = False,
stacklevel: int = 2,
extra: Mapping[str, object] | None = None,
**kwargs: object,
) -> None:
return self._log(
level,
msg,
*args,
exc_info=exc_info,
stack_info=stack_info,
stacklevel=stacklevel,
stacklevel=stacklevel + 1,
extra=extra,
**kwargs,
)

warn = warning
fatal = critical

def exception(
self,
msg: object,
Expand Down
Loading