Skip to content
22 changes: 22 additions & 0 deletions .chloggen/profiles-symb-level.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Use this changelog template to create an entry for release notes.
#
# If your change doesn't affect end users you should instead start
# your pull request title with [chore] or use the "Skip Changelog" label.

# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
change_type: enhancement

# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
component: profile

# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
note: add Profile pprof attributes.

# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
# The values here must be integers.
issues: [2522]

# (Optional) One or more lines of additional information to render under the primary note.
# These lines will be padded with 2 spaces and then inserted directly into the document.
# Use pipe (|) for multiline entries.
subtext:
15 changes: 15 additions & 0 deletions docs/registry/attributes/profile.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@

# Profile

- [Profile Frame Attributes](#profile-frame-attributes)
- [Pprof specific attributes for the Profiling signal](#pprof-specific-attributes-for-the-profiling-signal)

## Profile Frame Attributes

Describes the origin of a single frame in a Profile.
Expand All @@ -29,3 +32,15 @@ Describes the origin of a single frame in a Profile.
| `ruby` | [Ruby](https://wikipedia.org/wiki/Ruby_(programming_language)) | ![Development](https://img.shields.io/badge/-development-blue) |
| `rust` | [Rust](https://wikipedia.org/wiki/Rust_(programming_language)) | ![Development](https://img.shields.io/badge/-development-blue) |
| `v8js` | [V8JS](https://wikipedia.org/wiki/V8_(JavaScript_engine)) | ![Development](https://img.shields.io/badge/-development-blue) |

## Pprof specific attributes for the Profiling signal
Comment thread
florianl marked this conversation as resolved.
Outdated

Attributes specific to pprof that help convert from pprof to Profiling signal.
Comment thread
florianl marked this conversation as resolved.
Outdated

| Attribute | Type | Description | Examples | Stability |
|---|---|---|---|---|
| <a id="profile-pprof-location-is-folded" href="#profile-pprof-location-is-folded">`profile.pprof.location.is_folded`</a> | boolean | Provides an indication that multiple symbols map to this location's address, for example due to identical code folding by the linker. In that case the line information represents one of the multiple symbols. This field must be recomputed when the symbolization state of the profile changes. | | ![Development](https://img.shields.io/badge/-development-blue) |
| <a id="profile-pprof-mapping-has-filenames" href="#profile-pprof-mapping-has-filenames">`profile.pprof.mapping.has_filenames`</a> | boolean | Indicates that there are filenames related to this mapping. | | ![Development](https://img.shields.io/badge/-development-blue) |
| <a id="profile-pprof-mapping-has-functions" href="#profile-pprof-mapping-has-functions">`profile.pprof.mapping.has_functions`</a> | boolean | Indicates that there are functions related to this mapping. | | ![Development](https://img.shields.io/badge/-development-blue) |
| <a id="profile-pprof-mapping-has-inline-frames" href="#profile-pprof-mapping-has-inline-frames">`profile.pprof.mapping.has_inline_frames`</a> | boolean | Indicates that there are inline frames related to this mapping. | | ![Development](https://img.shields.io/badge/-development-blue) |
| <a id="profile-pprof-mapping-has-line-numbers" href="#profile-pprof-mapping-has-line-numbers">`profile.pprof.mapping.has_line_numbers`</a> | boolean | Indicates that there are line numbers related to this mapping. | | ![Development](https://img.shields.io/badge/-development-blue) |
16 changes: 16 additions & 0 deletions model/profile/common.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,19 @@ groups:
attributes:
- ref: profile.frame.type
requirement_level: recommended

- id: profile.pprof
type: attribute_group
brief: >
Attributes specific to pprof that help convert from pprof to Profiling signal.
attributes:
- ref: profile.pprof.mapping.has_functions
Comment thread
florianl marked this conversation as resolved.
Outdated
requirement_level: recommended
- ref: profile.pprof.mapping.has_filenames
requirement_level: recommended
- ref: profile.pprof.mapping.has_line_numbers
requirement_level: recommended
- ref: profile.pprof.mapping.has_inline_frames
requirement_level: recommended
- ref: profile.pprof.location.is_folded
requirement_level: recommended
35 changes: 35 additions & 0 deletions model/profile/registry.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -78,3 +78,38 @@ groups:
[Rust](https://wikipedia.org/wiki/Rust_(programming_language))
value: "rust"
stability: development
- id: registry.profile.pprof
type: attribute_group
Comment thread
florianl marked this conversation as resolved.
Outdated
display_name: Pprof specific attributes for the Profiling signal
brief: >
Attributes specific to pprof that help convert from pprof to Profiling signal.
attributes:
- id: profile.pprof.mapping.has_functions
Comment thread
florianl marked this conversation as resolved.
Outdated
brief: >
Indicates that there are functions related to this mapping.
type: boolean
stability: development
- id: profile.pprof.mapping.has_filenames
brief: >
Indicates that there are filenames related to this mapping.
type: boolean
stability: development
- id: profile.pprof.mapping.has_line_numbers
brief: >
Indicates that there are line numbers related to this mapping.
type: boolean
stability: development
- id: profile.pprof.mapping.has_inline_frames
brief: >
Indicates that there are inline frames related to this mapping.
type: boolean
stability: development
- id: profile.pprof.location.is_folded
Comment thread
florianl marked this conversation as resolved.
Outdated
brief: >
Provides an indication that multiple symbols map to this location's
address, for example due to identical code folding by the linker. In
that case the line information represents one of the multiple symbols.
This field must be recomputed when the symbolization state of the
profile changes.
stability: development
type: boolean
Loading