You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|[`db.operation.name`](/docs/attributes-registry/db.md)| string | The name of the operation or command being executed. |`findAndModify`; `HMSET`; `SELECT`|`Conditionally Required`[4]||
67
67
|[`error.type`](/docs/attributes-registry/error.md)| string | Describes a class of error the operation ended with. [5]|`timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500`|`Conditionally Required` If and only if the operation failed. ||
68
68
|[`server.port`](/docs/attributes-registry/server.md)| int | Server port number. [6]|`80`; `8080`; `443`|`Conditionally Required`[7]||
69
-
|[`db.instance.id`](/docs/attributes-registry/db.md)| string | Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. |`mysql-e26b99z.example.com`|`Recommended` If different from the `server.address`|<br>Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. |
70
69
|[`network.peer.address`](/docs/attributes-registry/network.md)| string | Peer address of the database node where the operation was performed. [8]|`10.1.2.80`; `/tmp/my.sock`|`Recommended` If applicable for this database system. ||
71
70
|[`network.peer.port`](/docs/attributes-registry/network.md)| int | Peer port number of the network connection. |`65123`|`Recommended` If and only if `network.peer.address` is set. ||
72
71
|[`server.address`](/docs/attributes-registry/server.md)| string | Name of the database host. [9]|`example.com`; `10.1.2.80`; `/tmp/my.sock`|`Recommended`||
|[`url.full`](/docs/attributes-registry/url.md)| string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986)[3]|`https://localhost:9200/index/_search?q=user.id:kimchy`|`Required`||
32
32
|[`db.elasticsearch.path_parts.<key>`](/docs/attributes-registry/db.md)| string | A dynamic value in the url path. [4]|`db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123`|`Conditionally Required` when the url has dynamic values ||
33
-
|[`db.namespace`](/docs/attributes-registry/db.md)| string | The name of the database, fully qualified within the server address and port. [5]|`customers`; `test.users`|`Conditionally Required` If available. ||
34
-
|[`error.type`](/docs/attributes-registry/error.md)| string | Describes a class of error the operation ended with. [6]|`timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500`|`Conditionally Required` If and only if the operation failed. ||
35
-
|[`server.port`](/docs/attributes-registry/server.md)| int | Server port number. [7]|`80`; `8080`; `443`|`Conditionally Required`[8]||
36
-
|[`db.elasticsearch.cluster.name`](/docs/attributes-registry/db.md)| string | Represents the identifier of an Elasticsearch cluster. |`e9106fc68e3044f0b1475b04bf4ffd5f`|`Recommended`[9]||
37
-
|[`db.elasticsearch.node.name`](/docs/attributes-registry/db.md)| string | Represents the human-readable identifier of the node/instance to which a request was routed. |`instance-0000000001`|`Recommended`[10]||
38
-
|[`db.query.text`](/docs/attributes-registry/db.md)| string | The request body for a [search-type query](https://www.elastic.co/guide/en/elasticsearch/reference/current/search.html), as a json string. |`"{\"query\":{\"term\":{\"user.id\":\"kimchy\"}}}"`|`Recommended`[11]||
39
-
|[`server.address`](/docs/attributes-registry/server.md)| string | Name of the database host. [12]|`example.com`; `10.1.2.80`; `/tmp/my.sock`|`Recommended`||
33
+
|[`error.type`](/docs/attributes-registry/error.md)| string | Describes a class of error the operation ended with. [5]|`timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500`|`Conditionally Required` If and only if the operation failed. ||
34
+
|[`server.port`](/docs/attributes-registry/server.md)| int | Server port number. [6]|`80`; `8080`; `443`|`Conditionally Required`[7]||
35
+
|[`db.elasticsearch.cluster.name`](/docs/attributes-registry/db.md)| string | Represents the identifier of an Elasticsearch cluster. |`e9106fc68e3044f0b1475b04bf4ffd5f`|`Recommended`[8]||
36
+
|[`db.elasticsearch.node.name`](/docs/attributes-registry/db.md)| string | Represents the human-readable identifier of the node/instance to which a request was routed. |`instance-0000000001`|`Recommended`[9]||
37
+
|[`db.query.text`](/docs/attributes-registry/db.md)| string | The request body for a [search-type query](https://www.elastic.co/guide/en/elasticsearch/reference/current/search.html), as a json string. |`"{\"query\":{\"term\":{\"user.id\":\"kimchy\"}}}"`|`Recommended`[10]||
38
+
|[`server.address`](/docs/attributes-registry/server.md)| string | Name of the database host. [11]|`example.com`; `10.1.2.80`; `/tmp/my.sock`|`Recommended`||
40
39
41
40
**[1]:** This SHOULD be the endpoint identifier for the request.
42
41
@@ -61,21 +60,19 @@ Tracing instrumentations that do so, MUST also set `http.request.method_original
61
60
62
61
**[4]:** Many Elasticsearch url paths allow dynamic values. These SHOULD be recorded in span attributes in the format `db.elasticsearch.path_parts.<key>`, where `<key>` is the url path part name. The implementation SHOULD reference the [elasticsearch schema](https://raw.githubusercontent.com/elastic/elasticsearch-specification/main/output/schema/schema.json) in order to map the path part values to their names.
63
62
64
-
**[5]:**<!-- TODO: overriding the base note, workaround for https://github.com/open-telemetry/build-tools/issues/299 -->
63
+
**[5]:**The `error.type` SHOULD match the error code returned by the database or the client library, the canonical name of exception that occurred, or another low-cardinality error identifier. Instrumentations SHOULD document the list of errors they report.
65
64
66
-
**[6]:**The `error.type` SHOULD match the error code returned by the database or the client library, the canonical name of exception that occurred, or another low-cardinality error identifier. Instrumentations SHOULD document the list of errors they report.
65
+
**[6]:**When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
67
66
68
-
**[7]:**When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
67
+
**[7]:**If using a port other than the default port for this DBMS and if `server.address` is set.
69
68
70
-
**[8]:**If using a port other than the default port for this DBMS and if `server.address` is set.
69
+
**[8]:**When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Cluster" HTTP response header.
71
70
72
-
**[9]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Cluster" HTTP response header.
71
+
**[9]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Instance" HTTP response header.
73
72
74
-
**[10]:**When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Instance" HTTP response header.
73
+
**[10]:**Should be collected by default for search-type queries and only if there is sanitization that excludes sensitive information.
75
74
76
-
**[11]:** Should be collected by default for search-type queries and only if there is sanitization that excludes sensitive information.
77
-
78
-
**[12]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
75
+
**[11]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
79
76
80
77
`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
0 commit comments