Loading

Field & Attributes Alignment

The following table gives an overview of mappings between individual ECS fields (in ECS version 9.1.0-dev) and corresponding OTel semantic convention attributes (in SemConv version 1.29.0).

ECS Field Relation OTel Semantic Conventions Attribute Stability
Base Fields
@timestamp relation time_unix_nano
stable
relation observed_time_unix_nano
stable
relation start_time_unix_nano

Note: On logs, events and metrics, time_unix_nano defines the time of the event. For logs, observed_time_unix_nano defines the time when the event was observed by the collection system. On spans, start_time_unix_nano represents the start time of the span.
stable
labels relation k8s.pod.label
experimental
relation container.label
experimental
message relation body

Note: The body in OTLP is of type Any and can be either an unstructured log message or a structured event.
stable
Client Fields
client.address relation client.address
stable
client.port relation client.port
stable
Cloud Fields
cloud.account.id relation cloud.account.id
experimental
cloud.availability_zone relation cloud.availability_zone
experimental
cloud.provider relation cloud.provider
experimental
cloud.region relation cloud.region
experimental
cloud.service.name relation cloud.platform
experimental
Container Fields
container.cpu.usage relation container.cpu.usage
experimental
container.id relation container.id
experimental
container.image.hash.all relation container.image.repo_digests
experimental
container.image.name relation container.image.name
experimental
container.image.tag relation container.image.tags
experimental
container.labels relation container.label
experimental
container.memory.usage relation container.memory.usage
experimental
container.name relation container.name
experimental
container.runtime relation container.runtime
experimental
Data Stream Fields
data_stream.dataset [beta] relation Not applicable.
data_stream.namespace [beta] relation Not applicable.
data_stream.type [beta] relation Not applicable.
Destination Fields
destination.address relation destination.address
experimental
destination.port relation destination.port
experimental
Device Fields
device.id [beta] relation device.id
experimental
device.manufacturer [beta] relation device.manufacturer
experimental
device.model.identifier [beta] relation device.model.identifier
experimental
device.model.name [beta] relation device.model.name
experimental
DNS Fields
dns.question.name relation dns.question.name
experimental
ECS Fields
ecs.version relation Not applicable.
Error Fields
error.message relation exception.message
stable
error.stack_trace relation exception.stacktrace
stable
error.type relation error.type
stable
FaaS Fields
faas.coldstart [beta] relation faas.coldstart
experimental
faas.execution [beta] relation faas.invocation_id
experimental
faas.name [beta] relation faas.name
experimental
faas.trigger.type [beta] relation faas.trigger
experimental
faas.version [beta] relation faas.version
experimental
File Fields
file.accessed relation file.accessed
experimental
file.attributes relation file.attributes
experimental
file.created relation file.created
experimental
file.ctime relation file.changed
experimental
file.directory relation file.directory
experimental
file.extension relation file.extension
experimental
file.fork_name relation file.fork_name
experimental
file.gid relation file.group.id
experimental
file.group relation file.group.name
experimental
file.inode relation file.inode
experimental
file.mode relation file.mode
experimental
file.mtime relation file.modified
experimental
file.name relation file.name
experimental
file.owner relation file.owner.name
experimental
file.path relation file.path
experimental
file.size relation file.size
experimental
file.target_path relation file.symbolic_link.target_path
experimental
file.uid relation file.owner.id
experimental
Geo Fields
geo.city_name relation geo.locality.name
experimental
geo.continent_code relation geo.continent.code
experimental
geo.country_iso_code relation geo.country.iso_code
experimental
geo.location relation geo.location.lat
experimental
relation geo.location.lon
experimental
geo.postal_code relation geo.postal_code
experimental
geo.region_iso_code relation geo.region.iso_code
experimental
Host Fields
host.architecture relation host.arch
experimental
host.cpu.usage relation system.cpu.utilization
experimental
host.disk.read.bytes relation system.disk.io
experimental
host.disk.write.bytes relation system.disk.io
experimental
host.id relation host.id
experimental
host.ip relation host.ip
experimental
host.mac relation host.mac
experimental
host.name relation host.name
experimental
host.network.egress.bytes relation system.network.io
experimental
host.network.egress.packets relation system.network.packets
experimental
host.network.ingress.bytes relation system.network.io
experimental
host.network.ingress.packets relation system.network.packets
experimental
host.type relation host.type
experimental
host.uptime relation system.uptime
experimental
HTTP Fields
http.request.body.bytes relation http.request.body.size
experimental
http.request.bytes relation http.request.size
experimental
http.request.method relation http.request.method_original
stable
relation http.request.method

Note: http.request.method in SemConv is the known, normalized, upper case value of the request method, other than the ECS' http.request.method that retains casing from the original event.
stable
http.response.body.bytes relation http.response.body.size
experimental
http.response.bytes relation http.response.size
experimental
http.response.status_code relation http.response.status_code
stable
http.version relation network.protocol.name
stable
relation network.protocol.version

Note: In OTel SemConv, network.protocol.version specifies the HTTP version if the value of network.protocol.name is http.
stable
Log Fields
log.file.path relation log.file.path
experimental
log.level relation severity_text
stable
Network Fields
network.protocol relation network.protocol.name
stable
network.transport relation network.transport
stable
network.type relation network.type
stable
Operating System Fields
os.full relation os.description
experimental
os.name relation os.name
experimental
os.type relation os.type

Note: The expected values in ECS for os.type do not correspond with the values defined in semantic conventions!
experimental
os.version relation os.version
experimental
Process Fields
process.args relation process.command_args
experimental
process.args_count relation process.args_count
experimental
process.command_line relation process.command_line
experimental
process.executable relation process.executable.path
experimental
process.real_user.id relation process.real_user.id
experimental
process.saved_user.id relation process.saved_user.id
experimental
process.user.id relation process.user.id
experimental
process.interactive relation process.interactive
experimental
process.real_user.name relation process.real_user.name
experimental
process.saved_user.name relation process.saved_user.name
experimental
process.user.name relation process.user.name
experimental
process.group_leader.pid relation process.group_leader.pid
experimental
process.pid relation process.pid
experimental
process.session_leader.pid relation process.session_leader.pid
experimental
process.title relation process.title
experimental
process.uptime relation process.uptime
experimental
process.vpid relation process.vpid
experimental
process.working_directory relation process.working_directory
experimental
Related Fields
related.hash relation Not applicable.
related.hosts relation Not applicable.
related.ip relation Not applicable.
related.user relation Not applicable.
Server Fields
server.address relation server.address
stable
server.port relation server.port
stable
Service Fields
service.environment [beta] relation deployment.environment.name
experimental
service.name relation service.name
stable
service.node.name relation service.instance.id
experimental
service.version relation service.version
stable
Source Fields
source.address relation source.address
experimental
source.port relation source.port
experimental
TLS Fields
tls.cipher relation tls.cipher
experimental
tls.client.certificate relation tls.client.certificate
experimental
tls.client.certificate_chain relation tls.client.certificate_chain
experimental
tls.client.hash.md5 relation tls.client.hash.md5
experimental
tls.client.hash.sha1 relation tls.client.hash.sha1
experimental
tls.client.hash.sha256 relation tls.client.hash.sha256
experimental
tls.client.issuer relation tls.client.issuer
experimental
tls.client.ja3 relation tls.client.ja3
experimental
tls.client.not_after relation tls.client.not_after
experimental
tls.client.not_before relation tls.client.not_before
experimental
tls.client.subject relation tls.client.subject
experimental
tls.client.supported_ciphers relation tls.client.supported_ciphers
experimental
tls.curve relation tls.curve
experimental
tls.established relation tls.established
experimental
tls.next_protocol relation tls.next_protocol
experimental
tls.resumed relation tls.resumed
experimental
tls.server.certificate relation tls.server.certificate
experimental
tls.server.certificate_chain relation tls.server.certificate_chain
experimental
tls.server.hash.md5 relation tls.server.hash.md5
experimental
tls.server.hash.sha1 relation tls.server.hash.sha1
experimental
tls.server.hash.sha256 relation tls.server.hash.sha256
experimental
tls.server.issuer relation tls.server.issuer
experimental
tls.server.ja3s relation tls.server.ja3s
experimental
tls.server.not_after relation tls.server.not_after
experimental
tls.server.not_before relation tls.server.not_before
experimental
tls.server.subject relation tls.server.subject
experimental
Tracing Fields
span.id relation span_id
stable
trace.id relation trace_id
stable
transaction.id relation Not applicable.
URL Fields
url.domain relation url.domain
experimental
url.extension relation url.extension
experimental
url.fragment relation url.fragment
stable
url.full relation url.full
stable
url.original relation url.original
experimental
url.path relation url.path
stable
url.port relation url.port
experimental
url.query relation url.query
stable
url.registered_domain relation url.registered_domain
experimental
url.scheme relation url.scheme
stable
url.subdomain relation url.subdomain
experimental
url.top_level_domain relation url.top_level_domain
experimental
User Fields
user.email relation user.email
experimental
user.full_name relation user.full_name
experimental
user.hash relation user.hash
experimental
user.id relation user.id
experimental
user.name relation user.name
experimental
user.roles relation user.roles
experimental
User agent Fields
user_agent.name relation user_agent.name
experimental
user_agent.original relation user_agent.original
stable
user_agent.version relation user_agent.version
experimental