# @google-cloud/opentelemetry-cloud-trace-exporter

> OpenTelemetry Google Cloud Trace Exporter allows the user to send collected traces to Google Cloud Trace.

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

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @google-cloud/opentelemetry-cloud-trace-exporter
pnpm add @google-cloud/opentelemetry-cloud-trace-exporter
yarn add @google-cloud/opentelemetry-cloud-trace-exporter
bun add @google-cloud/opentelemetry-cloud-trace-exporter
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 3.1.0 |
| Published | 2026-08-11 |
| First published | 2020-03-24 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 4 |
| Unpacked size | 179.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Google Inc. |
| Maintainers | google-wombot, google-admin |
| Keywords | opentelemetry, nodejs, tracing, google-cloud-trace |

## Links

- npm: https://www.npmjs.com/package/@google-cloud/opentelemetry-cloud-trace-exporter
- Repository: GoogleCloudPlatform/opentelemetry-operations-js
- npm.io page: https://npm.io/package/@google-cloud/opentelemetry-cloud-trace-exporter

## Dependencies (4)

- [@grpc/grpc-js](https://npm.io/package/@grpc/grpc-js.md) ^1.1.8
- [@grpc/proto-loader](https://npm.io/package/@grpc/proto-loader.md) ^0.8.0
- [google-auth-library](https://npm.io/package/google-auth-library.md) ^10.0.0
- [@google-cloud/opentelemetry-resource-util](https://npm.io/package/@google-cloud/opentelemetry-resource-util.md) ^3.1.0

## Recent versions

- 3.1.0 (latest) — 2026-08-11
- 3.0.0 — 2025-09-09
- 2.4.1 — 2024-09-26
- 2.4.0 — 2024-09-25
- 2.3.0 — 2024-07-12
- 2.2.0 — 2024-05-09
- 2.1.0 — 2023-07-11
- 2.0.0 — 2023-02-02
- 1.2.0 — 2022-12-05
- 1.1.0 — 2022-01-19
- 1.0.0 — 2021-10-08
- 0.12.0 — 2021-09-28
- 0.11.0 — 2021-08-02
- 0.10.0 — 2021-06-22
- 0.9.0 — 2021-03-05
- … 11 more at https://npm.io/package/@google-cloud/opentelemetry-cloud-trace-exporter/versions

## README

> [!WARNING]
> This package is **deprecated** and will be archived after October 30th, 2026. Please migrate to community-maintained OTLP exporters (e.g., `@opentelemetry/exporter-trace-otlp-http` or `@opentelemetry/exporter-trace-otlp-grpc`). See the [Migration Guide](https://github.com/GoogleCloudPlatform/opentelemetry-operations-js/blob/main/MIGRATION.md) for details.

# OpenTelemetry Google Cloud Trace Exporter
[![NPM Published Version][npm-img]][npm-url]
[![Apache License][license-image]][license-image]

OpenTelemetry Google Cloud Trace Exporter allows the user to send collected traces to [Google
Cloud Trace](https://cloud.google.com/trace).

To get started with instrumentation in Google Cloud, see [Generate traces and metrics with
Node.js](https://cloud.google.com/stackdriver/docs/instrumentation/setup/nodejs).

To learn more about instrumentation and observability, including opinionated recommendations
for Google Cloud Observability, visit [Instrumentation and
observability](https://cloud.google.com/stackdriver/docs/instrumentation/overview).

## Setup

Google Cloud Trace is a managed service provided by Google Cloud Platform.

## Installation

```bash
npm install --save @google-cloud/opentelemetry-cloud-trace-exporter
```

## Usage
Install the exporter on your application, register the exporter, and start tracing. If you are running in a GCP environment, the exporter will automatically authenticate using the environment's service account. If not, you will need to follow the instructions in [Authentication](#Authentication).

```js
const { TraceExporter } = require('@google-cloud/opentelemetry-cloud-trace-exporter');

const exporter = new TraceExporter({
  // If you are not in a GCP environment, you will need to provide your
  // service account key here. See the Authentication section below.
});
```

Now, register the exporter with the built-in
[`BatchSpanProcessor`](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.4.0/specification/trace/sdk.md#batching-processor)
which batches ended spans and passes them to the configured `SpanExporter`.

```js
provider.addSpanProcessor(new BatchSpanProcessor(exporter));
```

## Resource attributes

By default, OpenTelemetry resource attributes which do not map to a monitored resource are ignored. If you wish to export other resource attributes, you must specify a regexp that should match the attribute keys you'd like.

For example, if you are setting up a resource with the "service" semantic attributes:
```typescript
const {
  SEMRESATTRS_SERVICE_NAME,
  SEMRESATTRS_SERVICE_NAMESPACE,
  SEMRESATTRS_SERVICE_VERSION,
  SEMRESATTRS_SERVICE_INSTANCE_ID,
} = require('@opentelemetry/semantic-conventions');

const provider = new NodeTracerProvider({
  // ...
  resource: resourceFromAttributes({

  SEMRESATTRS_SERVICE_NAME,
    [SEMRESATTRS_SERVICE_NAME]: 'things-service',
    [SEMRESATTRS_SERVICE_NAMESPACE]: 'things',
    [SEMRESATTRS_SERVICE_VERSION]: '1.0.0',
    [SEMRESATTRS_SERVICE_INSTANCE_ID]: 'abc123',
  }),
})
```

You can ensure they are exported by using a regexp that matches them:
```typescript
const exporter = new TraceExporter({
  // will export all resource attributes that start with "service."
  resourceFilter: /^service\./
});
```

## Authentication

The Google Cloud Trace exporter supports authentication using service accounts. These can either be defined in a keyfile (usually called `service_account_key.json` or similar), or by the environment. If your application runs in a GCP environment, such as Compute Engine, you don't need to provide any application credentials. The client library will find the credentials by itself. For more information, go to <https://cloud.google.com/docs/authentication/>.

### Service account key

If you are not running in a GCP environment, you will need to give the service account credentials to the exporter.

```js
const { TraceExporter } = require('@google-cloud/opentelemetry-cloud-trace-exporter');

const exporter = new TraceExporter({
  /** option 1. provide a service account key json */
  keyFile: './service_account_key.json',
  keyFileName: './service_account_key.json',

  /** option 2. provide credentials directly */
  credentials: {
    client_email: string,
    private_key: string,
  },
});
```

## Useful links
- For more information on OpenTelemetry, visit: <https://opentelemetry.io/>
- For more about OpenTelemetry JavaScript: <https://github.com/open-telemetry/opentelemetry-js>
- Learn more about Google Cloud Trace at https://cloud.google.com/trace


[npm-url]: https://www.npmjs.com/package/@google-cloud/opentelemetry-cloud-trace-exporter
[npm-img]: https://badge.fury.io/js/%40google-cloud%2Fopentelemetry-cloud-trace-exporter.svg
[license-url]: https://github.com/GoogleCloudPlatform/opentelemetry-operations-js/blob/main/LICENSE
[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat

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