Skip to content

docs(cache): Define cache.ttl for fractional and per-read TTLs - #726

Merged
s1gr1d merged 2 commits into
mainfrom
sig/improve-ttl-2
Oct 20, 2026
Merged

s1gr1d merged 2 commits into
mainfrom
sig/improve-ttl-2

Conversation

@s1gr1d

@s1gr1d s1gr1d commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

Description

Follow-up for #725

  • Round fractions up. cache.ttl is an integer. If an SDK cuts a 0.3s TTL down to 0, the value means "expires immediately", which would be wrong.
  • Omit cache.ttl when each read restarts the TTL. cache.ttl counts from the write. A TTL that restarts on each read (Caffeine expireAfterAccess, .NET SlidingExpiration) counts from the last read, so the UI would show the wrong expiry time.

Reference (Sentry Frontend): getsentry/sentry#127972

PR Checklist

  • I have run yarn test and verified that the tests pass.
  • I have run yarn generate to generate and format code and docs.

If an attribute was added:

  • The attribute is in a namespace (e.g. nextjs.function_id, not function_id)
  • I have used the correct value for apply_scrubbing (i.e. manual or auto. Use never only for values that should never be scrubbed such as IDs)

If an attribute was deprecated:

@vercel

vercel Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
sentry-conventions Ready Ready Preview Oct 20, 2026 12:48pm UTC

Request Review

@s1gr1d
s1gr1d requested review from a team and giortzisg as code owners October 19, 2026 09:25
@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

Attributes

  • Add message_origin as a sentry.link.type value by JPeer264 in #724
  • Add aws.lambda.resource_mapping.id attribute by pabloDeputter in #710
  • Add object to the sentry.category values by pabloDeputter in #721
  • Add http.request.duration by loewenheim in #697

Names

  • Add span name rules for rpc spans by pabloDeputter in #714
  • Add queue.publish/create/receive/process/settle to messaging span names by pabloDeputter in #705

Other

  • (descriptions) AWS Lambda function descriptions by pabloDeputter in #720
  • (gen_ai) Add tool call result size attribute by obostjancic in #679
  • (ops) Add object.copy op by pabloDeputter in #706
  • Add view.render op by alexander-alderman-webb in #699

Bug Fixes 🐛

  • (attributes) Apply consistent scrubbing across deprecations by mjq in #692

Documentation 📚

  • (cache) Define cache.ttl for fractional and per-read TTLs by s1gr1d in #726
  • Clarify cache.ttl for 0, no expiry, and reads by s1gr1d in #725

Internal Changes 🔧

  • (attributes) Scrub S3 object keys by default by pabloDeputter in #713
  • (repo) Update CODEOWNERS to include @giortzisg by Lms24 in #708
  • Deprecate gen_ai.responses in favor of gen_ai.chat by alexander-alderman-webb in #703
  • Add deprecated messaging ops set by the Python SDK by alexander-alderman-webb in #693
  • Add view.response.render op, deprecated in favor of view.render by alexander-alderman-webb in #700
  • Add event.django op, deprecated in favor of function by alexander-alderman-webb in #698

🤖 This preview updates automatically when you update the PR.

@s1gr1d
s1gr1d enabled auto-merge (squash) October 20, 2026 12:48
@s1gr1d
s1gr1d merged commit c6300dc into main Oct 20, 2026
17 checks passed
@s1gr1d
s1gr1d deleted the sig/improve-ttl-2 branch October 20, 2026 12:50

This branch was successfully deployed

1 active deployment
Preview — 93e0443e Deployed Oct 20, 2026 by vercel[bot]
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