# @opentelemetry/exporter-logs-otlp-proto > An OTLP exporter to send logs using protobuf over HTTP Latest version **0.222.0** (published 2026-08-31) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @opentelemetry/exporter-logs-otlp-proto pnpm add @opentelemetry/exporter-logs-otlp-proto yarn add @opentelemetry/exporter-logs-otlp-proto bun add @opentelemetry/exporter-logs-otlp-proto ``` ## 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 | 2023-06-06 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | ^18.19.0 \|\| >=20.6.0 | | Dependencies | 3 | | Unpacked size | 55.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 3476 | | Author | OpenTelemetry Authors | | Maintainers | dyladan, pichlermarc, overbalance, npmjs-account, trentm, martinkuba | | Keywords | opentelemetry, nodejs, protobuf, tracing, profiling, metrics, stats, logs | ## Links - npm: https://www.npmjs.com/package/@opentelemetry/exporter-logs-otlp-proto - Repository: https://github.com/open-telemetry/opentelemetry-js - Homepage: https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/exporter-logs-otlp-proto - Issues: https://github.com/open-telemetry/opentelemetry-js/issues - npm.io page: https://npm.io/package/@opentelemetry/exporter-logs-otlp-proto ## Dependencies (3) - [@opentelemetry/sdk-logs](https://npm.io/package/@opentelemetry/sdk-logs.md) 0.222.0 - [@opentelemetry/otlp-transformer](https://npm.io/package/@opentelemetry/otlp-transformer.md) 0.222.0 - [@opentelemetry/otlp-exporter-base](https://npm.io/package/@opentelemetry/otlp-exporter-base.md) 0.222.0 ## Alternatives - [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads - [log](https://npm.io/package/log.md) — 1.3M weekly downloads - [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads - [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads - [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads ## Recent versions - 0.222.0 (latest) — 2026-08-31 - 0.300.0-development.0 (canary) — 2026-09-21 - 0.222.0-development.0 — 2026-08-31 - 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 - … 42 more at https://npm.io/package/@opentelemetry/exporter-logs-otlp-proto/versions ## README # An OTLP exporter to send logs using protobuf over HTTP [![NPM Published Version][npm-img]][npm-url] [![Apache License][license-image]][license-image] **Note: This is an experimental package under active development. New releases may include breaking changes.** This module provides a logs-exporter for OTLP (http/protobuf) using protocol version `v1.7.0`. ## Installation ```bash npm install --save @opentelemetry/exporter-logs-otlp-proto ``` ## Shared HTTP exporter options This exporter uses the shared HTTP options documented in [`@opentelemetry/otlp-exporter-base`][otlp-exporter-base-config]. That includes `url`, `headers`, `timeoutMillis`, `concurrencyLimit`, and Node.js options such as `compression`, `keepAlive`, `httpAgentOptions`, and `userAgent`. ## Further Documentation To see documentation and sample code for the traces exporter, as well as instructions for using TLS, see the [exporter-trace-otlp-proto package][trace-exporter-url]. To see documentation and sample code for the metric exporter, see the [opentelemetry-exporter-metrics-otlp-proto package][metrics-exporter-url]. ## Example Setup ```js const { LoggerProvider, SimpleLogRecordProcessor } = require('@opentelemetry/sdk-logs'); const { OTLPLogExporter } = require('@opentelemetry/exporter-logs-otlp-proto'); const collectorOptions = { url: '', // url is optional and can be omitted - default is http://localhost:4318/v1/logs headers: { foo: 'bar' }, //an optional object containing custom headers to be sent with each request will only work with http }; const logExporter = new OTLPLogExporter(collectorOptions); const logProvider = new LoggerProvider({ resource: resourceFromAttributes({'service.name': 'testApp'}), processors: [new SimpleLogRecordProcessor({ exporter: logExporter })] }); const logger = logProvider.getLogger('test_log_instrumentation'); logger.emit({ //log data to emit }) ``` ## Exporter Timeout Configuration The OTLPLogExporter has a timeout configuration option which is the maximum time, in milliseconds, the OTLP exporter will wait for each batch export. The default value is 10000ms. To override the default timeout duration, use the following options: - Set with environment variables: | Environment variable | Description | | --------------------------------- | -------------------------------------------------------------------------------------------------------------- | | `OTEL_EXPORTER_OTLP_LOGS_TIMEOUT` | The maximum waiting time, in milliseconds, allowed to send each OTLP trace batch. Default is 10000. | | `OTEL_EXPORTER_OTLP_TIMEOUT` | The maximum waiting time, in milliseconds, allowed to send each OTLP trace and metric batch. Default is 10000. | > `OTEL_EXPORTER_OTLP_LOGS_TIMEOUT` takes precedence and overrides `OTEL_EXPORTER_OTLP_TIMEOUT`. - Provide `timeoutMillis` to OTLPLogExporter with `collectorOptions`: ```js const collectorOptions = { timeoutMillis: 15000, url: '', // url is optional and can be omitted - default is http://localhost:4318/v1/logs headers: { foo: 'bar' }, //an optional object containing custom headers to be sent with each request will only work with http }; const exporter = new OTLPLogExporter(collectorOptions); ``` > Providing `timeoutMillis` with `collectorOptions` takes precedence and overrides timeout set with environment variables. ## OTLP Exporter Retry OTLP requires that transient errors be handled with a [retry strategy](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#retry). This retry policy has the following configuration, which there is currently no way to customize. - `DEFAULT_EXPORT_MAX_ATTEMPTS`: The maximum number of attempts, including the original request. Defaults to 5. - `DEFAULT_EXPORT_INITIAL_BACKOFF`: The initial backoff duration. Defaults to 1 second. - `DEFAULT_EXPORT_MAX_BACKOFF`: The maximum backoff duration. Defaults to 5 seconds. - `DEFAULT_EXPORT_BACKOFF_MULTIPLIER`: The backoff multiplier. Defaults to 1.5. This retry policy first checks if the response has a `'Retry-After'` header. If there is a `'Retry-After'` header, the exporter will wait the amount specified in the `'Retry-After'` header before retrying. If there is no `'Retry-After'` header, the exporter will use an exponential backoff with jitter retry strategy. > The exporter will retry exporting within the [exporter timeout configuration](#exporter-timeout-configuration) time. ## Useful links - For more information on OpenTelemetry, visit: - For more about OpenTelemetry JavaScript: - 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/exporter-logs-otlp-proto [otlp-exporter-base-config]: https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/otlp-exporter-base#http-exporter-configuration [npm-img]: https://badge.fury.io/js/%40opentelemetry%2Fexporter-logs-otlp-proto.svg [trace-exporter-url]: https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/exporter-trace-otlp-proto [metrics-exporter-url]: https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/opentelemetry-exporter-metrics-otlp-proto --- _Source: https://npm.io/package/@opentelemetry/exporter-logs-otlp-proto · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._