Network

as of v1.44.0

Addresses, ports, transports and TLS — the connection every client and server span sits on.

tls 29 network 17 net 15 geo 7 client 2 destination 2 dns 2 server 2 source 2 peer 1

attributes: 79
metrics: 1
signals: 0
stable: 12
deprecated: 17

Metrics 1

dns.lookup.duration
Developmenthistogram · sMeasures the time taken to perform a DNS lookup.

Specification

Metricsare bound by the metrics specification — 548 requirements across 8 documents, 279 of them MUST or SHALL.

The specification prose never names this domain. That is not an omission: the specification defines signals, not subject matter — what binds tls telemetry is the general rules above, and the conventions themselves carry the rest.

On the wire, this lands in metrics/v1/metrics. Field-by-field definitions are under OTLP.

Attributes 79

tls29 attributes

tls.cipher
DevelopmentString indicating the cipher used during the current connection.
tls.client.certificate
DevelopmentPEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of client.certificate_chain since this value also exists in that l
tls.client.certificate_chain
DevelopmentArray of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of client.certificate since that
tls.client.hash.md5
DevelopmentCertificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value sho
tls.client.hash.sha1
DevelopmentCertificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value sh
tls.client.hash.sha256
DevelopmentCertificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value
tls.client.issuer
DevelopmentDistinguished name of subject of the issuer of the x.509 certificate presented by the client.
tls.client.ja3
DevelopmentA hash that identifies clients based on how they perform an SSL/TLS handshake.
tls.client.not_after
DevelopmentDate/Time indicating when client certificate is no longer considered valid.
tls.client.not_before
DevelopmentDate/Time indicating when client certificate is first considered valid.
tls.client.server_name
Deprecated→ server.addressDeprecated, use server.address instead.
tls.client.subject
DevelopmentDistinguished name of subject of the x.509 certificate presented by the client.
tls.client.supported_ciphers
DevelopmentArray of ciphers offered by the client during the client hello.
tls.curve
DevelopmentString indicating the curve used for the given cipher, when applicable
tls.established
DevelopmentBoolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel.
tls.next_protocol
DevelopmentString indicating the protocol being tunneled. Per the values in the IANA registry, this string should be lower case.
tls.protocol.name
DevelopmentNormalized lowercase protocol name parsed from original string of the negotiated SSL/TLS protocol version
tls.protocol.version
DevelopmentNumeric part of the version parsed from the original string of the negotiated SSL/TLS protocol version
tls.resumed
DevelopmentBoolean flag indicating if this TLS connection was resumed from an existing TLS negotiation.
tls.server.certificate
DevelopmentPEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of server.certificate_chain since this value also exists in that l
tls.server.certificate_chain
DevelopmentArray of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of server.certificate since that
tls.server.hash.md5
DevelopmentCertificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value sho
tls.server.hash.sha1
DevelopmentCertificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value sh
tls.server.hash.sha256
DevelopmentCertificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value
tls.server.issuer
DevelopmentDistinguished name of subject of the issuer of the x.509 certificate presented by the client.
tls.server.ja3s
DevelopmentA hash that identifies servers based on how they perform an SSL/TLS handshake.
tls.server.not_after
DevelopmentDate/Time indicating when server certificate is no longer considered valid.
tls.server.not_before
DevelopmentDate/Time indicating when server certificate is first considered valid.
tls.server.subject
DevelopmentDistinguished name of subject of the x.509 certificate presented by the server.

network17 attributes

network.carrier.icc
DevelopmentThe ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network.
network.carrier.mcc
DevelopmentThe mobile carrier country code.
network.carrier.mnc
DevelopmentThe mobile carrier network code.
network.carrier.name
DevelopmentThe name of the mobile carrier.
network.connection.state
DevelopmentThe state of network connection
network.connection.subtype
DevelopmentThis 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
network.connection.type
DevelopmentThe internet connection type.
network.interface.name
Release candidateThe network interface name.
network.io.direction
Release candidateThe direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical dire
network.local.address
StableLocal address of the network connection - IP address or UNIX domain socket name.
network.local.port
StableLocal port number of the network connection.
network.peer.address
StablePeer address of the network connection - IP address or UNIX domain socket name.
network.peer.port
StablePeer port number of the network connection.
network.protocol.name
StableOSI application layer or non-OSI equivalent.
network.protocol.version
StableThe actual version of the protocol used for network communication.
network.transport
StableOSI transport layer or inter-process communication method.
network.type
StableOSI network layer or non-OSI equivalent.

net15 attributes

net.host.ip
Deprecated→ network.local.addressDeprecated, use network.local.address.
net.host.name
Deprecated→ server.addressDeprecated, use server.address.
net.host.port
Deprecated→ server.portDeprecated, use server.port.
net.peer.ip
Deprecated→ network.peer.addressDeprecated, use network.peer.address.
net.peer.name
DeprecatedDeprecated, use server.address on client spans and client.address on server spans.
net.peer.port
DeprecatedDeprecated, use server.port on client spans and client.port on server spans.
net.protocol.name
Deprecated→ network.protocol.nameDeprecated, use network.protocol.name.
net.protocol.version
Deprecated→ network.protocol.versionDeprecated, use network.protocol.version.
net.sock.family
DeprecatedDeprecated, use network.transport and network.type.
net.sock.host.addr
Deprecated→ network.local.addressDeprecated, use network.local.address.
net.sock.host.port
Deprecated→ network.local.portDeprecated, use network.local.port.
net.sock.peer.addr
Deprecated→ network.peer.addressDeprecated, use network.peer.address.
net.sock.peer.name
DeprecatedDeprecated, no replacement at this time.
net.sock.peer.port
Deprecated→ network.peer.portDeprecated, use network.peer.port.
net.transport
Deprecated→ network.transportDeprecated, use network.transport.

geo7 attributes

geo.continent.code
DevelopmentTwo-letter code representing continent’s name.
geo.country.iso_code
DevelopmentTwo-letter ISO Country Code (ISO 3166-1 alpha2).
geo.locality.name
DevelopmentLocality name. Represents the name of a city, town, village, or similar populated place.
geo.location.lat
DevelopmentLatitude of the geo location in WGS84.
geo.location.lon
DevelopmentLongitude of the geo location in WGS84.
geo.postal_code
DevelopmentPostal code associated with the location. Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to cou
geo.region.iso_code
DevelopmentRegion ISO code (ISO 3166-2).

client2 attributes

client.address
StableClient address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
client.port
StableClient port number.

destination2 attributes

destination.address
DevelopmentDestination address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
destination.port
DevelopmentDestination port number

dns2 attributes

dns.answers
DevelopmentThe list of IPv4 or IPv6 addresses resolved during DNS lookup.
dns.question.name
DevelopmentThe name being queried.

server2 attributes

server.address
StableServer domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
server.port
StableServer port number.

source2 attributes

source.address
DevelopmentSource address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
source.port
DevelopmentSource port number

peer1 attributes

peer.service
Deprecated→ service.peer.nameThe service.name of the remote service. SHOULD be equal to the actual service.name resource attribute of the remote service if any.

Recent changes

Breaking and notable changes to this domain across the last 6 semantic-conventions releases.

stabilityattributenetwork.interface.namePromoted to release_candidate.
stabilityattributenetwork.io.directionPromoted to release_candidate.

Topics are this site's grouping of upstream namespaces, not a structure the OpenTelemetry project publishes. JSON · All domains