Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Working with databases

Written by
Updated at July 20, 2026
View in Markdown

With auto-instrumentation, spans for database calls are created and attributes are filled automatically. In case of manual instrumentation, follow the convention described below.

Naming convention

The span name has the <db.operation> <db.name>.<db.sql.table> format, e.g., SELECT shop.orders. If any of the components is not available, you can omit it: SELECT shop, SELECT orders. For more information, see the DB span naming specification.

Attributes

Attribute

Description

db.system

DBMS type: mysql, postgresql, redis, mongodb, etc.

db.name

Database name

db.operation

Operation: SELECT, INSERT, UPDATE, DELETE

db.sql.table

Table name

db.statement

Query text

db.user

Database username

db.connection_string

Connection string

server.address

Host name or IP address of the database server

server.port

Database server port

Warning

The db.statement attribute may contain sensitive data. Ensure that queries do not include passwords, tokens, or any personally identifiable information in plaintext.

Example

order-service runs a query to the MySQL database:

Attribute

Value

Name

SELECT shop.orders

Kind

CLIENT

Status

OK

db.system

mysql

db.name

shop

db.operation

SELECT

db.sql.table

orders

db.statement

SELECT * FROM orders WHERE order_id = 'o4711'

db.user

billing_user

db.connection_string

Server=shopdb.example.com;Database=ShopDb;

server.address

shopdb.example.com

server.port

3306
Previous
HTTP communication
Next
RPC calls