DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
FREEDOM251

Freedom251 › Blog › distributed tracing

How to Connect OpenTelemetry to Instana for Traces, Metrics, and Logs

By Freedom251 Team · · 5 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can send OpenTelemetry traces, metrics, and logs to IBM Instana through an Instana agent, an OpenTelemetry Collector, or directly to the Instana backend. The Collector is optional: use it when you need to collect from multiple sources or process and filter telemetry before forwarding it. For reliable results, plan host identity and W3C trace-context propagation alongside the data route.

What OpenTelemetry and Instana do together

OpenTelemetry provides instrumentation and a standard way to collect and export telemetry; Instana receives and analyzes that data. IBM documents traces, metrics, and logs as generally available in Instana. It also supports combining OpenTelemetry spans with Instana AutoTrace spans for continuous mixed tracing (IBM’s OpenTelemetry overview).

As an Amazon Associate I earn from qualifying purchases.

This is not an automatic guarantee of complete observability. The signals still need to reach the correct destination, carry usable service and host identity, and—when traces cross between OpenTelemetry-instrumented and Instana-traced services—propagate compatible context.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose an ingestion route

The right route depends on where you want processing, routing, credentials, and operational responsibility to live.

Route When it fits What to plan for
Application to an Instana agent The application already emits OTLP and a nearby agent can receive it. Configure the agent endpoint and confirm OTLP ingestion is enabled. The agent forwards data to the backend.
Application or receivers through a Collector to an agent You need to gather from multiple sources or apply Collector processors before forwarding locally. Operate and configure the Collector as well as the agent. Place processors and filtering where they can serve the relevant sources.
Application or Collector directly to the Instana backend You want OTLP delivery without routing through a host agent. Configure the deployment’s regional endpoint, agent key, TLS, and required host or entity identity.
Instana Distribution of OpenTelemetry Collector (IDOT) You want IBM’s Collector distribution with Instana-oriented mappings and correlation settings. IBM says IDOT handles service mappings and infrastructure correlation by default. With a self-configured sender, you may need to set resource attributes explicitly.

IBM describes the Collector as optional when an application already emits OTLP and no additional middle-stage processing is needed. The IBM ingestion-method guidance covers the available routes.

Send OTLP through an Instana agent

An Instana agent can receive OTLP traces, metrics, and logs, then forward them to the backend. IBM documents default listener ports of 4317 for OTLP/gRPC and 4318 for OTLP/HTTP or HTTPS. The endpoint and protocol must match the exporter configuration.

Agent behavior is version-sensitive: IBM says OTLP ingestion defaults to activated for host-agent version 1.1.726 or higher; earlier versions had it deactivated by default. Check the actual agent configuration rather than assuming the default applies to every installation. See IBM’s agent ingestion instructions.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a Collector forwarding to an agent, IBM’s examples use the OTLP exporter with endpoint: localhost:4317 for gRPC, or the OTLP/HTTP exporter with endpoint: http://localhost:4318. Treat these as local, plaintext example endpoints—not a production security recommendation. Use TLS where the connection crosses a trust boundary, and configure the exporter and receiver consistently.

Send OTLP directly to the backend

The backend’s otlp-acceptor can receive OTLP directly from an application or a Collector. This avoids the agent as an ingestion hop, but shifts responsibility for endpoint selection, credentials, transport security, and identity to the sender configuration.

  1. Identify the Instana region. Use the region associated with your Instana deployment; there is no single endpoint to assume for all customers.
  2. Configure authentication. Set the x-instana-key agent key in the exporter configuration and protect it as a credential.
  3. Use TLS. Configure the transport for the endpoint and deployment; do not carry a plaintext example into a production connection.
  4. Provide resource identity. Include one of host.id, faas.id, or device.id, or use the documented x-instana-host alternative.
  5. Verify the received entity. Check that telemetry is associated with the intended host or entity and that traces and metrics appear under the expected service.

IBM’s backend ingestion guide describes the regional destination and configuration requirements. It says IDOT configures the required endpoints, authentication keys, resource attributes, and TLS settings; those using a manually configured Collector must handle the relevant settings themselves.

Preserve trace continuity across services

Instana correlates OpenTelemetry traces with Instana-generated traces using W3C Trace Context, which is also OpenTelemetry’s default propagation format. If a request passes between OpenTelemetry-instrumented and Instana-traced services, check that trace context survives each boundary. IBM documents a limitation: the Instana default context propagator cannot be combined with propagators other than W3C Trace Context.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Validate this in the actual request path: follow a request across an OpenTelemetry service and an Instana AutoTrace service, then confirm the spans share the expected trace. A span that arrives without the propagated context may be visible but not connected to the surrounding trace. IBM also documents support for commonly used trace and resource semantic-convention attributes, as well as span events and span links. See IBM’s tracing documentation.

Keep attributes useful and bounded

Instana represents OpenTelemetry attributes as dynamic or static tags. Dynamic tags are derived from incoming attributes and appear in the call tag catalog; IBM documents a limit of 500 different attribute names in that catalog. Static tags can be used for filtering and grouping by an OpenTelemetry tag or resource-tag key and are not subject to that catalog limit.

Keep attribute keys stable and put changing values in the value, not in a newly generated key. For example, use a single user.id key with different user values rather than creating a distinct attribute name per user. This avoids exhausting the dynamic-tag name catalog and makes queries and groupings more predictable.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Ingest logs without losing useful context

IBM documents two OTLP log routes: send logs to the backend’s otlp-acceptor, directly or through a Collector, or send them through an Instana agent. Log ingestion may require an add-on or extra configuration, so confirm entitlement and setup for your specific Instana plan with IBM. The log sender must also identify the host or entity. IBM lists resource identity options including service.instance.id, container.id, Kubernetes object IDs, and host.id, along with the x-instana-host alternative. See IBM’s log ingestion documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What Instana maps from an OTLP log record

  • Trace ID, span ID, and body are mapped without alteration.
  • Instana uses ingestion time for the timestamp it considers.
  • Log level is determined primarily from SeverityText, with SeverityNumber as a fallback.
  • Attributes are mapped as key-value custom tags.

These mapping rules can explain differences between a source record and its representation in Instana. For example, the displayed time may reflect ingestion rather than the timestamp your application recorded.

Prevent avoidable log volume and attribution problems

  • Use a consistent structure for timestamps, levels, error codes, and contextual fields.
  • Send essential logs rather than every available message; excess volume increases processing, memory, network, retention, and analysis load.
  • Where possible, configure a Collector to send logs to an agent on the same host. IBM warns that routing logs from multiple hosts through one agent can cause incorrect host attribution and failed correlation.

IBM’s log best-practices guidance explains these operational recommendations.

Check compatibility and exporter guidance before rollout

Use an OTLP exporter for Instana ingestion. IBM says its OpenTelemetry Contrib Collector instanaexporter was removed on 8 October 2024; do not build a new setup around that exporter. The host-agent threshold of 1.1.726 concerns the agent’s default OTLP activation, not a general compatibility promise for every SDK or Collector version.

IBM’s documentation does not establish one cross-language SDK and Collector compatibility matrix for every deployment in the material cited here. Confirm supported versions and configuration for the language, Collector distribution, agent, and Instana environment you actually run.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

distributed tracingIBM InstanaobservabilityOpenTelemetryOpenTelemetry CollectorOTLPtelemetry logs

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.