OpenTelemetry PHP

ServerIncubatingAttributes

Semantic attributes and corresponding values for server.

Tags
see
https://opentelemetry.io/docs/specs/semconv/registry/attributes/server/

May contain @experimental Semantic Conventions which may change or be removed in the future.

Table of Contents

Constants

SERVER_ADDRESS  : mixed = 'server.address'
Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
SERVER_AS_NUMBER  : mixed = 'server.as.number'
The [Autonomous System Number (ASN)](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml) associated with the server IP address.
SERVER_AS_ORGANIZATION  : mixed = 'server.as.organization'
The name of the organization associated with the autonomous system of the server IP address.
SERVER_MAC_ADDRESS  : mixed = 'server.mac.address'
Server Media Access Control (MAC) address.
SERVER_PORT  : mixed = 'server.port'
Server port number.
SERVER_PREFIX  : mixed = 'server.prefix'
The IP prefix associated with the server IP address, in CIDR notation.
SERVER_SERVICE_NAME  : mixed = 'server.service.name'
Logical name of the service acting as the server in a connection-based network interaction.
SERVER_SERVICE_NAMESPACE  : mixed = 'server.service.namespace'
Logical namespace of the service acting as the server in a connection-based network interaction.

Constants

SERVER_ADDRESS

Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.

public mixed SERVER_ADDRESS = 'server.address'

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.

Tags
stable

SERVER_AS_NUMBER

The [Autonomous System Number (ASN)](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml) associated with the server IP address.

public mixed SERVER_AS_NUMBER = 'server.as.number'

This attribute SHOULD only be set when the server address is an IP address and the ASN is available from routing, enrichment, or lookup data. The value SHOULD be represented as an integer without the AS prefix.

Tags
experimental

SERVER_AS_ORGANIZATION

The name of the organization associated with the autonomous system of the server IP address.

public mixed SERVER_AS_ORGANIZATION = 'server.as.organization'

This attribute SHOULD only be set when server.as.number is set and the organization name is available. The value SHOULD be the organization name as provided by the lookup or enrichment source, not the AS name or short code.

Tags
experimental

SERVER_MAC_ADDRESS

Server Media Access Control (MAC) address.

public mixed SERVER_MAC_ADDRESS = 'server.mac.address'

This attribute MUST identify a MAC address associated with the logical server endpoint, including when that endpoint is behind intermediaries. If the server's MAC address is unknown, this attribute MUST NOT be set. The MAC address of a proxy, gateway, or next-hop router MUST NOT be used as a substitute.

MAC addresses MUST be represented in IEEE RA hexadecimal form: as hyphen-separated octets in uppercase hexadecimal form from most to least significant.

[!WARNING]> This attribute may contain sensitive (PII) information.

Tags
experimental

SERVER_PORT

Server port number.

public mixed SERVER_PORT = 'server.port'

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.

Tags
stable

SERVER_PREFIX

The IP prefix associated with the server IP address, in CIDR notation.

public mixed SERVER_PREFIX = 'server.prefix'

[!WARNING]> This attribute may contain sensitive (PII) information. A /32> IPv4 prefix or /128> IPv6 prefix preserves the complete endpoint IP address. Using CIDR notation does not guarantee that the data is anonymous.

The value MUST be an IPv4 or IPv6 network prefix in CIDR notation, as defined in RFC 4632 for IPv4 and RFC 4291 for IPv6. IPv4 prefixes MUST use a dotted-decimal address followed by / and a decimal prefix length from 0 to 32. IPv6 prefixes MUST use the canonical address text representation defined in RFC 5952, followed by / and a decimal prefix length from 0 to 128. All host bits in the address MUST be set to zero. The value MUST NOT contain a domain name, UNIX domain socket name, or IPv6 zone identifier.

Instrumentation or Collector receivers that populate this attribute MUST convert native representations, such as an address and subnet mask or an address and prefix length, to equivalent CIDR notation before emitting it.

This attribute MUST NOT be set unless server.address is set to an IPv4 or IPv6 address. The address MUST use the same IP version as this prefix and be contained in it.

Tags
experimental

SERVER_SERVICE_NAME

Logical name of the service acting as the server in a connection-based network interaction.

public mixed SERVER_SERVICE_NAME = 'server.service.name'

SHOULD be equal to the actual service.name resource attribute of the logical server, if any. This identifies the server service whether the telemetry is recorded by the client, the server, or another observer.

Tags
experimental

SERVER_SERVICE_NAMESPACE

Logical namespace of the service acting as the server in a connection-based network interaction.

public mixed SERVER_SERVICE_NAMESPACE = 'server.service.namespace'

SHOULD be equal to the actual service.namespace resource attribute of the logical server, if any. This identifies the server service's namespace whether the telemetry is recorded by the client, the server, or another observer. Together with server.service.name, this identifies the server service. An empty namespace is equivalent to an unspecified namespace.

Tags
experimental
On this page

Search results