feat(attributes): Add Android Runtime (ART) GC and memory attributes by markushi · Pull Request #382 · getsentry/sentry-conventions

markushi · 2026-05-15T06:32:37Z

Summary

Adds Android Runtime (ART) garbage collection and memory attributes for tracking GC activity and memory usage on Android. Similar to the existing jvm and dotnet top-level event context attributes.

GC attributes (`art.gc.*`)

art.gc.blocking_count / art.gc.blocking_time — blocking (stop-the-world) GC
art.gc.total_count / art.gc.total_time — all GC activity
art.gc.waiting_time — time threads spent waiting for GC
art.gc.pre_oome_count — last-resort GCs before OutOfMemoryError

Memory attributes (`art.memory.*`)

art.memory.free — free memory available to the process
art.memory.free_until_gc — free memory before GC would trigger
art.memory.free_until_oome — free memory before OOM
art.memory.total / art.memory.max — allocated and max memory

github-actions · 2026-05-15T06:32:52Z

Semver Impact of This PR

🟡 Minor (new features)

📋 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 Android Runtime (ART) GC and memory attributes by markushi in #382

Add db.stored_procedure.name and ensure span name attribute consistency by Lms24 in #398
Add Cloudflare SDK attributes by JPeer264 in #392

Other

Add missing GCP and FaaS attributes by ericapisani in #403

Bug Fixes 🐛

(cloudfare) Add missing visibility attributes by markushi in #408

_{🤖 This preview updates automatically when you update the PR.}

buenaflor

I wonder if we should further split it into sub namespaces e.g

art.gc_blocking.count vs art.gc.blocking.count

markushi · 2026-05-15T14:16:44Z

I wonder if we should further split it into sub namespaces e.g

art.gc_blocking.count vs art.gc.blocking.count

I've split them into art.gc and art.memory

Add top-level runtime.* attributes mapping to the Sentry runtime context: runtime.name, runtime.version, runtime.build, and runtime.raw_description. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add 11 new attributes under the `art` namespace for Android Runtime garbage collection stats and memory info, parsed from ANR thread dumps. GC attributes: gc_total_count, gc_total_time, gc_blocking_count, gc_blocking_time, gc_pre_oome_count, gc_waiting_time Memory attributes: free_memory, free_memory_until_gc, free_memory_until_oome, total_memory, max_memory Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Rename ART attribute keys to use dot-separated sub-namespaces, consistent with existing patterns like jvm.gc.*, jvm.memory.*, and browser.web_vital.*. GC attributes move under art.gc.* and memory attributes under art.memory.*, with a max nesting depth of 2 dots. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…espace Rename art.* attributes to runtime.art.* to nest them under the runtime context namespace. This aligns with the runtime context attribute structure. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

markushi · 2026-05-15T14:54:08Z

Moving back to draft for now, as we need to sort out the "runtime" vs. "process.runtime" discussion first.

buenaflor · 2026-05-15T15:00:03Z

From what I can tell otel also prefers setting runtime specifics into its own namespace e.g

dotnet.gc.heap.total_allocated, jvm.gc.duration (and we also follow this with jvm)

It looks like art.gc.xyz fits as well

buenaflor · 2026-05-15T16:42:48Z

what do you think of this, I had 🤖 run through the GC and Memory attributes of OTEL runtime conventions to check how we can align with naming:

Key	Description	OTel alignment
`art.memory.free`	Free heap memory available to the process	ART-specific; V8 has `available_size`
`art.memory.free_until_gc`	Free memory before next GC triggers	ART-specific; Go has `go.memory.gc.goal` (target, not headroom)
`art.memory.free_until_oome`	Free memory before OutOfMemoryError	ART-specific
`art.memory.committed`	Heap currently allocated to the process	Matches `jvm.memory.committed`, .NET `committed_size`
`art.memory.limit`	Maximum heap size the process can grow to	Matches `jvm.memory.limit`, `go.memory.limit`
`art.gc.collections`	Total GC collections since process start	Matches `dotnet.gc.collections`, `go.memory.gc.cycles`
`art.gc.duration`	Cumulative GC time since process start	Matches `jvm.gc.duration`, `v8js.gc.duration` (leaf name)
`art.gc.blocking_collections`	Stop-the-world GC collections since process start	ART-specific; JVM uses `jvm.gc.action` attribute instead
`art.gc.blocking_duration`	Cumulative stop-the-world GC time since process start	ART-specific; closest to `go.memory.gc.pause.duration`
`art.gc.pre_oome_collections`	Last-resort GC attempts to prevent OOM	ART-specific
`art.gc.wait_duration`	Cumulative thread wait time due to GC	ART-specific

…time namespace" This reverts commit 4ee2e0c.

Use dotted attribute names (e.g. gc.total_count, memory.free) to match the sentry-conventions schema from getsentry/sentry-conventions#382. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add ART GC and memory attributes under the `art` namespace with dotted sub-namespaces (`art.gc.*`, `art.memory.*`). Remove incorrectly added top-level `runtime` context attributes. Add required `visibility: public` field to all ART attributes. Regenerate code. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

markushi · 2026-05-26T10:13:32Z

I decided to move these new attributes into a top-level art namespace, similar to existing platform specific attributes (go.*, jvm.*, dotnet.*). It's worth pointing out that these attributes will be used within the event.contexts protocol (as opposed to the span.data bag)

romtsn · 2026-05-27T12:14:38Z

+    isInOtel: false,
+    visibility: 'public',
+    example: 1,
+    sdks: ['sentry.java.android'],


do we need to mention hybrid SDKs for all these, too?

Ideally, this include a list of SDKs that set this attribute. Though I can see this become outdated super quickly, so honestly, no strong opinion.

Lms24 · 2026-05-28T13:30:25Z

+    isInOtel: false,
+    visibility: 'public',
+    example: 1,
+    sdks: ['sentry.java.android'],


Ideally, this include a list of SDKs that set this attribute. Though I can see this become outdated super quickly, so honestly, no strong opinion.

Lms24 · 2026-05-28T13:32:21Z

It's worth pointing out that these attributes will be used within the event.contexts protocol (as opposed to the span.data bag)

... which means we don't interpret them as attributes in the product (as in, not filter/searchable in Explure UIs for example). I think this is fine if our plan here is to be forward-thinking and eventually set them as attributes once the Android SDK starts sending streamed spans (?).

buenaflor · 2026-05-28T13:33:56Z

if our plan here is to be forward-thinking and eventually set them as attributes

yes, that's the general idea

markushi marked this pull request as ready for review May 15, 2026 07:39

markushi requested review from a team, Lms24, cleptric, mjq and nsdeschenes as code owners May 15, 2026 07:39

markushi requested a review from a team May 15, 2026 07:55

buenaflor reviewed May 15, 2026

View reviewed changes

markushi mentioned this pull request May 15, 2026

feat(android): Parse memory and GC info from ANR thread dumps getsentry/sentry-java#5428

Merged

8 tasks

markushi and others added 4 commits May 15, 2026 16:36

feat(attributes): Add runtime context attributes

2104779

Add top-level runtime.* attributes mapping to the Sentry runtime context: runtime.name, runtime.version, runtime.build, and runtime.raw_description. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

markushi force-pushed the feat/art-gc-attributes branch from 6265928 to 4ee2e0c Compare May 15, 2026 14:40

markushi changed the title ~~feat(attributes): Add Android Runtime (ART) GC and memory attributes~~ feat(attributes): Add Android Runtime (ART) GC and memory attributes under runtime namespace May 15, 2026

markushi marked this pull request as draft May 15, 2026 14:52

Revert "feat(attributes): Move ART GC and memory attributes under run…

456907a

…time namespace" This reverts commit 4ee2e0c.

markushi changed the title ~~feat(attributes): Add Android Runtime (ART) GC and memory attributes under runtime namespace~~ feat(attributes): Add Android Runtime (ART) GC and memory attributes May 26, 2026

markushi marked this pull request as ready for review May 26, 2026 10:11

markushi requested a review from buenaflor May 26, 2026 10:13

buenaflor approved these changes May 26, 2026

View reviewed changes

Merge branch 'main' into feat/art-gc-attributes

cb496fc

romtsn reviewed May 27, 2026

View reviewed changes

romtsn approved these changes May 27, 2026

View reviewed changes

Lms24 approved these changes May 28, 2026

View reviewed changes

markushi added 2 commits May 29, 2026 21:33

Merge branch 'main' into feat/art-gc-attributes

9f70415

Merge branch 'main' into feat/art-gc-attributes

e83c095

markushi merged commit 94ebcf3 into main Jun 1, 2026
15 checks passed

markushi deleted the feat/art-gc-attributes branch June 1, 2026 14:27

sentry-release-bot Bot mentioned this pull request Jun 10, 2026

publish: getsentry/sentry-conventions@0.11.0 getsentry/publish#8513

Closed

4 tasks

Uh oh!

Conversation

markushi commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

GC attributes (art.gc.*)

Memory attributes (art.memory.*)

Uh oh!

github-actions Bot commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

New Features ✨

Attributes

Other

Bug Fixes 🐛

Uh oh!

buenaflor left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

markushi commented May 15, 2026

Uh oh!

markushi commented May 15, 2026

Uh oh!

buenaflor commented May 15, 2026

Uh oh!

buenaflor commented May 15, 2026

Uh oh!

markushi commented May 26, 2026

Uh oh!

romtsn May 27, 2026

Choose a reason for hiding this comment

Uh oh!

Lms24 May 28, 2026

Choose a reason for hiding this comment

Uh oh!

Lms24 May 28, 2026

Choose a reason for hiding this comment

Uh oh!

Lms24 commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

buenaflor commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

markushi commented May 15, 2026 •

edited

Loading

GC attributes (`art.gc.*`)

Memory attributes (`art.memory.*`)

github-actions Bot commented May 15, 2026 •

edited

Loading

buenaflor left a comment •

edited

Loading

Lms24 commented May 28, 2026 •

edited

Loading

buenaflor commented May 28, 2026 •

edited

Loading