Logging

Serverless ADR uses the shared ansys.dynamicreporting.core logger. PyDynamicReporting does not change the application’s root logger.

Write logs to standard output

Pass log_output="stdout" when constructing ADR:

import logging

from ansys.dynamicreporting.core.serverless import ADR

adr = ADR(
    ansys_installation=r"C:\Program Files\ANSYS Inc\v261",
    db_directory=r"C:\reports\database",
    log_output="stdout",
    log_level=logging.INFO,
)

Write logs to a file

Any other log_output value is treated as a file path:

adr = ADR(
    ansys_installation=r"C:\Program Files\ANSYS Inc\v261",
    db_directory=r"C:\reports\database",
    log_output=r"C:\reports\pydynamicreporting.log",
    log_level="DEBUG",
)

If log_level is omitted, the existing level on the shared ADR logger is left unchanged. If log_output is omitted, PyDynamicReporting adds no visible output handler.

Repeated calls with the same standard-output stream or normalized file path do not add duplicate PyDynamicReporting-owned handlers. This matters in serverless applications that initialize more than one ADR-backed component in the same process.

Configure the package logger directly

Use get_logger() when logging must be configured before constructing ADR:

from ansys.dynamicreporting.core.adr_utils import get_logger

logger = get_logger(log_output="stdout", log_level="WARNING")

The positional logfile argument remains available for compatibility but is deprecated. It emits DeprecationWarning. Passing both logfile and log_output raises ValueError.