Logging

Restate may replay a handler after a suspension or retry. Calls to Python’s standard logger run again during replay and can produce duplicate log entries.

Replay-aware logger

Use restate.getLogger() inside your service code to create a standard Python logger with RestateLoggingFilter already attached:

logger = restate.getLogger(__name__)


@service.handler()
async def greet(ctx: restate.Context, name: str) -> str:
    logger.info("Processing greeting for %s", name)
    return f"Hello, {name}!"

The filter suppresses records emitted while Restate is replaying the handler. Logs from the first execution attempt and logs emitted outside a Restate invocation are unaffected. Configure handlers, formatters, destinations, and log levels with Python’s standard logging APIs.

Add the replay filter to an existing logger

If your application or framework already creates its loggers, attach RestateLoggingFilter directly:

standard_logger = logging.getLogger("my-application")
standard_logger.addFilter(restate.RestateLoggingFilter())

Add the filter to every logger whose handler logs should be suppressed during replay.

Testing Services

⌘I

SDKs

Services

Restate Cloud

Restate BYOC

Self-hosted Restate

References

Replay-aware logger

Add the replay filter to an existing logger

​Replay-aware logger

​Add the replay filter to an existing logger

Replay-aware logger

Add the replay filter to an existing logger