Type to search.

Wired streams field naming

Serverless Preview

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Preview

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Serverless interfaces and procedures might differ from classic Elastic Stack deployments.

Stack Preview 9.2+

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Preview since 9.2

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

When data is ingested into a wired stream, field names are normalized depending on which endpoint you use. Understanding how fields are mapped helps you write accurate queries and processing rules.

Field naming depends on the endpoint you use.

Data ingested into the logs.ecs endpoint is stored in the original ECS field names without being transformed. The fields remain as shown in the "ECS field" column in the field naming table.

Data ingested into the logs.otel endpoint is stored in OTel format. ECS fields are translated to their OTel semantic convention equivalents, so data is consistently structured and OTTL-expressible.

When data is ingested into a wired stream, it's automatically translated into this normalized format:

  • Standard ECS documents are converted to OTel fields (message → body.text, log.level → severity_text, host.name → resource.attributes.host.name, and so on).
  • Custom fields are stored under attributes.*.

To preserve backward-compatible querying, Streams creates ECS field name aliases on the ingested data, so queries using ECS field names continue to work even though the data is stored in OTel format.

Refer to the field naming table for ECS fields and corresponding OTel fields.

Data ingested into the /logs endpoint is stored and processed in a normalized OpenTelemetry (OTel)–compatible format. This format aligns ECS fields with OTel semantic conventions so all data is consistently structured and OTTL-expressible.

Data ingested into a wired stream is automatically translated into this normalized format:

  • Streams converts standard ECS documents to OTel fields (message → body.text, log.level → severity_text, host.name → resource.attributes.host.name, and so on).
  • Streams stores custom fields under attributes.*.

To preserve backward-compatible querying, Streams creates ECS field name aliases on the ingested data, so queries using ECS field names continue to work even though the data is stored in OTel format.

Refer to the field naming table for ECS fields and corresponding OTel fields.

The following table lists ECS fields and their corresponding OTel fields.

ECS field OTel field
message body.text
log.level severity_text
span.id span_id
trace.id trace_id
host.name resource.attributes.host.name
host.ip resource.attributes.host.ip
custom_field attributes.custom_field