Class SemanticAttributes
- java.lang.Object
-
- io.opentelemetry.semconv.trace.attributes.SemanticAttributes
-
public final class SemanticAttributes extends Object
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classSemanticAttributes.DbCassandraConsistencyLevelValuesstatic classSemanticAttributes.DbSystemValuesstatic classSemanticAttributes.FaasDocumentOperationValuesstatic classSemanticAttributes.FaasInvokedProviderValuesstatic classSemanticAttributes.FaasTriggerValuesstatic classSemanticAttributes.HttpFlavorValuesstatic classSemanticAttributes.MessagingDestinationKindValuesstatic classSemanticAttributes.MessagingOperationValuesstatic classSemanticAttributes.NetTransportValuesstatic classSemanticAttributes.RpcGrpcStatusCodeValues
-
Field Summary
Fields Modifier and Type Field Description static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_ATTRIBUTE_DEFINITIONSThe JSON-serialized value of each item in theAttributeDefinitionsrequest field.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_ATTRIBUTES_TO_GETThe value of theAttributesToGetrequest parameter.static io.opentelemetry.api.common.AttributeKey<Boolean>AWS_DYNAMODB_CONSISTENT_READThe value of theConsistentReadrequest parameter.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_CONSUMED_CAPACITYThe JSON-serialized value of each item in theConsumedCapacityresponse field.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_COUNTThe value of theCountresponse parameter.static io.opentelemetry.api.common.AttributeKey<String>AWS_DYNAMODB_EXCLUSIVE_START_TABLEThe value of theExclusiveStartTableNamerequest parameter.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_GLOBAL_SECONDARY_INDEX_UPDATESThe JSON-serialized value of each item in the theGlobalSecondaryIndexUpdatesrequest field.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_GLOBAL_SECONDARY_INDEXESThe JSON-serialized value of each item of theGlobalSecondaryIndexesrequest fieldstatic io.opentelemetry.api.common.AttributeKey<String>AWS_DYNAMODB_INDEX_NAMEThe value of theIndexNamerequest parameter.static io.opentelemetry.api.common.AttributeKey<String>AWS_DYNAMODB_ITEM_COLLECTION_METRICSThe JSON-serialized value of theItemCollectionMetricsresponse field.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_LIMITThe value of theLimitrequest parameter.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_LOCAL_SECONDARY_INDEXESThe JSON-serialized value of each item of theLocalSecondaryIndexesrequest field.static io.opentelemetry.api.common.AttributeKey<String>AWS_DYNAMODB_PROJECTIONThe value of theProjectionExpressionrequest parameter.static io.opentelemetry.api.common.AttributeKey<Double>AWS_DYNAMODB_PROVISIONED_READ_CAPACITYThe value of theProvisionedThroughput.ReadCapacityUnitsrequest parameter.static io.opentelemetry.api.common.AttributeKey<Double>AWS_DYNAMODB_PROVISIONED_WRITE_CAPACITYThe value of theProvisionedThroughput.WriteCapacityUnitsrequest parameter.static io.opentelemetry.api.common.AttributeKey<Boolean>AWS_DYNAMODB_SCAN_FORWARDThe value of theScanIndexForwardrequest parameter.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_SCANNED_COUNTThe value of theScannedCountresponse parameter.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_SEGMENTThe value of theSegmentrequest parameter.static io.opentelemetry.api.common.AttributeKey<String>AWS_DYNAMODB_SELECTThe value of theSelectrequest parameter.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_TABLE_COUNTThe the number of items in theTableNamesresponse parameter.static io.opentelemetry.api.common.AttributeKey<List<String>>AWS_DYNAMODB_TABLE_NAMESThe keys in theRequestItemsobject field.static io.opentelemetry.api.common.AttributeKey<Long>AWS_DYNAMODB_TOTAL_SEGMENTSThe value of theTotalSegmentsrequest parameter.static io.opentelemetry.api.common.AttributeKey<String>AWS_LAMBDA_INVOKED_ARNThe full invoked ARN as provided on theContextpassed to the function (Lambda-Runtime-Invoked-Function-Arnheader on the/runtime/invocation/nextapplicable).static io.opentelemetry.api.common.AttributeKey<String>CODE_FILEPATHThe source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path).static io.opentelemetry.api.common.AttributeKey<String>CODE_FUNCTIONThe method or function name, or equivalent (usually rightmost part of the code unit's name).static io.opentelemetry.api.common.AttributeKey<Long>CODE_LINENOThe line number incode.filepathbest representing the operation.static io.opentelemetry.api.common.AttributeKey<String>CODE_NAMESPACEThe "namespace" within whichcode.functionis defined.static io.opentelemetry.api.common.AttributeKey<String>DB_CASSANDRA_CONSISTENCY_LEVELThe consistency level of the query.static io.opentelemetry.api.common.AttributeKey<String>DB_CASSANDRA_COORDINATOR_DCThe data center of the coordinating node for a query.static io.opentelemetry.api.common.AttributeKey<String>DB_CASSANDRA_COORDINATOR_IDThe ID of the coordinating node for a query.static io.opentelemetry.api.common.AttributeKey<Boolean>DB_CASSANDRA_IDEMPOTENCEWhether or not the query is idempotent.static io.opentelemetry.api.common.AttributeKey<String>DB_CASSANDRA_KEYSPACEThe name of the keyspace being accessed.static io.opentelemetry.api.common.AttributeKey<Long>DB_CASSANDRA_PAGE_SIZEThe fetch size used for paging, i.e. how many rows will be returned at once.static io.opentelemetry.api.common.AttributeKey<Long>DB_CASSANDRA_SPECULATIVE_EXECUTION_COUNTThe number of times a query was speculatively executed.static io.opentelemetry.api.common.AttributeKey<String>DB_CASSANDRA_TABLEThe name of the primary table that the operation is acting upon, including the schema name (if applicable).static io.opentelemetry.api.common.AttributeKey<String>DB_CONNECTION_STRINGThe connection string used to connect to the database.static io.opentelemetry.api.common.AttributeKey<String>DB_HBASE_NAMESPACEThe HBase namespace being accessed.static io.opentelemetry.api.common.AttributeKey<String>DB_JDBC_DRIVER_CLASSNAMEThe fully-qualified class name of the Java Database Connectivity (JDBC) driver used to connect.static io.opentelemetry.api.common.AttributeKey<String>DB_MONGODB_COLLECTIONThe collection being accessed within the database stated indb.name.static io.opentelemetry.api.common.AttributeKey<String>DB_MSSQL_INSTANCE_NAMEThe Microsoft SQL Server instance name connecting to.static io.opentelemetry.api.common.AttributeKey<String>DB_NAMEIf no tech-specific attribute is defined, this attribute is used to report the name of the database being accessed.static io.opentelemetry.api.common.AttributeKey<String>DB_OPERATIONThe name of the operation being executed, e.g. the MongoDB command name such asfindAndModify, or the SQL keyword.static io.opentelemetry.api.common.AttributeKey<Long>DB_REDIS_DATABASE_INDEXThe index of the database being accessed as used in theSELECTcommand, provided as an integer.static io.opentelemetry.api.common.AttributeKey<String>DB_SQL_TABLEThe name of the primary table that the operation is acting upon, including the schema name (if applicable).static io.opentelemetry.api.common.AttributeKey<String>DB_STATEMENTThe database statement being executed.static io.opentelemetry.api.common.AttributeKey<String>DB_SYSTEMAn identifier for the database management system (DBMS) product being used.static io.opentelemetry.api.common.AttributeKey<String>DB_USERUsername for accessing the database.static io.opentelemetry.api.common.AttributeKey<String>ENDUSER_IDUsername or client_id extracted from the access token or Authorization header in the inbound request from outside the system.static io.opentelemetry.api.common.AttributeKey<String>ENDUSER_ROLEActual/assumed role the client is making the request under extracted from token or application security context.static io.opentelemetry.api.common.AttributeKey<String>ENDUSER_SCOPEScopes or granted authorities the client currently possesses extracted from token or application security context.static io.opentelemetry.api.common.AttributeKey<Boolean>EXCEPTION_ESCAPEDSHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span.static StringEXCEPTION_EVENT_NAMEThe name of an event describing an exception.static io.opentelemetry.api.common.AttributeKey<String>EXCEPTION_MESSAGEThe exception message.static io.opentelemetry.api.common.AttributeKey<String>EXCEPTION_STACKTRACEA stacktrace as a string in the natural representation for the language runtime.static io.opentelemetry.api.common.AttributeKey<String>EXCEPTION_TYPEThe type of the exception (its fully-qualified class name, if applicable).static io.opentelemetry.api.common.AttributeKey<Boolean>FAAS_COLDSTARTA boolean that is true if the serverless function is executed for the first time (aka cold-start).static io.opentelemetry.api.common.AttributeKey<String>FAAS_CRONA string containing the schedule period as Cron Expression.static io.opentelemetry.api.common.AttributeKey<String>FAAS_DOCUMENT_COLLECTIONThe name of the source on which the triggering operation was performed.static io.opentelemetry.api.common.AttributeKey<String>FAAS_DOCUMENT_NAMEThe document name/table subjected to the operation.static io.opentelemetry.api.common.AttributeKey<String>FAAS_DOCUMENT_OPERATIONDescribes the type of the operation that was performed on the data.static io.opentelemetry.api.common.AttributeKey<String>FAAS_DOCUMENT_TIMEstatic io.opentelemetry.api.common.AttributeKey<String>FAAS_EXECUTIONThe execution ID of the current function execution.static io.opentelemetry.api.common.AttributeKey<String>FAAS_INVOKED_NAMEThe name of the invoked function.static io.opentelemetry.api.common.AttributeKey<String>FAAS_INVOKED_PROVIDERThe cloud provider of the invoked function.static io.opentelemetry.api.common.AttributeKey<String>FAAS_INVOKED_REGIONThe cloud region of the invoked function.static io.opentelemetry.api.common.AttributeKey<String>FAAS_TIMEstatic io.opentelemetry.api.common.AttributeKey<String>FAAS_TRIGGERType of the trigger on which the function is executed.static io.opentelemetry.api.common.AttributeKey<String>HTTP_CLIENT_IPThe IP address of the original client behind all proxies, if known (e.g. from X-Forwarded-For).static io.opentelemetry.api.common.AttributeKey<String>HTTP_FLAVORKind of HTTP protocol used.static io.opentelemetry.api.common.AttributeKey<String>HTTP_HOSTThe value of the HTTP host header.static io.opentelemetry.api.common.AttributeKey<String>HTTP_METHODHTTP request method.static io.opentelemetry.api.common.AttributeKey<Long>HTTP_REQUEST_CONTENT_LENGTHThe size of the request payload body in bytes.static io.opentelemetry.api.common.AttributeKey<Long>HTTP_REQUEST_CONTENT_LENGTH_UNCOMPRESSEDThe size of the uncompressed request payload body after transport decoding.static io.opentelemetry.api.common.AttributeKey<Long>HTTP_RESPONSE_CONTENT_LENGTHThe size of the response payload body in bytes.static io.opentelemetry.api.common.AttributeKey<Long>HTTP_RESPONSE_CONTENT_LENGTH_UNCOMPRESSEDThe size of the uncompressed response payload body after transport decoding.static io.opentelemetry.api.common.AttributeKey<String>HTTP_ROUTEThe matched route (path template).static io.opentelemetry.api.common.AttributeKey<String>HTTP_SCHEMEThe URI scheme identifying the used protocol.static io.opentelemetry.api.common.AttributeKey<String>HTTP_SERVER_NAMEThe primary server name of the matched virtual host.static io.opentelemetry.api.common.AttributeKey<Long>HTTP_STATUS_CODEstatic io.opentelemetry.api.common.AttributeKey<String>HTTP_TARGETThe full request target as passed in a HTTP request line or equivalent.static io.opentelemetry.api.common.AttributeKey<String>HTTP_URLFull HTTP request URL in the formscheme://host[:port]/path?query[#fragment].static io.opentelemetry.api.common.AttributeKey<String>HTTP_USER_AGENTValue of the HTTP User-Agent header sent by the client.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_CONVERSATION_IDThe conversation ID identifying the conversation to which the message belongs, represented as a string.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_DESTINATIONThe message destination name.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_DESTINATION_KINDThe kind of message destinationstatic io.opentelemetry.api.common.AttributeKey<String>MESSAGING_KAFKA_CLIENT_IDClient Id for the Consumer or Producer that is handling the message.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_KAFKA_CONSUMER_GROUPName of the Kafka Consumer Group that is handling the message.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_KAFKA_MESSAGE_KEYMessage keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition.static io.opentelemetry.api.common.AttributeKey<Long>MESSAGING_KAFKA_PARTITIONPartition the message is sent to.static io.opentelemetry.api.common.AttributeKey<Boolean>MESSAGING_KAFKA_TOMBSTONEA boolean that is true if the message is a tombstone.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_MESSAGE_IDA value used by the messaging system as an identifier for the message, represented as a string.static io.opentelemetry.api.common.AttributeKey<Long>MESSAGING_MESSAGE_PAYLOAD_COMPRESSED_SIZE_BYTESThe compressed size of the message payload in bytes.static io.opentelemetry.api.common.AttributeKey<Long>MESSAGING_MESSAGE_PAYLOAD_SIZE_BYTESThe (uncompressed) size of the message payload in bytes.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_OPERATIONA string identifying the kind of message consumption as defined in the Operation names section above.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_PROTOCOLThe name of the transport protocol.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_PROTOCOL_VERSIONThe version of the transport protocol.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_RABBITMQ_ROUTING_KEYRabbitMQ message routing key.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_SYSTEMA string identifying the messaging system.static io.opentelemetry.api.common.AttributeKey<Boolean>MESSAGING_TEMP_DESTINATIONA boolean that is true if the message destination is temporary.static io.opentelemetry.api.common.AttributeKey<String>MESSAGING_URLConnection string.static io.opentelemetry.api.common.AttributeKey<String>NET_HOST_IPLikenet.peer.ipbut for the host IP.static io.opentelemetry.api.common.AttributeKey<String>NET_HOST_NAMELocal hostname or similar, see note below.static io.opentelemetry.api.common.AttributeKey<Long>NET_HOST_PORTLikenet.peer.portbut for the host port.static io.opentelemetry.api.common.AttributeKey<String>NET_PEER_IPRemote address of the peer (dotted decimal for IPv4 or RFC5952 for IPv6)static io.opentelemetry.api.common.AttributeKey<String>NET_PEER_NAMERemote hostname or similar, see note below.static io.opentelemetry.api.common.AttributeKey<Long>NET_PEER_PORTRemote port number.static io.opentelemetry.api.common.AttributeKey<String>NET_TRANSPORTTransport protocol used.static io.opentelemetry.api.common.AttributeKey<String>PEER_SERVICETheservice.nameof the remote service.static io.opentelemetry.api.common.AttributeKey<Long>RPC_GRPC_STATUS_CODEThe numeric status code of the gRPC request.static io.opentelemetry.api.common.AttributeKey<Long>RPC_JSONRPC_ERROR_CODEerror.codeproperty of response if it is an error response.static io.opentelemetry.api.common.AttributeKey<String>RPC_JSONRPC_ERROR_MESSAGEerror.messageproperty of response if it is an error response.static io.opentelemetry.api.common.AttributeKey<String>RPC_JSONRPC_REQUEST_IDidproperty of request or response.static io.opentelemetry.api.common.AttributeKey<String>RPC_JSONRPC_VERSIONProtocol version as injsonrpcproperty of request/response.static io.opentelemetry.api.common.AttributeKey<String>RPC_METHODThe name of the (logical) method being called, must be equal to the $method part in the span name.static io.opentelemetry.api.common.AttributeKey<String>RPC_SERVICEThe full (logical) name of the service being called, including its package name, if applicable.static io.opentelemetry.api.common.AttributeKey<String>RPC_SYSTEMA string identifying the remoting system.static StringSCHEMA_URLThe URL of the OpenTelemetry schema for these keys and values.static io.opentelemetry.api.common.AttributeKey<Long>THREAD_IDCurrent "managed" thread ID (as opposed to OS thread ID).static io.opentelemetry.api.common.AttributeKey<String>THREAD_NAMECurrent thread name.
-
-
-
Field Detail
-
SCHEMA_URL
public static final String SCHEMA_URL
The URL of the OpenTelemetry schema for these keys and values.- See Also:
- Constant Field Values
-
AWS_LAMBDA_INVOKED_ARN
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_LAMBDA_INVOKED_ARN
The full invoked ARN as provided on theContextpassed to the function (Lambda-Runtime-Invoked-Function-Arnheader on the/runtime/invocation/nextapplicable).Notes:
- This may be different from
faas.idif an alias is involved.
- This may be different from
-
DB_SYSTEM
public static final io.opentelemetry.api.common.AttributeKey<String> DB_SYSTEM
An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers.
-
DB_CONNECTION_STRING
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CONNECTION_STRING
The connection string used to connect to the database. It is recommended to remove embedded credentials.
-
DB_USER
public static final io.opentelemetry.api.common.AttributeKey<String> DB_USER
Username for accessing the database.
-
DB_JDBC_DRIVER_CLASSNAME
public static final io.opentelemetry.api.common.AttributeKey<String> DB_JDBC_DRIVER_CLASSNAME
The fully-qualified class name of the Java Database Connectivity (JDBC) driver used to connect.
-
DB_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> DB_NAME
If no tech-specific attribute is defined, this attribute is used to report the name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails).Notes:
- In some SQL databases, the database name to be used is called "schema name".
-
DB_STATEMENT
public static final io.opentelemetry.api.common.AttributeKey<String> DB_STATEMENT
The database statement being executed.Notes:
- The value may be sanitized to exclude sensitive information.
-
DB_OPERATION
public static final io.opentelemetry.api.common.AttributeKey<String> DB_OPERATION
The name of the operation being executed, e.g. the MongoDB command name such asfindAndModify, or the SQL keyword.Notes:
- When setting this to an SQL keyword, it is not recommended to attempt any client-side
parsing of
db.statementjust to get this property, but it should be set if the operation name is provided by the library being instrumented. If the SQL statement has an ambiguous operation, or performs more than one operation, this value may be omitted.
- When setting this to an SQL keyword, it is not recommended to attempt any client-side
parsing of
-
DB_MSSQL_INSTANCE_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> DB_MSSQL_INSTANCE_NAME
The Microsoft SQL Server instance name connecting to. This name is used to determine the port of a named instance.Notes:
- If setting a
db.mssql.instance_name,net.peer.portis no longer required (but still recommended if non-standard).
- If setting a
-
DB_CASSANDRA_KEYSPACE
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CASSANDRA_KEYSPACE
The name of the keyspace being accessed. To be used instead of the genericdb.nameattribute.
-
DB_CASSANDRA_PAGE_SIZE
public static final io.opentelemetry.api.common.AttributeKey<Long> DB_CASSANDRA_PAGE_SIZE
The fetch size used for paging, i.e. how many rows will be returned at once.
-
DB_CASSANDRA_CONSISTENCY_LEVEL
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CASSANDRA_CONSISTENCY_LEVEL
The consistency level of the query. Based on consistency values from CQL.
-
DB_CASSANDRA_TABLE
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CASSANDRA_TABLE
The name of the primary table that the operation is acting upon, including the schema name (if applicable).Notes:
- This mirrors the db.sql.table attribute but references cassandra rather than sql. It is
not recommended to attempt any client-side parsing of
db.statementjust to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
- This mirrors the db.sql.table attribute but references cassandra rather than sql. It is
not recommended to attempt any client-side parsing of
-
DB_CASSANDRA_IDEMPOTENCE
public static final io.opentelemetry.api.common.AttributeKey<Boolean> DB_CASSANDRA_IDEMPOTENCE
Whether or not the query is idempotent.
-
DB_CASSANDRA_SPECULATIVE_EXECUTION_COUNT
public static final io.opentelemetry.api.common.AttributeKey<Long> DB_CASSANDRA_SPECULATIVE_EXECUTION_COUNT
The number of times a query was speculatively executed. Not set or0if the query was not executed speculatively.
-
DB_CASSANDRA_COORDINATOR_ID
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CASSANDRA_COORDINATOR_ID
The ID of the coordinating node for a query.
-
DB_CASSANDRA_COORDINATOR_DC
public static final io.opentelemetry.api.common.AttributeKey<String> DB_CASSANDRA_COORDINATOR_DC
The data center of the coordinating node for a query.
-
DB_HBASE_NAMESPACE
public static final io.opentelemetry.api.common.AttributeKey<String> DB_HBASE_NAMESPACE
The HBase namespace being accessed. To be used instead of the genericdb.nameattribute.
-
DB_REDIS_DATABASE_INDEX
public static final io.opentelemetry.api.common.AttributeKey<Long> DB_REDIS_DATABASE_INDEX
The index of the database being accessed as used in theSELECTcommand, provided as an integer. To be used instead of the genericdb.nameattribute.
-
DB_MONGODB_COLLECTION
public static final io.opentelemetry.api.common.AttributeKey<String> DB_MONGODB_COLLECTION
The collection being accessed within the database stated indb.name.
-
DB_SQL_TABLE
public static final io.opentelemetry.api.common.AttributeKey<String> DB_SQL_TABLE
The name of the primary table that the operation is acting upon, including the schema name (if applicable).Notes:
- It is not recommended to attempt any client-side parsing of
db.statementjust to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
- It is not recommended to attempt any client-side parsing of
-
EXCEPTION_TYPE
public static final io.opentelemetry.api.common.AttributeKey<String> EXCEPTION_TYPE
The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it.
-
EXCEPTION_MESSAGE
public static final io.opentelemetry.api.common.AttributeKey<String> EXCEPTION_MESSAGE
The exception message.
-
EXCEPTION_STACKTRACE
public static final io.opentelemetry.api.common.AttributeKey<String> EXCEPTION_STACKTRACE
A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG.
-
EXCEPTION_ESCAPED
public static final io.opentelemetry.api.common.AttributeKey<Boolean> EXCEPTION_ESCAPED
SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span.Notes:
- An exception is considered to have escaped (or left) the scope of a span, if that span is
ended while the exception is still logically "in flight". This may be actually
"in flight" in some languages (e.g. if the exception is passed to a Context
manager's
__exit__method in Python) but will usually be caught at the point of recording the exception in most languages. - It is usually not possible to determine at the point where an exception is thrown whether it will escape the scope of a span. However, it is trivial to know that an exception will escape, if one checks for an active exception just before ending the span, as done in the example above.
- It follows that an exception may still escape the scope of the span even if the
exception.escapedattribute was not set or set to false, since the event might have been recorded at a time where it was not clear whether the exception will escape.
- An exception is considered to have escaped (or left) the scope of a span, if that span is
ended while the exception is still logically "in flight". This may be actually
"in flight" in some languages (e.g. if the exception is passed to a Context
manager's
-
FAAS_TRIGGER
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_TRIGGER
Type of the trigger on which the function is executed.
-
FAAS_EXECUTION
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_EXECUTION
The execution ID of the current function execution.
-
FAAS_DOCUMENT_COLLECTION
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_DOCUMENT_COLLECTION
The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name.
-
FAAS_DOCUMENT_OPERATION
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_DOCUMENT_OPERATION
Describes the type of the operation that was performed on the data.
-
FAAS_DOCUMENT_TIME
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_DOCUMENT_TIME
-
FAAS_DOCUMENT_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_DOCUMENT_NAME
The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name.
-
FAAS_TIME
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_TIME
-
FAAS_CRON
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_CRON
A string containing the schedule period as Cron Expression.
-
FAAS_COLDSTART
public static final io.opentelemetry.api.common.AttributeKey<Boolean> FAAS_COLDSTART
A boolean that is true if the serverless function is executed for the first time (aka cold-start).
-
FAAS_INVOKED_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_INVOKED_NAME
The name of the invoked function.Notes:
- SHOULD be equal to the
faas.nameresource attribute of the invoked function.
- SHOULD be equal to the
-
FAAS_INVOKED_PROVIDER
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_INVOKED_PROVIDER
The cloud provider of the invoked function.Notes:
- SHOULD be equal to the
cloud.providerresource attribute of the invoked function.
- SHOULD be equal to the
-
FAAS_INVOKED_REGION
public static final io.opentelemetry.api.common.AttributeKey<String> FAAS_INVOKED_REGION
The cloud region of the invoked function.Notes:
- SHOULD be equal to the
cloud.regionresource attribute of the invoked function.
- SHOULD be equal to the
-
NET_TRANSPORT
public static final io.opentelemetry.api.common.AttributeKey<String> NET_TRANSPORT
Transport protocol used. See note below.
-
NET_PEER_IP
public static final io.opentelemetry.api.common.AttributeKey<String> NET_PEER_IP
Remote address of the peer (dotted decimal for IPv4 or RFC5952 for IPv6)
-
NET_PEER_PORT
public static final io.opentelemetry.api.common.AttributeKey<Long> NET_PEER_PORT
Remote port number.
-
NET_PEER_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> NET_PEER_NAME
Remote hostname or similar, see note below.
-
NET_HOST_IP
public static final io.opentelemetry.api.common.AttributeKey<String> NET_HOST_IP
Likenet.peer.ipbut for the host IP. Useful in case of a multi-IP host.
-
NET_HOST_PORT
public static final io.opentelemetry.api.common.AttributeKey<Long> NET_HOST_PORT
Likenet.peer.portbut for the host port.
-
NET_HOST_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> NET_HOST_NAME
Local hostname or similar, see note below.
-
PEER_SERVICE
public static final io.opentelemetry.api.common.AttributeKey<String> PEER_SERVICE
Theservice.nameof the remote service. SHOULD be equal to the actualservice.nameresource attribute of the remote service if any.
-
ENDUSER_ID
public static final io.opentelemetry.api.common.AttributeKey<String> ENDUSER_ID
Username or client_id extracted from the access token or Authorization header in the inbound request from outside the system.
-
ENDUSER_ROLE
public static final io.opentelemetry.api.common.AttributeKey<String> ENDUSER_ROLE
Actual/assumed role the client is making the request under extracted from token or application security context.
-
ENDUSER_SCOPE
public static final io.opentelemetry.api.common.AttributeKey<String> ENDUSER_SCOPE
Scopes or granted authorities the client currently possesses extracted from token or application security context. The value would come from the scope associated with an OAuth 2.0 Access Token or an attribute value in a SAML 2.0 Assertion.
-
THREAD_ID
public static final io.opentelemetry.api.common.AttributeKey<Long> THREAD_ID
Current "managed" thread ID (as opposed to OS thread ID).
-
THREAD_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> THREAD_NAME
Current thread name.
-
CODE_FUNCTION
public static final io.opentelemetry.api.common.AttributeKey<String> CODE_FUNCTION
The method or function name, or equivalent (usually rightmost part of the code unit's name).
-
CODE_NAMESPACE
public static final io.opentelemetry.api.common.AttributeKey<String> CODE_NAMESPACE
The "namespace" within whichcode.functionis defined. Usually the qualified class or module name, such thatcode.namespace+ some separator +code.functionform a unique identifier for the code unit.
-
CODE_FILEPATH
public static final io.opentelemetry.api.common.AttributeKey<String> CODE_FILEPATH
The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path).
-
CODE_LINENO
public static final io.opentelemetry.api.common.AttributeKey<Long> CODE_LINENO
The line number incode.filepathbest representing the operation. It SHOULD point within the code unit named incode.function.
-
HTTP_METHOD
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_METHOD
HTTP request method.
-
HTTP_URL
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_URL
Full HTTP request URL in the formscheme://host[:port]/path?query[#fragment]. Usually the fragment is not transmitted over HTTP, but if it is known, it should be included nevertheless.Notes:
http.urlMUST NOT contain credentials passed via URL in form ofhttps://username:password@www.example.com/. In such case the attribute's value should behttps://www.example.com/.
-
HTTP_TARGET
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_TARGET
The full request target as passed in a HTTP request line or equivalent.
-
HTTP_HOST
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_HOST
The value of the HTTP host header. When the header is empty or not present, this attribute should be the same.
-
HTTP_SCHEME
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_SCHEME
The URI scheme identifying the used protocol.
-
HTTP_STATUS_CODE
public static final io.opentelemetry.api.common.AttributeKey<Long> HTTP_STATUS_CODE
-
HTTP_FLAVOR
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_FLAVOR
Kind of HTTP protocol used.Notes:
- If
net.transportis not specified, it can be assumed to beIP.TCPexcept ifhttp.flavorisQUIC, in which caseIP.UDPis assumed.
- If
-
HTTP_USER_AGENT
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_USER_AGENT
Value of the HTTP User-Agent header sent by the client.
-
HTTP_REQUEST_CONTENT_LENGTH
public static final io.opentelemetry.api.common.AttributeKey<Long> HTTP_REQUEST_CONTENT_LENGTH
The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the Content-Length header. For requests using transport encoding, this should be the compressed size.
-
HTTP_REQUEST_CONTENT_LENGTH_UNCOMPRESSED
public static final io.opentelemetry.api.common.AttributeKey<Long> HTTP_REQUEST_CONTENT_LENGTH_UNCOMPRESSED
The size of the uncompressed request payload body after transport decoding. Not set if transport encoding not used.
-
HTTP_RESPONSE_CONTENT_LENGTH
public static final io.opentelemetry.api.common.AttributeKey<Long> HTTP_RESPONSE_CONTENT_LENGTH
The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the Content-Length header. For requests using transport encoding, this should be the compressed size.
-
HTTP_RESPONSE_CONTENT_LENGTH_UNCOMPRESSED
public static final io.opentelemetry.api.common.AttributeKey<Long> HTTP_RESPONSE_CONTENT_LENGTH_UNCOMPRESSED
The size of the uncompressed response payload body after transport decoding. Not set if transport encoding not used.
-
HTTP_SERVER_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_SERVER_NAME
The primary server name of the matched virtual host. This should be obtained via configuration. If no such configuration can be obtained, this attribute MUST NOT be set (net.host.nameshould be used instead).Notes:
http.urlis usually not readily available on the server side but would have to be assembled in a cumbersome and sometimes lossy process from other information (see e.g. open-telemetry/opentelemetry-python/pull/148). It is thus preferred to supply the raw data that is available.
-
HTTP_ROUTE
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_ROUTE
The matched route (path template).
-
HTTP_CLIENT_IP
public static final io.opentelemetry.api.common.AttributeKey<String> HTTP_CLIENT_IP
The IP address of the original client behind all proxies, if known (e.g. from X-Forwarded-For).Notes:
- This is not necessarily the same as
net.peer.ip, which would identify the network-level peer, which may be a proxy.
- This is not necessarily the same as
-
AWS_DYNAMODB_TABLE_NAMES
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_TABLE_NAMES
The keys in theRequestItemsobject field.
-
AWS_DYNAMODB_CONSUMED_CAPACITY
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_CONSUMED_CAPACITY
The JSON-serialized value of each item in theConsumedCapacityresponse field.
-
AWS_DYNAMODB_ITEM_COLLECTION_METRICS
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_DYNAMODB_ITEM_COLLECTION_METRICS
The JSON-serialized value of theItemCollectionMetricsresponse field.
-
AWS_DYNAMODB_PROVISIONED_READ_CAPACITY
public static final io.opentelemetry.api.common.AttributeKey<Double> AWS_DYNAMODB_PROVISIONED_READ_CAPACITY
The value of theProvisionedThroughput.ReadCapacityUnitsrequest parameter.
-
AWS_DYNAMODB_PROVISIONED_WRITE_CAPACITY
public static final io.opentelemetry.api.common.AttributeKey<Double> AWS_DYNAMODB_PROVISIONED_WRITE_CAPACITY
The value of theProvisionedThroughput.WriteCapacityUnitsrequest parameter.
-
AWS_DYNAMODB_CONSISTENT_READ
public static final io.opentelemetry.api.common.AttributeKey<Boolean> AWS_DYNAMODB_CONSISTENT_READ
The value of theConsistentReadrequest parameter.
-
AWS_DYNAMODB_PROJECTION
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_DYNAMODB_PROJECTION
The value of theProjectionExpressionrequest parameter.
-
AWS_DYNAMODB_LIMIT
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_LIMIT
The value of theLimitrequest parameter.
-
AWS_DYNAMODB_ATTRIBUTES_TO_GET
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_ATTRIBUTES_TO_GET
The value of theAttributesToGetrequest parameter.
-
AWS_DYNAMODB_INDEX_NAME
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_DYNAMODB_INDEX_NAME
The value of theIndexNamerequest parameter.
-
AWS_DYNAMODB_SELECT
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_DYNAMODB_SELECT
The value of theSelectrequest parameter.
-
AWS_DYNAMODB_GLOBAL_SECONDARY_INDEXES
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_GLOBAL_SECONDARY_INDEXES
The JSON-serialized value of each item of theGlobalSecondaryIndexesrequest field
-
AWS_DYNAMODB_LOCAL_SECONDARY_INDEXES
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_LOCAL_SECONDARY_INDEXES
The JSON-serialized value of each item of theLocalSecondaryIndexesrequest field.
-
AWS_DYNAMODB_EXCLUSIVE_START_TABLE
public static final io.opentelemetry.api.common.AttributeKey<String> AWS_DYNAMODB_EXCLUSIVE_START_TABLE
The value of theExclusiveStartTableNamerequest parameter.
-
AWS_DYNAMODB_TABLE_COUNT
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_TABLE_COUNT
The the number of items in theTableNamesresponse parameter.
-
AWS_DYNAMODB_SCAN_FORWARD
public static final io.opentelemetry.api.common.AttributeKey<Boolean> AWS_DYNAMODB_SCAN_FORWARD
The value of theScanIndexForwardrequest parameter.
-
AWS_DYNAMODB_SEGMENT
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_SEGMENT
The value of theSegmentrequest parameter.
-
AWS_DYNAMODB_TOTAL_SEGMENTS
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_TOTAL_SEGMENTS
The value of theTotalSegmentsrequest parameter.
-
AWS_DYNAMODB_COUNT
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_COUNT
The value of theCountresponse parameter.
-
AWS_DYNAMODB_SCANNED_COUNT
public static final io.opentelemetry.api.common.AttributeKey<Long> AWS_DYNAMODB_SCANNED_COUNT
The value of theScannedCountresponse parameter.
-
AWS_DYNAMODB_ATTRIBUTE_DEFINITIONS
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_ATTRIBUTE_DEFINITIONS
The JSON-serialized value of each item in theAttributeDefinitionsrequest field.
-
AWS_DYNAMODB_GLOBAL_SECONDARY_INDEX_UPDATES
public static final io.opentelemetry.api.common.AttributeKey<List<String>> AWS_DYNAMODB_GLOBAL_SECONDARY_INDEX_UPDATES
The JSON-serialized value of each item in the theGlobalSecondaryIndexUpdatesrequest field.
-
MESSAGING_SYSTEM
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_SYSTEM
A string identifying the messaging system.
-
MESSAGING_DESTINATION
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_DESTINATION
The message destination name. This might be equal to the span name but is required nevertheless.
-
MESSAGING_DESTINATION_KIND
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_DESTINATION_KIND
The kind of message destination
-
MESSAGING_TEMP_DESTINATION
public static final io.opentelemetry.api.common.AttributeKey<Boolean> MESSAGING_TEMP_DESTINATION
A boolean that is true if the message destination is temporary.
-
MESSAGING_PROTOCOL
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_PROTOCOL
The name of the transport protocol.
-
MESSAGING_PROTOCOL_VERSION
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_PROTOCOL_VERSION
The version of the transport protocol.
-
MESSAGING_URL
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_URL
Connection string.
-
MESSAGING_MESSAGE_ID
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_MESSAGE_ID
A value used by the messaging system as an identifier for the message, represented as a string.
-
MESSAGING_CONVERSATION_ID
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_CONVERSATION_ID
The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID".
-
MESSAGING_MESSAGE_PAYLOAD_SIZE_BYTES
public static final io.opentelemetry.api.common.AttributeKey<Long> MESSAGING_MESSAGE_PAYLOAD_SIZE_BYTES
The (uncompressed) size of the message payload in bytes. Also use this attribute if it is unknown whether the compressed or uncompressed payload size is reported.
-
MESSAGING_MESSAGE_PAYLOAD_COMPRESSED_SIZE_BYTES
public static final io.opentelemetry.api.common.AttributeKey<Long> MESSAGING_MESSAGE_PAYLOAD_COMPRESSED_SIZE_BYTES
The compressed size of the message payload in bytes.
-
MESSAGING_OPERATION
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_OPERATION
A string identifying the kind of message consumption as defined in the Operation names section above. If the operation is "send", this attribute MUST NOT be set, since the operation can be inferred from the span kind in that case.
-
MESSAGING_RABBITMQ_ROUTING_KEY
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_RABBITMQ_ROUTING_KEY
RabbitMQ message routing key.
-
MESSAGING_KAFKA_MESSAGE_KEY
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_KAFKA_MESSAGE_KEY
Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ frommessaging.message_idin that they're not unique. If the key isnull, the attribute MUST NOT be set.Notes:
- If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
-
MESSAGING_KAFKA_CONSUMER_GROUP
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_KAFKA_CONSUMER_GROUP
Name of the Kafka Consumer Group that is handling the message. Only applies to consumers, not producers.
-
MESSAGING_KAFKA_CLIENT_ID
public static final io.opentelemetry.api.common.AttributeKey<String> MESSAGING_KAFKA_CLIENT_ID
Client Id for the Consumer or Producer that is handling the message.
-
MESSAGING_KAFKA_PARTITION
public static final io.opentelemetry.api.common.AttributeKey<Long> MESSAGING_KAFKA_PARTITION
Partition the message is sent to.
-
MESSAGING_KAFKA_TOMBSTONE
public static final io.opentelemetry.api.common.AttributeKey<Boolean> MESSAGING_KAFKA_TOMBSTONE
A boolean that is true if the message is a tombstone.
-
RPC_SYSTEM
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_SYSTEM
A string identifying the remoting system.
-
RPC_SERVICE
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_SERVICE
The full (logical) name of the service being called, including its package name, if applicable.Notes:
- This is the logical name of the service from the RPC interface perspective, which can be
different from the name of any implementing class. The
code.namespaceattribute may be used to store the latter (despite the attribute name, it may include a class name; e.g., class with method actually executing the call on the server side, RPC client stub class on the client side).
- This is the logical name of the service from the RPC interface perspective, which can be
different from the name of any implementing class. The
-
RPC_METHOD
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_METHOD
The name of the (logical) method being called, must be equal to the $method part in the span name.Notes:
- This is the logical name of the method from the RPC interface perspective, which can be
different from the name of any implementing method/function. The
code.functionattribute may be used to store the latter (e.g., method actually executing the call on the server side, RPC client stub method on the client side).
- This is the logical name of the method from the RPC interface perspective, which can be
different from the name of any implementing method/function. The
-
RPC_GRPC_STATUS_CODE
public static final io.opentelemetry.api.common.AttributeKey<Long> RPC_GRPC_STATUS_CODE
The numeric status code of the gRPC request.
-
RPC_JSONRPC_VERSION
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_VERSION
Protocol version as injsonrpcproperty of request/response. Since JSON-RPC 1.0 does not specify this, the value can be omitted.
-
RPC_JSONRPC_REQUEST_ID
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_REQUEST_ID
idproperty of request or response. Since protocol allows id to be int, string,nullor missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case ofnullvalue. Omit entirely if this is a notification.
-
RPC_JSONRPC_ERROR_CODE
public static final io.opentelemetry.api.common.AttributeKey<Long> RPC_JSONRPC_ERROR_CODE
error.codeproperty of response if it is an error response.
-
RPC_JSONRPC_ERROR_MESSAGE
public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_ERROR_MESSAGE
error.messageproperty of response if it is an error response.
-
EXCEPTION_EVENT_NAME
public static final String EXCEPTION_EVENT_NAME
The name of an event describing an exception.Typically an event with that name should not be manually created. Instead
Span.recordException(Throwable)should be used.- See Also:
- Constant Field Values
-
-