[PR #24303] [CLOSED] fix: persist Responses streaming usage #66448

Closed
opened 2026-05-06 12:48:58 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/open-webui/pull/24303
Author: @Genmin
Created: 5/1/2026
Status: Closed

Base: devHead: fix/responses-usage-analytics


📝 Commits (10+)

📊 Changes

3 files changed (+63 additions, -5 deletions)

View changed files

backend/open_webui/test/utils/test_response.py (+37 -0)
📝 backend/open_webui/utils/middleware.py (+2 -1)
📝 backend/open_webui/utils/response.py (+24 -4)

📄 Description

Pull Request Checklist

Before submitting, make sure you've checked the following:

  • Target branch: Verify that the pull request targets the dev branch. PRs targeting main will be immediately closed.
  • Description: Provide a concise description of the changes made in this pull request down below.
  • Changelog: Ensure a changelog entry following the format of Keep a Changelog is added at the bottom of the PR description.
  • Documentation: Add docs in Open WebUI Docs Repository. Document user-facing behavior, environment variables, public APIs/interfaces, or deployment steps.
  • Dependencies: Are there any new or upgraded dependencies? If so, explain why, update the changelog/docs, and include any compatibility notes. Actually run the code/function that uses updated library to ensure it doesn't crash.
  • Testing: Perform manual tests to verify the implemented fix/feature works as intended AND does not break any other functionality. Include reproducible steps to demonstrate the issue before the fix. Test edge cases (URL encoding, HTML entities, types). Take this as an opportunity to make screenshots of the feature/fix and include them in the PR description.
  • Agentic AI Code: Confirm this Pull Request is not written by any AI Agent or has at least gone through additional human review AND manual testing. If any AI Agent is the co-author of this PR, it may lead to immediate closure of the PR.
  • Code review: Have you performed a self-review of your code, addressing any coding standard issues and ensuring adherence to the project's coding standards?
  • Design & Architecture: Prefer smart defaults over adding new settings; use local state for ephemeral UI logic. Open a Discussion for major architectural or UX changes.
  • Git Hygiene: Keep PRs atomic (one logical change). Clean up commits and rebase on dev to ensure no unrelated commits (e.g. from main) are included. Push updates to the existing PR branch instead of closing and reopening.
  • Title Prefix: Pull request title uses the fix prefix.

Summary

Fixes #24217.
Related to #24294.

This fixes Admin Analytics token accounting for OpenAI Responses API streaming chats. The streaming path already receives final usage metadata on the response.completed event, but the metadata was not being normalized into the usage shape saved with the chat event, so analytics could count messages while showing zero tokens.

Testing

  • Reproduced the issue path with a Responses-style streaming event sequence whose final response.completed payload includes usage.
  • Added a regression test that verifies emitted metadata contains normalized token counts after the final Responses event.
  • Verified the targeted utility and middleware files compile.

Commands run:

  • PYTHONPATH=backend uv run --no-sync --with pytest --with typer --with uvicorn pytest backend/open_webui/test/utils/test_response.py -q
  • uv run --no-sync --with ruff ruff check backend/open_webui/utils/response.py backend/open_webui/test/utils/test_response.py
  • python3 -m compileall -q backend/open_webui/utils/response.py backend/open_webui/utils/middleware.py backend/open_webui/test/utils/test_response.py
  • git diff --check

Screenshots/videos are not applicable for this backend metadata normalization fix; the regression test directly covers the previously missing persisted usage shape.

Changelog Entry

Description

  • Persist token usage emitted by Responses API streaming response.completed events so Admin Analytics can aggregate it.

Added

  • Regression coverage for Responses streaming usage metadata normalization.

Changed

  • Normalized Responses API usage before emitting and saving streaming chat metadata, matching the existing Chat Completions streaming path.

Deprecated

  • None.

Removed

  • None.

Fixed

  • Fixed Responses API streaming chats showing zero tokens in Admin Analytics even when final usage metadata was available.

Security

  • None.

Breaking Changes

  • None.

Additional Information

  • No dependencies were added or upgraded.

Screenshots or Videos

  • Not applicable; backend metadata/test-only verification.

Contributor License Agreement

Note

Deleting the CLA section will lead to immediate closure of your PR and it will not be merged in.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/open-webui/pull/24303 **Author:** [@Genmin](https://github.com/Genmin) **Created:** 5/1/2026 **Status:** ❌ Closed **Base:** `dev` ← **Head:** `fix/responses-usage-analytics` --- ### 📝 Commits (10+) - [`fe6783c`](https://github.com/open-webui/open-webui/commit/fe6783c16699911c7be17392596d579333fb110c) Merge pull request #19030 from open-webui/dev - [`fc05e0a`](https://github.com/open-webui/open-webui/commit/fc05e0a6c5d39da60b603b4d520f800d6e36f748) Merge pull request #19405 from open-webui/dev - [`e3faec6`](https://github.com/open-webui/open-webui/commit/e3faec62c58e3a83d89aa3df539feacefa125e0c) Merge pull request #19416 from open-webui/dev - [`9899293`](https://github.com/open-webui/open-webui/commit/9899293f050ad50ae12024cbebee7e018acd851e) Merge pull request #19448 from open-webui/dev - [`140605e`](https://github.com/open-webui/open-webui/commit/140605e660b8186a7d5c79fb3be6ffb147a2f498) Merge pull request #19462 from open-webui/dev - [`6f1486f`](https://github.com/open-webui/open-webui/commit/6f1486ffd0cb288d0e21f41845361924e0d742b3) Merge pull request #19466 from open-webui/dev - [`d95f533`](https://github.com/open-webui/open-webui/commit/d95f533214e3fe5beb5e41ec1f349940bc4c7043) Merge pull request #19729 from open-webui/dev - [`a727153`](https://github.com/open-webui/open-webui/commit/a7271532f8a38da46785afcaa7e65f9a45e7d753) 0.6.43 (#20093) - [`6adde20`](https://github.com/open-webui/open-webui/commit/6adde203cd292a9e3af9c64a2ae36b603fed096a) Merge pull request #20394 from open-webui/dev - [`f9b0534`](https://github.com/open-webui/open-webui/commit/f9b0534e0c442631d1cb7205169588b9b6204179) Merge pull request #20522 from open-webui/dev ### 📊 Changes **3 files changed** (+63 additions, -5 deletions) <details> <summary>View changed files</summary> ➕ `backend/open_webui/test/utils/test_response.py` (+37 -0) 📝 `backend/open_webui/utils/middleware.py` (+2 -1) 📝 `backend/open_webui/utils/response.py` (+24 -4) </details> ### 📄 Description # Pull Request Checklist **Before submitting, make sure you've checked the following:** - [x] **Target branch:** Verify that the pull request targets the `dev` branch. **PRs targeting `main` will be immediately closed.** - [x] **Description:** Provide a concise description of the changes made in this pull request down below. - [x] **Changelog:** Ensure a changelog entry following the format of [Keep a Changelog](https://keepachangelog.com/) is added at the bottom of the PR description. - [ ] **Documentation:** Add docs in [Open WebUI Docs Repository](https://github.com/open-webui/docs). Document user-facing behavior, environment variables, public APIs/interfaces, or deployment steps. - [ ] **Dependencies:** Are there any new or upgraded dependencies? If so, explain why, update the changelog/docs, and include any compatibility notes. Actually run the code/function that uses updated library to ensure it doesn't crash. - [x] **Testing:** Perform manual tests to **verify the implemented fix/feature works as intended AND does not break any other functionality**. Include reproducible steps to demonstrate the issue before the fix. Test edge cases (URL encoding, HTML entities, types). Take this as an opportunity to **make screenshots of the feature/fix and include them in the PR description**. - [ ] **Agentic AI Code:** Confirm this Pull Request is **not written by any AI Agent** or has at least **gone through additional human review AND manual testing**. If any AI Agent is the co-author of this PR, it may lead to immediate closure of the PR. - [x] **Code review:** Have you performed a self-review of your code, addressing any coding standard issues and ensuring adherence to the project's coding standards? - [x] **Design & Architecture:** Prefer smart defaults over adding new settings; use local state for ephemeral UI logic. Open a Discussion for major architectural or UX changes. - [x] **Git Hygiene:** Keep PRs atomic (one logical change). Clean up commits and rebase on `dev` to ensure no unrelated commits (e.g. from `main`) are included. Push updates to the existing PR branch instead of closing and reopening. - [x] **Title Prefix:** Pull request title uses the `fix` prefix. ## Summary Fixes #24217. Related to #24294. This fixes Admin Analytics token accounting for OpenAI Responses API streaming chats. The streaming path already receives final usage metadata on the `response.completed` event, but the metadata was not being normalized into the usage shape saved with the chat event, so analytics could count messages while showing zero tokens. ## Testing - Reproduced the issue path with a Responses-style streaming event sequence whose final `response.completed` payload includes usage. - Added a regression test that verifies emitted metadata contains normalized token counts after the final Responses event. - Verified the targeted utility and middleware files compile. Commands run: - `PYTHONPATH=backend uv run --no-sync --with pytest --with typer --with uvicorn pytest backend/open_webui/test/utils/test_response.py -q` - `uv run --no-sync --with ruff ruff check backend/open_webui/utils/response.py backend/open_webui/test/utils/test_response.py` - `python3 -m compileall -q backend/open_webui/utils/response.py backend/open_webui/utils/middleware.py backend/open_webui/test/utils/test_response.py` - `git diff --check` Screenshots/videos are not applicable for this backend metadata normalization fix; the regression test directly covers the previously missing persisted usage shape. # Changelog Entry ### Description - Persist token usage emitted by Responses API streaming `response.completed` events so Admin Analytics can aggregate it. ### Added - Regression coverage for Responses streaming usage metadata normalization. ### Changed - Normalized Responses API usage before emitting and saving streaming chat metadata, matching the existing Chat Completions streaming path. ### Deprecated - None. ### Removed - None. ### Fixed - Fixed Responses API streaming chats showing zero tokens in Admin Analytics even when final usage metadata was available. ### Security - None. ### Breaking Changes - None. --- ### Additional Information - No dependencies were added or upgraded. ### Screenshots or Videos - Not applicable; backend metadata/test-only verification. ### Contributor License Agreement <!-- 🚨 DO NOT DELETE THE TEXT BELOW 🚨 Keep the "Contributor License Agreement" confirmation text intact. Deleting it will trigger the CLA-Bot to INVALIDATE your PR. Your PR will NOT be reviewed or merged until you check the box below confirming that you have read and agree to the terms of the CLA. --> - [ ] By submitting this pull request, I confirm that I have read and fully agree to the [Contributor License Agreement (CLA)](https://github.com/open-webui/open-webui/blob/main/CONTRIBUTOR_LICENSE_AGREEMENT), and I am providing my contributions under its terms. > [!NOTE] > Deleting the CLA section will lead to immediate closure of your PR and it will not be merged in. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-05-06 12:48:58 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#66448