147 lines
12 KiB
Markdown
147 lines
12 KiB
Markdown
<!--- Hugo front matter used to generate the website version of this page:
|
|
--->
|
|
|
|
# Network
|
|
|
|
These attributes may be used for any network related operation.
|
|
|
|
<!-- toc -->
|
|
|
|
- [Network Attributes](#network-attributes)
|
|
- [Deprecated Network Attributes](#deprecated-network-attributes)
|
|
|
|
<!-- tocstop -->
|
|
|
|
## Network Attributes
|
|
|
|
<!-- semconv registry.network(omit_requirement_level) -->
|
|
| Attribute | Type | Description | Examples | Stability |
|
|
|---|---|---|---|---|
|
|
| `network.carrier.icc` | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` |  |
|
|
| `network.carrier.mcc` | string | The mobile carrier country code. | `310` |  |
|
|
| `network.carrier.mnc` | string | The mobile carrier network code. | `001` |  |
|
|
| `network.carrier.name` | string | The name of the mobile carrier. | `sprint` |  |
|
|
| `network.connection.subtype` | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |  |
|
|
| `network.connection.type` | string | The internet connection type. | `wifi` |  |
|
|
| `network.io.direction` | string | The network IO operation direction. | `transmit` |  |
|
|
| `network.local.address` | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
|
|
| `network.local.port` | int | Local port number of the network connection. | `65123` |  |
|
|
| `network.peer.address` | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
|
|
| `network.peer.port` | int | Peer port number of the network connection. | `65123` |  |
|
|
| `network.protocol.name` | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` |  |
|
|
| `network.protocol.version` | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` |  |
|
|
| `network.transport` | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
|
|
| `network.type` | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |  |
|
|
|
|
**[1]:** The value SHOULD be normalized to lowercase.
|
|
|
|
**[2]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
|
|
|
|
**[3]:** The value SHOULD be normalized to lowercase.
|
|
|
|
Consider always setting the transport when setting a port number, since
|
|
a port number is ambiguous without knowing the transport. For example
|
|
different processes could be listening on TCP port 12345 and UDP port 12345.
|
|
|
|
**[4]:** The value SHOULD be normalized to lowercase.
|
|
|
|
`network.connection.subtype` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `gprs` | GPRS |  |
|
|
| `edge` | EDGE |  |
|
|
| `umts` | UMTS |  |
|
|
| `cdma` | CDMA |  |
|
|
| `evdo_0` | EVDO Rel. 0 |  |
|
|
| `evdo_a` | EVDO Rev. A |  |
|
|
| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
|
|
| `hsdpa` | HSDPA |  |
|
|
| `hsupa` | HSUPA |  |
|
|
| `hspa` | HSPA |  |
|
|
| `iden` | IDEN |  |
|
|
| `evdo_b` | EVDO Rev. B |  |
|
|
| `lte` | LTE |  |
|
|
| `ehrpd` | EHRPD |  |
|
|
| `hspap` | HSPAP |  |
|
|
| `gsm` | GSM |  |
|
|
| `td_scdma` | TD-SCDMA |  |
|
|
| `iwlan` | IWLAN |  |
|
|
| `nr` | 5G NR (New Radio) |  |
|
|
| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
|
|
| `lte_ca` | LTE CA |  |
|
|
|
|
`network.connection.type` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `wifi` | wifi |  |
|
|
| `wired` | wired |  |
|
|
| `cell` | cell |  |
|
|
| `unavailable` | unavailable |  |
|
|
| `unknown` | unknown |  |
|
|
|
|
`network.io.direction` MUST be one of the following:
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `transmit` | transmit |  |
|
|
| `receive` | receive |  |
|
|
|
|
`network.transport` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `tcp` | TCP |  |
|
|
| `udp` | UDP |  |
|
|
| `pipe` | Named or anonymous pipe. |  |
|
|
| `unix` | Unix domain socket |  |
|
|
|
|
`network.type` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `ipv4` | IPv4 |  |
|
|
| `ipv6` | IPv6 |  |
|
|
<!-- endsemconv -->
|
|
|
|
## Deprecated Network Attributes
|
|
|
|
<!-- semconv registry.network.deprecated(omit_requirement_level) -->
|
|
| Attribute | Type | Description | Examples | Stability |
|
|
|---|---|---|---|---|
|
|
| `net.host.name` | string | Deprecated, use `server.address`. | `example.com` | <br>Replaced by `server.address`. |
|
|
| `net.host.port` | int | Deprecated, use `server.port`. | `8080` | <br>Replaced by `server.port`. |
|
|
| `net.peer.name` | string | Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` | <br>Replaced by `server.address` on client spans and `client.address` on server spans. |
|
|
| `net.peer.port` | int | Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` | <br>Replaced by `server.port` on client spans and `client.port` on server spans. |
|
|
| `net.protocol.name` | string | Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` | <br>Replaced by `network.protocol.name`. |
|
|
| `net.protocol.version` | string | Deprecated, use `network.protocol.version`. | `3.1.1` | <br>Replaced by `network.protocol.version`. |
|
|
| `net.sock.family` | string | Deprecated, use `network.transport` and `network.type`. | `inet` | <br>Split to `network.transport` and `network.type`. |
|
|
| `net.sock.host.addr` | string | Deprecated, use `network.local.address`. | `/var/my.sock` | <br>Replaced by `network.local.address`. |
|
|
| `net.sock.host.port` | int | Deprecated, use `network.local.port`. | `8080` | <br>Replaced by `network.local.port`. |
|
|
| `net.sock.peer.addr` | string | Deprecated, use `network.peer.address`. | `192.168.0.1` | <br>Replaced by `network.peer.address`. |
|
|
| `net.sock.peer.name` | string | Deprecated, no replacement at this time. | `/var/my.sock` | <br>Removed. |
|
|
| `net.sock.peer.port` | int | Deprecated, use `network.peer.port`. | `65531` | <br>Replaced by `network.peer.port`. |
|
|
| `net.transport` | string | Deprecated, use `network.transport`. | `ip_tcp` | <br>Replaced by `network.transport`. |
|
|
|
|
`net.sock.family` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `inet` | IPv4 address |  |
|
|
| `inet6` | IPv6 address |  |
|
|
| `unix` | Unix domain socket path |  |
|
|
|
|
`net.transport` 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.
|
|
|
|
| Value | Description | Stability |
|
|
|---|---|---|
|
|
| `ip_tcp` | ip_tcp |  |
|
|
| `ip_udp` | ip_udp |  |
|
|
| `pipe` | Named or anonymous pipe. |  |
|
|
| `inproc` | In-process communication. [1] |  |
|
|
| `other` | Something else (non IP-based). |  |
|
|
|
|
**[1]:** Signals that there is only in-process communication not using a "real" network protocol in cases where network attributes would normally be expected. Usually all other network attributes can be left out in that case.
|
|
<!-- endsemconv -->
|