Attributes
This page documents all attributes used in traces, spans, and wide logs. Attributes provide structured context for observability data.
Groups
Section titled “Groups”- Common
- Database
- Exception
- Failure
- GraphQL
- Http
- Ingest
- Ldap
- Limiter
- Maintenance
- Memory
- Query
- Rebuild
- Reconciliation
- Rest
- Retry
- Segment
- Segment.Leak
- Warning
Common
Section titled “Common”scribe.entry_type
Section titled “scribe.entry_type”Entry type (e.g., user, group). Corresponds to transcribe configuration entry types.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces, Metrics |
scribe.entry_uuid
Section titled “scribe.entry_uuid”Entry UUID (for entry-level operations and warnings).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.entry_dn
Section titled “scribe.entry_dn”Entry DN for trace debugging (redacted in wide logs if configured).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.entry_uoid
Section titled “scribe.entry_uoid”Entry unique object ID (database row identifier).
| Property | Value |
|---|---|
| Type | long |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.attribute.name
Section titled “scribe.attribute.name”Attribute name (for warnings about specific attributes).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.attribute.value_count
Section titled “scribe.attribute.value_count”Attribute value count (for multi-value warnings).
| Property | Value |
|---|---|
| Type | long |
| Appears in | Wide logs, Traces |
scribe.change_type
Section titled “scribe.change_type”Change type for ingest operations.
| Property | Value |
|---|---|
| Type | string |
| Values | add, modify, delete, move |
| Appears in | Wide logs, Traces, Metrics |
scribe.checkpoint.timestamp
Section titled “scribe.checkpoint.timestamp”Checkpoint timestamp (ISO-8601 format).
| Property | Value |
|---|---|
| Type | string |
scribe.search.kind
Section titled “scribe.search.kind”Search kind for LDAP operations.
| Property | Value |
|---|---|
| Type | string |
| Values | simple, paged, vlv |
| Appears in | Wide logs, Traces |
scribe.ldap.message_id
Section titled “scribe.ldap.message_id”LDAP message ID.
| Property | Value |
|---|---|
| Type | long |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.operation
Section titled “scribe.operation”Operation name combining channel and operation type. Format: CHANNEL.OP (e.g., LDAP.Search, REST.Modify, Transcription.WorkItem).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.result
Section titled “scribe.result”Operation result classification. Value is “ok” for success, or the failure kind for errors.
| Property | Value |
|---|---|
| Type | string |
| Values | ok, cancelled, invalid_argument, out_of_range, failed_precondition, unauthenticated, permission_denied, not_found, already_exists, conflict, resource_exhausted, deadline_exceeded, unavailable, unimplemented, internal, data_loss, unknown |
| Appears in | Wide logs, Traces, Metrics |
scribe.channel
Section titled “scribe.channel”Protocol channel that received the request.
| Property | Value |
|---|---|
| Type | string |
| Values | ldap, rest, graphql, grpc, monitoring |
| Appears in | Wide logs, Traces, Metrics |
scribe.socket
Section titled “scribe.socket”Named socket for the connection. Usually “@default” unless multiple sockets are configured.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces, Metrics |
Database
Section titled “Database”db.pool.name
Section titled “db.pool.name”Database connection pool name.
| Property | Value |
|---|---|
| Type | string |
db.pool.size
Section titled “db.pool.size”Database connection pool size.
| Property | Value |
|---|---|
| Type | long |
db.url
Section titled “db.url”Database connection URL.
| Property | Value |
|---|---|
| Type | string |
db.user
Section titled “db.user”Database user.
| Property | Value |
|---|---|
| Type | string |
db.ssl
Section titled “db.ssl”Database SSL mode (e.g., “require”, “disabled”).
| Property | Value |
|---|---|
| Type | string |
db.system
Section titled “db.system”Database system (e.g., postgresql).
| Property | Value |
|---|---|
| Type | string |
db.name
Section titled “db.name”Database name.
| Property | Value |
|---|---|
| Type | string |
db.statement.hash
Section titled “db.statement.hash”Hash of the SQL statement.
| Property | Value |
|---|---|
| Type | string |
db.duration.seconds
Section titled “db.duration.seconds”Query duration in seconds.
| Property | Value |
|---|---|
| Type | double |
db.row_count
Section titled “db.row_count”Number of rows returned or affected.
| Property | Value |
|---|---|
| Type | long |
db.error_code
Section titled “db.error_code”Database error code (when applicable).
| Property | Value |
|---|---|
| Type | string |
db.attempt
Section titled “db.attempt”Retry attempt number.
| Property | Value |
|---|---|
| Type | long |
db.operation
Section titled “db.operation”Operation name for retry context.
| Property | Value |
|---|---|
| Type | string |
Exception
Section titled “Exception”exception.type
Section titled “exception.type”Exception type (class name).
| Property | Value |
|---|---|
| Type | string |
exception.message
Section titled “exception.message”Exception message.
| Property | Value |
|---|---|
| Type | string |
exception.stacktrace
Section titled “exception.stacktrace”Exception stacktrace.
| Property | Value |
|---|---|
| Type | string |
Failure
Section titled “Failure”failure.code
Section titled “failure.code”Failure error code identifier.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.kind
Section titled “failure.kind”Failure kind classification (gRPC-aligned).
| Property | Value |
|---|---|
| Type | string |
| Values | cancelled, invalid_argument, out_of_range, failed_precondition, unauthenticated, permission_denied, not_found, already_exists, conflict, resource_exhausted, deadline_exceeded, unavailable, unimplemented, internal, data_loss, unknown |
| Appears in | Wide logs, Traces, Metrics |
failure.id
Section titled “failure.id”Failure unique ID (UUID).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.correlation
Section titled “failure.correlation”Failure correlation ID (if provided by client).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.trace_id
Section titled “failure.trace_id”Trace ID where the failure was created (32 hex chars).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.span_id
Section titled “failure.span_id”Span ID where the failure was created (16 hex chars).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.safe_message
Section titled “failure.safe_message”Client-safe error message.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
failure.details
Section titled “failure.details”Structured JSON details for diagnostic purposes.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs |
GraphQL
Section titled “GraphQL”graphql.operation.name
Section titled “graphql.operation.name”GraphQL operation name (from the query document). Example: For query GetUser { user(id: "123") { name } }, this would be “GetUser”.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
graphql.operation.type
Section titled “graphql.operation.type”GraphQL operation type.
| Property | Value |
|---|---|
| Type | string |
| Values | query, mutation, subscription |
| Appears in | Wide logs, Traces, Metrics |
graphql.error.count
Section titled “graphql.error.count”Number of GraphQL errors in the response.
| Property | Value |
|---|---|
| Type | long |
| Appears in | Wide logs, Traces |
graphql.has_errors
Section titled “graphql.has_errors”Whether the GraphQL response contains errors.
| Property | Value |
|---|---|
| Type | boolean |
| Appears in | Wide logs, Traces |
graphql.field.name
Section titled “graphql.field.name”GraphQL field name being resolved.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
graphql.field.type
Section titled “graphql.field.type”GraphQL parent type name for field resolution.
| Property | Value |
|---|---|
| Type | string |
| Values | Query, Mutation, Subscription, or object type names |
| Appears in | Wide logs, Traces |
graphql.apq.used
Section titled “graphql.apq.used”Whether this request used APQ (Automatic Persisted Queries). True when the request included a persisted query hash (with or without the query body).
| Property | Value |
|---|---|
| Type | boolean |
| Appears in | Wide logs, Traces |
graphql.apq.cache_result
Section titled “graphql.apq.cache_result”APQ cache result.
| Property | Value |
|---|---|
| Type | string |
| Values | hit, miss, registered |
| Appears in | Wide logs, Traces |
Some attributes in this section are OTel semantic conventions. See the linked documentation for standard definitions.
http.request.method
Section titled “http.request.method”Standard OTel attribute. See OTel Semantic Conventions.
HTTP request method (GET, POST, etc.). OTel: http.request.method
| Property | Value |
|---|---|
| Type | string |
http.route
Section titled “http.route”Standard OTel attribute. See OTel Semantic Conventions.
HTTP route pattern. OTel: http.route
| Property | Value |
|---|---|
| Type | string |
http.response.status_code
Section titled “http.response.status_code”Standard OTel attribute. See OTel Semantic Conventions.
HTTP response status code. OTel: http.response.status_code
| Property | Value |
|---|---|
| Type | long |
http.request.body.size
Section titled “http.request.body.size”HTTP request body size. OTel: http.request.body.size (experimental)
| Property | Value |
|---|---|
| Type | long |
http.response.body.size
Section titled “http.response.body.size”HTTP response body size. OTel: http.response.body.size (experimental)
| Property | Value |
|---|---|
| Type | long |
url.path
Section titled “url.path”Standard OTel attribute. See OTel Semantic Conventions.
URL path. OTel: url.path
| Property | Value |
|---|---|
| Type | string |
url.scheme
Section titled “url.scheme”Standard OTel attribute. See OTel Semantic Conventions.
URL scheme (http/https). OTel: url.scheme
| Property | Value |
|---|---|
| Type | string |
client.address
Section titled “client.address”Standard OTel attribute. See OTel Semantic Conventions.
Client IP address. OTel: client.address
| Property | Value |
|---|---|
| Type | string |
client.port
Section titled “client.port”Standard OTel attribute. See OTel Semantic Conventions.
Client port. OTel: client.port
| Property | Value |
|---|---|
| Type | long |
user_agent.original
Section titled “user_agent.original”Standard OTel attribute. See OTel Semantic Conventions.
User-Agent. OTel: user_agent.original (NOT http.request.header.user-agent)
| Property | Value |
|---|---|
| Type | string |
scribe.http.request_id
Section titled “scribe.http.request_id”Request ID header value.
| Property | Value |
|---|---|
| Type | string |
scribe.http.correlation_id
Section titled “scribe.http.correlation_id”Correlation ID header value.
| Property | Value |
|---|---|
| Type | string |
server.address
Section titled “server.address”Standard OTel attribute. See OTel Semantic Conventions.
Server address (host). OTel: server.address
| Property | Value |
|---|---|
| Type | string |
server.port
Section titled “server.port”Standard OTel attribute. See OTel Semantic Conventions.
Server port. OTel: server.port
| Property | Value |
|---|---|
| Type | long |
Ingest
Section titled “Ingest”scribe.ingest.task.sequence
Section titled “scribe.ingest.task.sequence”Task sequence number.
| Property | Value |
|---|---|
| Type | long |
scribe.ingest.task.uuid
Section titled “scribe.ingest.task.uuid”Task UUID.
| Property | Value |
|---|---|
| Type | string |
scribe.ingest.max_active_tasks
Section titled “scribe.ingest.max_active_tasks”Maximum active tasks threshold for waitFor operations.
| Property | Value |
|---|---|
| Type | long |
scribe.ingest.wait.timeout.seconds
Section titled “scribe.ingest.wait.timeout.seconds”Timeout for waitFor operations in seconds.
| Property | Value |
|---|---|
| Type | double |
scribe.ingest.wait.kind
Section titled “scribe.ingest.wait.kind”Wait kind for ingest throttling.
| Property | Value |
|---|---|
| Type | string |
| Values | timed, untimed |
| Appears in | Wide logs, Traces |
scribe.ingest.queue.wait.seconds
Section titled “scribe.ingest.queue.wait.seconds”Time spent waiting in ingest queue (seconds).
| Property | Value |
|---|---|
| Type | double |
scribe.ingest.events.add
Section titled “scribe.ingest.events.add”Number of add events written.
| Property | Value |
|---|---|
| Type | long |
scribe.ingest.events.delete
Section titled “scribe.ingest.events.delete”Number of delete events written.
| Property | Value |
|---|---|
| Type | long |
scribe.ingest.events.move
Section titled “scribe.ingest.events.move”Number of move events written.
| Property | Value |
|---|---|
| Type | long |
scribe.ingest.events.modify
Section titled “scribe.ingest.events.modify”Number of modify operations written.
| Property | Value |
|---|---|
| Type | long |
ldap.address
Section titled “ldap.address”LDAP server address.
| Property | Value |
|---|---|
| Type | string |
ldap.port
Section titled “ldap.port”LDAP server port.
| Property | Value |
|---|---|
| Type | long |
ldap.active_connections
Section titled “ldap.active_connections”Number of active LDAP connections.
| Property | Value |
|---|---|
| Type | long |
ldap.disconnect_type
Section titled “ldap.disconnect_type”Disconnect type (e.g., UNBIND, IO_ERROR).
| Property | Value |
|---|---|
| Type | string |
ldap.disconnect_message
Section titled “ldap.disconnect_message”Disconnect message.
| Property | Value |
|---|---|
| Type | string |
Limiter
Section titled “Limiter”scribe.limiter.wait.seconds
Section titled “scribe.limiter.wait.seconds”Time spent waiting for permits (seconds).
| Property | Value |
|---|---|
| Type | double |
scribe.limiter.permits
Section titled “scribe.limiter.permits”Number of permits acquired.
| Property | Value |
|---|---|
| Type | long |
Maintenance
Section titled “Maintenance”maintenance.run_kind
Section titled “maintenance.run_kind”Run kind indicating how the maintenance task was triggered.
| Property | Value |
|---|---|
| Type | string |
| Values | CRON_WINDOW, HARD_INTERVAL, SOFT_INTERVAL, MANUAL |
| Appears in | Wide logs, Traces |
Memory
Section titled “Memory”memory.used.percent
Section titled “memory.used.percent”Current memory usage percentage.
| Property | Value |
|---|---|
| Type | double |
memory.threshold.high
Section titled “memory.threshold.high”High memory threshold percentage.
| Property | Value |
|---|---|
| Type | double |
memory.threshold.recovery
Section titled “memory.threshold.recovery”Recovery memory threshold percentage.
| Property | Value |
|---|---|
| Type | double |
memory.throttle.cycles
Section titled “memory.throttle.cycles”Number of throttle cycles.
| Property | Value |
|---|---|
| Type | long |
memory.sleep.cycles
Section titled “memory.sleep.cycles”Number of sleep cycles during throttling.
| Property | Value |
|---|---|
| Type | long |
scribe.query.signature
Section titled “scribe.query.signature”Query signature (normalized query fingerprint). Useful for grouping similar queries in dashboards.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.query.scope
Section titled “scribe.query.scope”Query scope (base DN scope).
| Property | Value |
|---|---|
| Type | string |
| Values | base, one, sub, subordinates |
| Appears in | Wide logs, Traces |
scribe.query.types
Section titled “scribe.query.types”Requested object types.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.query.where
Section titled “scribe.query.where”Where clause summary.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.query.sort
Section titled “scribe.query.sort”Sort specification.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.query.seek
Section titled “scribe.query.seek”Seek direction.
| Property | Value |
|---|---|
| Type | string |
| Values | forward, backward |
| Appears in | Wide logs, Traces |
scribe.query.cursor
Section titled “scribe.query.cursor”Cursor value for pagination.
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
scribe.query.limited
Section titled “scribe.query.limited”Whether query result was limited.
| Property | Value |
|---|---|
| Type | boolean |
| Appears in | Wide logs, Traces |
scribe.query.count_mode
Section titled “scribe.query.count_mode”Count mode for the query.
| Property | Value |
|---|---|
| Type | string |
| Values | none, exact, estimated |
| Appears in | Wide logs, Traces |
scribe.query.navigation_mode
Section titled “scribe.query.navigation_mode”Navigation mode for the query.
| Property | Value |
|---|---|
| Type | string |
| Values | offset, cursor |
| Appears in | Wide logs, Traces |
Rebuild
Section titled “Rebuild”scribe.rebuild.events_processed
Section titled “scribe.rebuild.events_processed”Number of events processed during rebuild.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.entries_count
Section titled “scribe.rebuild.entries_count”Number of entries after rebuild.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.entries_data_count
Section titled “scribe.rebuild.entries_data_count”Number of entry data rows after rebuild.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.attr_set_value
Section titled “scribe.rebuild.attr_set_value”Number of attribute set value operations.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.attr_add_value
Section titled “scribe.rebuild.attr_add_value”Number of attribute add value operations.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.attr_delete_value
Section titled “scribe.rebuild.attr_delete_value”Number of attribute delete value operations.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.attr_delete
Section titled “scribe.rebuild.attr_delete”Number of attribute delete operations.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.event_add
Section titled “scribe.rebuild.event_add”Number of add events.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.event_modify
Section titled “scribe.rebuild.event_modify”Number of modify events.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.event_delete
Section titled “scribe.rebuild.event_delete”Number of delete events.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.event_move
Section titled “scribe.rebuild.event_move”Number of move events.
| Property | Value |
|---|---|
| Type | long |
scribe.rebuild.duration_rebuilding
Section titled “scribe.rebuild.duration_rebuilding”Duration of rebuild phase.
| Property | Value |
|---|---|
| Type | string |
scribe.rebuild.duration_transferring
Section titled “scribe.rebuild.duration_transferring”Duration of transfer phase.
| Property | Value |
|---|---|
| Type | string |
scribe.rebuild.total_duration
Section titled “scribe.rebuild.total_duration”Total duration.
| Property | Value |
|---|---|
| Type | string |
Reconciliation
Section titled “Reconciliation”scribe.reconciliation.reconciled_entries
Section titled “scribe.reconciliation.reconciled_entries”Total entries considered during reconciliation.
| Property | Value |
|---|---|
| Type | long |
scribe.reconciliation.verified_entries
Section titled “scribe.reconciliation.verified_entries”Entries verified to exist in LDAP.
| Property | Value |
|---|---|
| Type | long |
scribe.reconciliation.deleted_entries
Section titled “scribe.reconciliation.deleted_entries”Entries deleted (synthetic deletes emitted).
| Property | Value |
|---|---|
| Type | long |
scribe.reconciliation.batch_size
Section titled “scribe.reconciliation.batch_size”Batch size for LDAP search operations.
| Property | Value |
|---|---|
| Type | long |
rest.response_shape
Section titled “rest.response_shape”Response shape for REST queries.
| Property | Value |
|---|---|
| Type | string |
| Values | nodes, edges, count |
| Appears in | Wide logs, Traces |
rest.lookup_by
Section titled “rest.lookup_by”Lookup key type for direct entry access.
| Property | Value |
|---|---|
| Type | string |
| Values | uuid, uoid, dn |
| Appears in | Wide logs, Traces |
rest.error_type
Section titled “rest.error_type”Exception type received by error handler (diagnostic).
| Property | Value |
|---|---|
| Type | string |
| Cardinality | High |
| Appears in | Wide logs, Traces |
rest.error_status
Section titled “rest.error_status”HTTP status code mapped from exception (diagnostic).
| Property | Value |
|---|---|
| Type | long |
| Appears in | Wide logs, Traces |
retry.attempts
Section titled “retry.attempts”Number of retry attempts made.
| Property | Value |
|---|---|
| Type | long |
retry.max_duration_seconds
Section titled “retry.max_duration_seconds”Maximum duration allowed for retries in seconds.
| Property | Value |
|---|---|
| Type | long |
Segment
Section titled “Segment”offset.seconds
Section titled “offset.seconds”Offset from operation start in seconds. Presence of this attribute distinguishes segment events from regular events.
| Property | Value |
|---|---|
| Type | double |
duration.seconds
Section titled “duration.seconds”Segment duration in seconds.
| Property | Value |
|---|---|
| Type | double |
Segment.Leak
Section titled “Segment.Leak”leak.name
Section titled “leak.name”The name of the leaked segment.
| Property | Value |
|---|---|
| Type | string |
leak.duration.seconds
Section titled “leak.duration.seconds”How long the segment has been open (seconds).
| Property | Value |
|---|---|
| Type | double |
leak.threshold.seconds
Section titled “leak.threshold.seconds”The configured leak threshold (seconds).
| Property | Value |
|---|---|
| Type | double |
leak.best_frame
Section titled “leak.best_frame”The best-frame string for quick identification of the creation site.
| Property | Value |
|---|---|
| Type | string |
leak.stacktrace
Section titled “leak.stacktrace”The capped creation stack trace.
| Property | Value |
|---|---|
| Type | string |
Warning
Section titled “Warning”warning.code
Section titled “warning.code”Warning code (e.g., “unsupported_base_dn”).
| Property | Value |
|---|---|
| Type | string |
warning.message
Section titled “warning.message”Human-readable message.
| Property | Value |
|---|---|
| Type | string |
warning.details
Section titled “warning.details”Structured JSON details.
| Property | Value |
|---|---|
| Type | string |