Skip to content

docs(agents): document replay-aware logging for DurableAgent#5149

Open
Rishabh-git10 wants to merge 3 commits into
dapr:v1.17from
Rishabh-git10:docs/dapr-agents-context-logger
Open

docs(agents): document replay-aware logging for DurableAgent#5149
Rishabh-git10 wants to merge 3 commits into
dapr:v1.17from
Rishabh-git10:docs/dapr-agents-context-logger

Conversation

@Rishabh-git10
Copy link
Copy Markdown

Thank you for helping make the Dapr documentation better!

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within tabpane
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have tabpane

In addition, please fill out the following to help reviewers understand this pull request:

Description

Added a "Replay-Aware Logging" subsection to the DurableAgent core concepts documentation. This details the usage of the new ContextAwareLogger utility, explaining how it hooks into the DaprWorkflowContext to seamlessly suppress duplicate log records during workflow state rehydration.

Issue reference

Relates to implementation in dapr/dapr-agents#225

Signed-off-by: Rishabh Dewangan <107680241+Rishabh-git10@users.noreply.github.com>
@Rishabh-git10 Rishabh-git10 requested review from a team as code owners April 26, 2026 10:37
@Rishabh-git10 Rishabh-git10 marked this pull request as draft April 26, 2026 10:43
@Rishabh-git10 Rishabh-git10 marked this pull request as ready for review April 26, 2026 11:17
Copy link
Copy Markdown
Contributor

@nelson-parente nelson-parente left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pre-review for @marcduiker handoff: LGTM with nits.

  • The replay-aware logging subsection is a useful addition for DurableAgent users.
  • The code example is Python and correctly uses get_context_aware_logger from dapr_agents.utils.
  • Nit: double blank line before ## Core Agent Features heading (cosmetic).
  • Nit: the @workflow_entry decorator shown in the example isn't imported — consider adding the import or removing the decorator if it's just illustrative, to avoid reader confusion.
    Nothing blocking — Marc, your call.

Signed-off-by: Rishabh Dewangan <107680241+Rishabh-git10@users.noreply.github.com>
@Rishabh-git10
Copy link
Copy Markdown
Author

Thanks for the review @nelson-parente. I've addressed the nits just in case.
Ready for you, @marcduiker.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants