# @opentelemetry/otlp-exporter-base

> OpenTelemetry OTLP Exporter base (for internal use only)

Latest version **0.222.0** (published 2026-08-31) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @opentelemetry/otlp-exporter-base
pnpm add @opentelemetry/otlp-exporter-base
yarn add @opentelemetry/otlp-exporter-base
bun add @opentelemetry/otlp-exporter-base
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.222.0 |
| Published | 2026-08-31 |
| First published | 2022-04-22 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^18.19.0 \|\| >=20.6.0 |
| Dependencies | 2 |
| Unpacked size | 632.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 3473 |
| Author | OpenTelemetry Authors |
| Maintainers | dyladan, pichlermarc, overbalance, npmjs-account, trentm, martinkuba |
| Keywords | opentelemetry, nodejs, tracing, profiling, metrics, stats, monitoring |

## Links

- npm: https://www.npmjs.com/package/@opentelemetry/otlp-exporter-base
- Repository: https://github.com/open-telemetry/opentelemetry-js
- Homepage: https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/otlp-exporter-base
- Issues: https://github.com/open-telemetry/opentelemetry-js/issues
- npm.io page: https://npm.io/package/@opentelemetry/otlp-exporter-base

## Dependencies (2)

- [@opentelemetry/core](https://npm.io/package/@opentelemetry/core.md) 2.11.0
- [@opentelemetry/otlp-transformer](https://npm.io/package/@opentelemetry/otlp-transformer.md) 0.222.0

## Recent versions

- 0.222.0 (latest) — 2026-08-31
- 0.222.0-development.0 (canary) — 2026-08-31
- 0.34.0 (next) — 2022-11-09
- 0.221.0 — 2026-07-21
- 0.220.0 — 2026-07-02
- 0.219.0 — 2026-06-11
- 0.218.0 — 2026-05-13
- 0.217.0 — 2026-05-06
- 0.216.0 — 2026-04-29
- 0.215.0 — 2026-04-17
- 0.214.0 — 2026-03-25
- 0.213.0 — 2026-03-03
- 0.212.0 — 2026-02-12
- 0.211.0 — 2026-01-21
- 0.210.0 — 2026-01-14
- … 58 more at https://npm.io/package/@opentelemetry/otlp-exporter-base/versions

## README

# OpenTelemetry Collector Exporter for web and node

[![NPM Published Version][npm-img]][npm-url]
[![Apache License][license-image]][license-image]

**Note: This package is intended for internal use only.**

**Note: This is an experimental package under active development. New releases may include breaking changes.**

This module provides base components for OTLP Exporters, both Web and Node.js.

## Installation

```bash
npm install --save @opentelemetry/otlp-exporter-base
```

## HTTP exporter configuration

HTTP JSON and HTTP/protobuf exporters for traces, metrics, and logs share these configuration options.
Node.js exporters accept `OTLPExporterNodeConfigBase`, which also includes the options from `OTLPExporterConfigBase`.
Configuration precedence is: programmatic options, then per-signal environment variables, then general environment variables, then built-in defaults.

| Option             | Type                                                          | Default                                             | Description                                                                                                                              |
| ------------------ | ------------------------------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | `string`                                                      | `undefined` (default resolved per precedence above) | Collector endpoint URL.                                                                                                                  |
| `headers`          | `Record<string, string> \| HeadersFactory`                    | `undefined`                                         | Custom HTTP headers. A factory function may be async and must not throw. Exporters still apply required transport headers.               |
| `concurrencyLimit` | `number`                                                      | `30`                                                | Maximum number of in-flight export requests.                                                                                             |
| `timeoutMillis`    | `number`                                                      | `10000`                                             | Maximum time, in milliseconds, to wait for each batch export.                                                                            |
| `compression`      | `CompressionAlgorithm.NONE \| CompressionAlgorithm.GZIP`      | `CompressionAlgorithm.NONE`                         | Compression for outgoing OTLP HTTP requests in Node.js.                                                                                  |
| `keepAlive`        | `boolean`                                                     | `true`                                              | Sets `keepAlive` on the Node.js HTTP or HTTPS agent created by the exporter. A `keepAlive` value in `httpAgentOptions` takes precedence. |
| `httpAgentOptions` | `http.AgentOptions \| https.AgentOptions \| HttpAgentFactory` | Agent options with `keepAlive: true`                | Custom Node.js HTTP or HTTPS agent options, or a factory function that receives the request protocol and returns an agent.               |
| `userAgent`        | `string`                                                      | The exporter's default user agent                   | Prefix to add to the exporter's default `User-Agent` header in Node.js.                                                                  |

| Option                  | General environment variable            | Signal-specific environment variables                                                                                    |
| ----------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `url`                   | `OTEL_EXPORTER_OTLP_ENDPOINT`           | `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`, `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`          |
| `headers`               | `OTEL_EXPORTER_OTLP_HEADERS`            | `OTEL_EXPORTER_OTLP_TRACES_HEADERS`, `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, `OTEL_EXPORTER_OTLP_LOGS_HEADERS`             |
| `timeoutMillis`         | `OTEL_EXPORTER_OTLP_TIMEOUT`            | `OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`, `OTEL_EXPORTER_OTLP_METRICS_TIMEOUT`, `OTEL_EXPORTER_OTLP_LOGS_TIMEOUT`             |
| `compression`           | `OTEL_EXPORTER_OTLP_COMPRESSION`        | `OTEL_EXPORTER_OTLP_TRACES_COMPRESSION`, `OTEL_EXPORTER_OTLP_METRICS_COMPRESSION`, `OTEL_EXPORTER_OTLP_LOGS_COMPRESSION` |
| `concurrencyLimit`      | Not supported                           | Not supported                                                                                                            |
| `keepAlive`             | Not supported                           | Not supported                                                                                                            |
| `httpAgentOptions.ca`   | `OTEL_EXPORTER_OTLP_CERTIFICATE`        | `OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_CERTIFICATE`                                                                   |
| `httpAgentOptions.cert` | `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE` | `OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_CLIENT_CERTIFICATE`                                                            |
| `httpAgentOptions.key`  | `OTEL_EXPORTER_OTLP_CLIENT_KEY`         | `OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_CLIENT_KEY`                                                                    |
| `userAgent`             | Not supported                           | Not supported                                                                                                            |

## GRPC

For GRPC please check [npm-url-grpc]

## Useful links

- For more information on OpenTelemetry, visit: <https://opentelemetry.io/>
- For more about OpenTelemetry JavaScript: <https://github.com/open-telemetry/opentelemetry-js>
- For help or feedback on this project, join us in [GitHub Discussions][discussions-url]

## License

Apache 2.0 - See [LICENSE][license-url] for more information.

[discussions-url]: https://github.com/open-telemetry/opentelemetry-js/discussions
[license-url]: https://github.com/open-telemetry/opentelemetry-js/blob/main/LICENSE
[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat
[npm-url]: https://www.npmjs.com/package/@opentelemetry/otlp-exporter-base
[npm-url-grpc]: https://www.npmjs.com/package/@opentelemetry/otlp-grpc-exporter-base
[npm-img]: https://badge.fury.io/js/%40opentelemetry%2Fotlp-exporter-base.svg

---
_Source: https://npm.io/package/@opentelemetry/otlp-exporter-base · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
