发布

  • [OPIK-5664] [SDK][DOCS] feat: add batching warning docs page and suppress config (#6149)

    frostbyte_neo 发布于 2026-04-09 14:29:33 +00:00

    • [OPIK-5664] [SDK][DOCS] feat: add batching warning docs page and suppress config
    • Add documentation page explaining batching and update operations
      with recommended alternatives (decorators, context managers,
      passing end_time at creation, disabling batching)
    • Add suppress_batching_update_warning config option
      (env var: OPIK_SUPPRESS_BATCHING_UPDATE_WARNING)
    • Thread OpikConfig through Span/Trace constructors to avoid
      constructing config on every warning check
    • Update warning message to link to the documentation page

    Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

    • docs: document overwrite alternative in Trace/Span end()/update() docstrings

    Also make Trace.config non-optional since the only caller always provides it.

    Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

    • fix: address PR review comments
    • Extract shared warn_if_batching_update helper in helpers.py
    • Forward config to child spans in Trace.span() and Span.span()
    • Rename batching_and_updates.mdx to kebab-case, move to
      Reference > Python SDK > Troubleshooting section
    • Add redirect for old URL
    • Add doc links to @track and start_as_current_span sections
    • Remove start_as_current_trace from example (keep only start_as_current_span)
    • Update all doc URLs to new location

    Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

    • refactor: use named arguments for warn_if_batching_update calls

    Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

    • chore: linter formatting fixes

    Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

    • Fix linter

    Co-authored-by: Claude Opus 4.6 (1M context) noreply@anthropic.com

    下载附件