Skip to content

docs(caches): Add cache.write and cache.operation to span data spec#17022

Draft
adinauer wants to merge 1 commit intomasterfrom
adinauer/caches-spec-cache-write
Draft

docs(caches): Add cache.write and cache.operation to span data spec#17022
adinauer wants to merge 1 commit intomasterfrom
adinauer/caches-spec-cache-write

Conversation

@adinauer
Copy link
Member

Add cache.write and cache.operation to the Caches module span data spec, and clarify that span operations should use the real method name.

cache.write indicates whether a cache operation resulted in a write to the cache. It reflects the actual outcome for conditional operations (e.g. putIfAbsent, replace) and is always true for unconditional writes. This is now set by the sentry-java SDK across its Spring Cache and JCache integrations.

cache.operation captures the specific cache method name, which is useful when SDKs use more granular span operations than the four base ops defined here.

The span operations section now notes that cache.<methodName> is the intended format, with the table serving as common examples rather than an exhaustive list.

Also fixes a typo: "sepreated" → "separated".

Add cache.write (bool) to the required span data table — indicates
whether a write-operation actually modified the cache, reflecting the
actual outcome for conditional operations like putIfAbsent and replace.

Add cache.operation (string) as an optional attribute for SDKs that use
granular span operations beyond the four base ops.

Fix typo: "sepreated" → "separated" in span description section.

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Mar 18, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Mar 18, 2026 2:34pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Mar 18, 2026 2:34pm

Request Review

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

Labels

sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant