Class RpcIncubatingAttributes
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classDeprecated.static final classDeprecated.Use string representation of the gRPC status code on therpc.response.status_codeattribute.static final classDeprecated.Deprecated, no replacement at this time.static final classDeprecated.Replaced byrpc.system.name.static final classValues forRPC_SYSTEM_NAME. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Replaced byrpc.response.status_code.Deprecated.Replaced byrpc.request.metadata.Deprecated.Replaced byrpc.response.metadata.Deprecated.Replaced byrpc.request.metadata.Deprecated.Replaced byrpc.response.metadata.static final io.opentelemetry.api.common.AttributeKey<Long> Deprecated.Use string representation of the gRPC status code on therpc.response.status_codeattribute.static final io.opentelemetry.api.common.AttributeKey<Long> Deprecated.Use string representation of the error code on therpc.response.status_codeattribute.static final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Use the span status description when reporting JSON-RPC spans.static final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Replaced byjsonrpc.request.id.static final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Replaced byjsonrpc.protocol.version.static final io.opentelemetry.api.common.AttributeKey<Long> Deprecated.Deprecated, no replacement at this time.static final io.opentelemetry.api.common.AttributeKey<Long> Deprecated.Deprecated, no replacement at this time.static final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Deprecated, no replacement at this time.static final io.opentelemetry.api.common.AttributeKey<Long> Deprecated.Deprecated, no replacement at this time.static final io.opentelemetry.api.common.AttributeKey<String> The fully-qualified logical name of the method from the RPC interface perspective.static final io.opentelemetry.api.common.AttributeKey<String> The original name of the method used by the client.RPC request metadata,<key>being the normalized RPC metadata key (lowercase), the value being the metadata values.RPC response metadata,<key>being the normalized RPC metadata key (lowercase), the value being the metadata values.static final io.opentelemetry.api.common.AttributeKey<String> Status code of the RPC returned by the RPC server or generated by the clientstatic final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Value should be included inrpc.methodwhich is expected to be a fully-qualified name.static final io.opentelemetry.api.common.AttributeKey<String> Deprecated.Replaced byrpc.system.name.static final io.opentelemetry.api.common.AttributeKey<String> The Remote Procedure Call (RPC) system. -
Method Summary
-
Field Details
-
RPC_CONNECT_RPC_ERROR_CODE
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> RPC_CONNECT_RPC_ERROR_CODEDeprecated.Replaced byrpc.response.status_code.Deprecated, userpc.response.status_codeattribute instead. -
RPC_CONNECT_RPC_REQUEST_METADATA
@Deprecated public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_CONNECT_RPC_REQUEST_METADATADeprecated.Replaced byrpc.request.metadata.Deprecated, userpc.request.metadatainstead. -
RPC_CONNECT_RPC_RESPONSE_METADATA
@Deprecated public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_CONNECT_RPC_RESPONSE_METADATADeprecated.Replaced byrpc.response.metadata.Deprecated, userpc.response.metadatainstead. -
RPC_GRPC_REQUEST_METADATA
@Deprecated public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_GRPC_REQUEST_METADATADeprecated.Replaced byrpc.request.metadata.Deprecated, userpc.request.metadatainstead. -
RPC_GRPC_RESPONSE_METADATA
@Deprecated public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_GRPC_RESPONSE_METADATADeprecated.Replaced byrpc.response.metadata.Deprecated, userpc.response.metadatainstead. -
RPC_GRPC_STATUS_CODE
Deprecated.Use string representation of the gRPC status code on therpc.response.status_codeattribute.Deprecated, use string representation on therpc.response.status_codeattribute instead. -
RPC_JSONRPC_ERROR_CODE
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<Long> RPC_JSONRPC_ERROR_CODEDeprecated.Use string representation of the error code on therpc.response.status_codeattribute.Deprecated, use string representation on therpc.response.status_codeattribute instead. -
RPC_JSONRPC_ERROR_MESSAGE
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_ERROR_MESSAGEDeprecated.Use the span status description when reporting JSON-RPC spans.Deprecated, use the span status description when reporting JSON-RPC spans. -
RPC_JSONRPC_REQUEST_ID
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_REQUEST_IDDeprecated.Replaced byjsonrpc.request.id.Deprecated, usejsonrpc.request.idinstead. -
RPC_JSONRPC_VERSION
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> RPC_JSONRPC_VERSIONDeprecated.Replaced byjsonrpc.protocol.version.Deprecated, usejsonrpc.protocol.versioninstead. -
RPC_MESSAGE_COMPRESSED_SIZE
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<Long> RPC_MESSAGE_COMPRESSED_SIZEDeprecated.Deprecated, no replacement at this time.Compressed size of the message in bytes. -
RPC_MESSAGE_ID
Deprecated.Deprecated, no replacement at this time.MUST be calculated as two different counters starting from1one for sent messages and one for received message.Notes:
This way we guarantee that the values will be consistent between different implementations.
-
RPC_MESSAGE_TYPE
Deprecated.Deprecated, no replacement at this time.Whether this is a received or sent message. -
RPC_MESSAGE_UNCOMPRESSED_SIZE
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<Long> RPC_MESSAGE_UNCOMPRESSED_SIZEDeprecated.Deprecated, no replacement at this time.Uncompressed size of the message in bytes. -
RPC_METHOD
The fully-qualified logical name of the method from the RPC interface perspective.Notes:
The method name MAY have unbounded cardinality in edge or error cases.
Some RPC frameworks or libraries provide a fixed set of recognized methods for client stubs and server implementations. Instrumentations for such frameworks MUST set this attribute to the original method name only when the method is recognized by the framework or library.
When the method is not recognized, for example, when the server receives a request for a method that is not predefined on the server, or when instrumentation is not able to reliably detect if the method is predefined, the attribute MUST be set to
_OTHER. In such cases, tracing instrumentations MUST also setrpc.method_originalattribute to the original method value.If the RPC instrumentation could end up converting valid RPC methods to
_OTHER, then it SHOULD provide a way to configure the list of recognized RPC methods.The
rpc.methodcan be different from the name of any implementing method/function. Thecode.function.nameattribute may be used to record the fully-qualified method actually executing the call on the server side, or the RPC client stub method on the client side. -
RPC_METHOD_ORIGINAL
The original name of the method used by the client. -
RPC_REQUEST_METADATA
public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_REQUEST_METADATARPC request metadata,<key>being the normalized RPC metadata key (lowercase), the value being the metadata values.Notes:
Instrumentations SHOULD require an explicit configuration of which metadata values are to be captured. Including all request metadata values can be a security risk - explicit configuration helps avoid leaking sensitive information.
For example, a property
my-custom-keywith value["1.2.3.4", "1.2.3.5"]SHOULD be recorded asrpc.request.metadata.my-custom-keyattribute with value["1.2.3.4", "1.2.3.5"] -
RPC_RESPONSE_METADATA
public static final io.opentelemetry.semconv.AttributeKeyTemplate<List<String>> RPC_RESPONSE_METADATARPC response metadata,<key>being the normalized RPC metadata key (lowercase), the value being the metadata values.Notes:
Instrumentations SHOULD require an explicit configuration of which metadata values are to be captured. Including all response metadata values can be a security risk - explicit configuration helps avoid leaking sensitive information.
For example, a property
my-custom-keywith value["attribute_value"]SHOULD be recorded as therpc.response.metadata.my-custom-keyattribute with value["attribute_value"] -
RPC_RESPONSE_STATUS_CODE
Status code of the RPC returned by the RPC server or generated by the clientNotes:
Usually it represents an error code, but may also represent partial success, warning, or differentiate between various types of successful outcomes. Semantic conventions for individual RPC frameworks SHOULD document what
rpc.response.status_codemeans in the context of that system and which values are considered to represent errors. -
RPC_SERVICE
Deprecated.Value should be included inrpc.methodwhich is expected to be a fully-qualified name.Deprecated, use fully-qualifiedrpc.methodinstead. -
RPC_SYSTEM
Deprecated.Replaced byrpc.system.name.Deprecated, userpc.system.nameattribute instead. -
RPC_SYSTEM_NAME
The Remote Procedure Call (RPC) system.Notes:
The client and server RPC systems may differ for the same RPC interaction. For example, a client may use Apache Dubbo or Connect RPC to communicate with a server that uses gRPC since both protocols provide compatibility with gRPC.
-
rpc.response.status_code.