The name of a collection (table, container) within the database.
Exampleusers
Raw JSON
{
"key": "db.collection.name",
"brief": "The name of a collection (table, container) within the database.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "users"
}
A query parameter used in db.query.text, with <key> being the parameter name, and the attribute value being a string representation of the parameter value.
Exampledb.query.parameter.foo='123'
Dynamic SuffixYes - the key contains dynamic parts
Raw JSON
{
"key": "db.query.parameter.<key>",
"brief": "A query parameter used in db.query.text, with <key> being the parameter name, and the attribute value being a string representation of the parameter value.",
"has_dynamic_suffix": true,
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "db.query.parameter.foo='123'"
}
A shortened representation of operation(s) in the full query. This attribute must be low-cardinality and should only contain the operation table names.
ExampleSELECT users;
Raw JSON
{
"key": "db.query.summary",
"brief": "A shortened representation of operation(s) in the full query. This attribute must be low-cardinality and should only contain the operation table names.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "SELECT users;"
}
The database parameterized query being executed. Any parameter values (filters, insertion values, etc) should be replaced with parameter placeholders. If applicable, use `db.query.parameter.<key>` to add the parameter value.
ExampleSELECT * FROM users WHERE id = $1
Aliasesdb.statement
Raw JSON
{
"key": "db.query.text",
"brief": "The database parameterized query being executed. Any parameter values (filters, insertion values, etc) should be replaced with parameter placeholders. If applicable, use `db.query.parameter.<key>` to add the parameter value.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "SELECT * FROM users WHERE id = $1",
"alias": [
"db.statement"
]
}
An identifier for the database management system (DBMS) product being used. See [OpenTelemetry docs](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/database-spans.md#notes-and-well-known-identifiers-for-dbsystem) for a list of well-known identifiers.
Examplepostgresql
Aliasesdb.system
Raw JSON
{
"key": "db.system.name",
"brief": "An identifier for the database management system (DBMS) product being used. See [OpenTelemetry docs](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/database-spans.md#notes-and-well-known-identifiers-for-dbsystem) for a list of well-known identifiers.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "postgresql",
"alias": [
"db.system"
]
}
An identifier for the database management system (DBMS) product being used. See [OpenTelemetry docs](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/database-spans.md#notes-and-well-known-identifiers-for-dbsystem) for a list of well-known identifiers.
Examplepostgresql
Aliasesdb.system.name
Use db.system.name instead.
Status: backfill
Raw JSON
{
"key": "db.system",
"brief": "An identifier for the database management system (DBMS) product being used. See [OpenTelemetry docs](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/database-spans.md#notes-and-well-known-identifiers-for-dbsystem) for a list of well-known identifiers.",
"type": "string",
"pii": {
"key": "maybe"
},
"is_in_otel": true,
"example": "postgresql",
"deprecation": {
"replacement": "db.system.name",
"_status": "backfill"
},
"alias": [
"db.system.name"
]
}