docs: add Track Spend by Tag page for cost-allocation tags - #149
Merged
micheleRP merged 8 commits intoJul 24, 2026
Conversation
Document the cost-allocation tags feature: agents' key/value tags can now group and filter LLM spend in Cost & Usage for chargeback by department, team, or environment. - New page control:cost-allocation-tags.adoc (GA) covering how attribution works (point-in-time, ~15s propagation, Untagged bucket), tagging agents, the Group by Tag and tag-filter UI, the SpendingService API surface (BREAKDOWN_DIMENSION_TAG, tag_key, GetSpendingTagKeys), limits, and troubleshooting. - Add BREAKDOWN_DIMENSION_TAG to the breakdown-dimension list in budgets.adoc with a cross-link. - Add the page to the Control & Govern nav. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
👷 Deploy request for redpanda-agentic-data-plane pending review.Visit the deploys page to approve it
|
Drop the internal poll-cycle mechanism and the specific ~15s interval from the propagation behavior; state only the user-observable fact that tag changes take a short time to take effect. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
The AIP-160 identifier-safe key limitation on the tag filter is being removed, so document grouping and filtering as working for any tag key. Removes the restriction from the tagging guidance, the Group by Tag and tag-filter descriptions, the tag_key field notes, the filter section, the limits table, and troubleshooting. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Verified the tag spending API against the ign integration cluster: the JSON response uses camelCase (totalCostMicrocents, totalRequests), while request fields are snake_case. Correct the cURL response description, document the request/response casing explicitly, and update the source provenance to note live verification. Remove the stale not-yet-verified caveat comment. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
GetSpendingTagKeys is an internal helper the UI uses to populate its tag-key picker; an API consumer already knows the tag keys they set on their agents, so it is not useful in end-user docs. Remove the section and the helper-method mention from the API intro. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
micheleRP
reviewed
Jul 22, 2026
micheleRP
reviewed
Jul 22, 2026
micheleRP
reviewed
Jul 22, 2026
micheleRP
approved these changes
Jul 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Documents the cost-allocation tags feature: the key/value
tagson an agent can now group and filter LLM spend in Cost & Usage, so cost can be attributed to a department, team, or environment for chargeback.control:cost-allocation-tags.adoc(Track Spend by Tag, GA), covering:department/team/env), the no-secrets/PII rule, and the identifier-safe key rule for filtering.SpendingServiceAPI surface:BREAKDOWN_DIMENSION_TAG+tag_key, AIP-160tags.<key>filters, and the newGetSpendingTagKeysRPC, with a cURL example.BREAKDOWN_DIMENSION_TAGto the breakdown-dimension list with a cross-link.Provenance
Written from the cloudv2
feat/aigw-cost-allocation-tagsimplementation (protospending_service.proto/spending_event.proto/agent.proto, the aigw spending pipeline, and the adp-ui Cost & Usage tab). Verified against source; both a factual reviewer (against cloudv2 source) and a style reviewer (against the docs-site style guide) scored it 10/10.npm run buildpasses clean.Still to confirm before merge
COST_ALLOCATION_TAGSin cloudv2; confirm that flag is enabled/removed for the target release before publishing as GA.🤖 Generated with Claude Code