Used as a generic attribute representing the action depending on the type of span. For instance, this is the database query operation for DB spans, and the request method for HTTP spans.
{
"key": "sentry.action",
"brief": "Used as a generic attribute representing the action depending on the type of span. For instance, this is the database query operation for DB spans, and the request method for HTTP spans.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "SELECT",
"changelog": [
{
"version": "0.4.0",
"prs": [
212
]
}
]
}
Used as a generic attribute representing the domain depending on the type of span. For instance, this is the collection/table name for database spans, and the server address for HTTP spans.
{
"key": "sentry.domain",
"brief": "Used as a generic attribute representing the domain depending on the type of span. For instance, this is the collection/table name for database spans, and the server address for HTTP spans.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "example.com",
"changelog": [
{
"version": "0.4.0",
"prs": [
212
]
}
]
}
The ID of the project where the trace originated (i.e. the project of the SDK that started the trace). Propagated through the dynamic sampling context and set by Relay during ingestion.
Example12345
Changelog
v0.7.0#358Add sentry.dsc.project_id as an attribute
Raw JSON
{
"key": "sentry.dsc.project_id",
"brief": "The ID of the project where the trace originated (i.e. the project of the SDK that started the trace). Propagated through the dynamic sampling context and set by Relay during ingestion.",
"type": "integer",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "internal",
"example": 12345,
"changelog": [
{
"version": "0.7.0",
"prs": [
358
],
"description": "Add sentry.dsc.project_id as an attribute"
}
]
}
{
"key": "sentry.kind",
"brief": "Used to clarify the relationship between parents and children, or to distinguish between spans, e.g. a `server` and `client` span with the same name.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "server",
"changelog": [
{
"version": "0.3.1",
"prs": [
190
]
}
]
}
Whether the span or event occurred on the main thread. Computed by Relay and should not be set by SDKs.
Exampletrue
Changelog
v0.5.0
Raw JSON
{
"key": "sentry.main_thread",
"brief": "Whether the span or event occurred on the main thread. Computed by Relay and should not be set by SDKs.",
"type": "boolean",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": true,
"changelog": [
{
"version": "0.5.0"
}
]
}
A parameter used in the message template. <key> can either be the number that represent the parameter's position in the template string (sentry.message.parameter.0, sentry.message.parameter.1, etc) or the parameter's name (sentry.message.parameter.item_id, sentry.message.parameter.user_id, etc)
{
"key": "sentry.message.parameter.<key>",
"brief": "A parameter used in the message template. <key> can either be the number that represent the parameter's position in the template string (sentry.message.parameter.0, sentry.message.parameter.1, etc) or the parameter's name (sentry.message.parameter.item_id, sentry.message.parameter.user_id, etc)",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "sentry.message.parameter.0='123'",
"changelog": [
{
"version": "0.1.0",
"prs": [
116
]
}
]
}
Whether the application is using a mobile SDK. Computed by Relay and should not be set by SDKs.
Exampletrue
Changelog
v0.5.0
Raw JSON
{
"key": "sentry.mobile",
"brief": "Whether the application is using a mobile SDK. Computed by Relay and should not be set by SDKs.",
"type": "boolean",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": true,
"changelog": [
{
"version": "0.5.0"
}
]
}
{
"key": "sentry.module.<key>",
"brief": "A module that was loaded in the process. The key is the name of the module.",
"has_dynamic_suffix": true,
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "sentry.module.brianium/paratest='v7.7.0'",
"changelog": [
{
"version": "0.1.0",
"prs": [
103
]
}
]
}
A parameterized route for a function in Next.js that contributes to Server-Side Rendering. Should be present on spans that track such functions when the file location of the function is known.
{
"key": "sentry.nextjs.ssr.function.route",
"brief": "A parameterized route for a function in Next.js that contributes to Server-Side Rendering. Should be present on spans that track such functions when the file location of the function is known.",
"type": "string",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": "/posts/[id]/layout",
"sdks": [
"javascript"
],
"changelog": [
{
"version": "0.1.0",
"prs": [
54,
106
]
}
]
}
{
"key": "sentry.nextjs.ssr.function.type",
"brief": "A descriptor for a for a function in Next.js that contributes to Server-Side Rendering. Should be present on spans that track such functions.",
"type": "string",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": "generateMetadata",
"sdks": [
"javascript"
],
"changelog": [
{
"version": "0.1.0",
"prs": [
54,
106
]
}
]
}
Used as a generic attribute representing the normalized `sentry.description`. This refers to the legacy use case of `sentry.description` where it holds relevant data depending on the type of span (e.g. database query, resource url, http request description, etc).
ExampleSELECT .. FROM sentry_project WHERE (project_id = %s)
{
"key": "sentry.normalized_description",
"brief": "Used as a generic attribute representing the normalized `sentry.description`. This refers to the legacy use case of `sentry.description` where it holds relevant data depending on the type of span (e.g. database query, resource url, http request description, etc).",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": "SELECT .. FROM sentry_project WHERE (project_id = %s)",
"changelog": [
{
"version": "0.4.0",
"prs": [
212
]
}
]
}
string[] PII: False Visibility: Public OTel: False
A list of names identifying enabled integrations. The list shouldhave all enabled integrations, including default integrations. Defaultintegrations are included because different SDK releases may contain differentdefault integrations.
The source of a span, also referred to as transaction source. Known values are: `'custom'`, `'url'`, `'route'`, `'component'`, `'view'`, `'task'`. '`source`' describes a parametrized route, while `'url'` describes the full URL, potentially containing identifiers.
{
"key": "sentry.status_code",
"brief": "The HTTP status code used in Sentry Insights. Typically set by Sentry during ingestion, rather than by clients.",
"type": "integer",
"pii": {
"key": "maybe"
},
"is_in_otel": false,
"visibility": "public",
"example": 200,
"changelog": [
{
"version": "0.4.0",
"prs": [
223,
228
]
}
]
}
A sequencing counter for deterministic ordering of logs or metrics when timestamps share the same integer millisecond. Starts at 0 on SDK initialization, increments by 1 for each captured item, and resets to 0 when the integer millisecond of the current item differs from the previous one.
{
"key": "sentry.timestamp.sequence",
"brief": "A sequencing counter for deterministic ordering of logs or metrics when timestamps share the same integer millisecond. Starts at 0 on SDK initialization, increments by 1 for each captured item, and resets to 0 when the integer millisecond of the current item differs from the previous one.",
"type": "integer",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": 0,
"changelog": [
{
"version": "0.5.0",
"prs": [
262
]
}
]
}
Deprecated Attributes
These attributes are deprecated and should not be used in new code.
See each attribute for migration guidance.
The source of a span, also referred to as transaction source. Known values are: `'custom'`, `'url'`, `'route'`, `'component'`, `'view'`, `'task'`. '`source`' describes a parametrized route, while `'url'` describes the full URL, potentially containing identifiers.
Exampleroute
Use sentry.span.source instead.
This attribute is being deprecated in favor of sentry.span.source
Status: backfill
Changelog
v0.5.0
Raw JSON
{
"key": "sentry.source",
"brief": "The source of a span, also referred to as transaction source. Known values are: `'custom'`, `'url'`, `'route'`, `'component'`, `'view'`, `'task'`. '`source`' describes a parametrized route, while `'url'` describes the full URL, potentially containing identifiers.",
"type": "string",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": "route",
"deprecation": {
"replacement": "sentry.span.source",
"reason": "This attribute is being deprecated in favor of sentry.span.source",
"_status": "backfill"
},
"changelog": [
{
"version": "0.5.0"
}
]
}
{
"key": "sentry.trace.parent_span_id",
"brief": "The span id of the span that was active when the log was collected. This should not be set if there was no active span.",
"type": "string",
"pii": {
"key": "false"
},
"is_in_otel": false,
"visibility": "public",
"example": "b0e6f15b45c36b12",
"deprecation": {
"_status": null
},
"changelog": [
{
"version": "0.5.0",
"prs": [
287
],
"description": "Deprecate `sentry.trace.parent_span_id`"
},
{
"version": "0.1.0",
"prs": [
116
]
}
]
}