> ## Documentation Index
> Fetch the complete documentation index at: https://docs.infrastack.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrate OpenTelemetry for Express.js with infrastack.ai
> Learn how to instrument your Express.js application with infrastack.ai and OpenTelemetry for comprehensive observability and performance insights.
export const JsIcon = ({size = "24"}) => ;
export const GithubIcon = ({size = "24"}) => ;
#### What you will learn
* How to set up your environment
* How to **instrument** your application using the infrastack.ai SDK or the official OpenTelemetry SDK
#### Prerequisites
* An [infrastack.ai](https://app.infrastack.ai) account to get your API key
* An Express.js application
} />
### Getting started
You can use the Infrastack SDK to instrument your Express.js application with a single line of code.
```bash npm theme={null}
npm install @infrastack/otel
```
```bash yarn theme={null}
yarn add @infrastack/otel
```
```bash pnpm theme={null}
pnpm add @infrastack/otel
```
Export your API key as an environment variable.
```bash theme={null}
export INFRASTACK_API_KEY=sk-1*************************f5af
```
Or you can set the environment variables in your `.env` file by using the [dotenv](https://www.npmjs.com/package/dotenv) library.
```javascript instrumentation.ts theme={null}
import { Infrastack } from "@infrastack/otel";
Infrastack.init({
serviceName:"YOUR_SERVICE_NAME",
});
```
If you don't provide a service name, we will create a random name for you.
Run your Express.js application with the node required command.
```bash theme={null}
npx tsc && node -r ./dist/instrumentation.js dist/index.js
```
After creating some traffic, you can check your data from the [infrastack.ai](https://app.infrastack.ai) dashboard.
You can use the [OpenTelemetry Javascript SDK](https://opentelemetry.io/docs/languages/js/) to instrument your Express.js application.
```bash npm theme={null}
npm install --save @opentelemetry/sdk-node
npm install --save @opentelemetry/auto-instrumentations-node
npm install --save @opentelemetry/exporter-trace-otlp-grpc
```
```bash yarn theme={null}
yarn add @opentelemetry/sdk-node
yarn add @opentelemetry/auto-instrumentations-node
yarn add @opentelemetry/exporter-trace-otlp-grpc
```
```bash pnpm theme={null}
pnpm add @opentelemetry/sdk-node
pnpm add @opentelemetry/auto-instrumentations-node
pnpm add @opentelemetry/exporter-trace-otlp-grpc
```
```bash theme={null}
export OTEL_EXPORTER_OTLP_ENDPOINT="https://collector.infrastack.ai"
export OTEL_EXPORTER_OTLP_HEADERS="infrastack-api-key={{YOUR_INFRASTACK_API_KEY}}"
```
Or you can set the environment variables in your `.env` file by using the [dotenv](https://www.npmjs.com/package/dotenv) library.
Here, you will create a file that will be used to instrument your application. You will have lower level control over the instrumentation process.
```javascript instrumentation.ts theme={null}
import { NodeSDK } from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
import { Resource } from '@opentelemetry/resources';
import { SemanticResourceAttributes } from '@opentelemetry/semantic-conventions';
import { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base';
import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
// Exporter options with compression set to Gzip
const exporterOptions = {
compression: CompressionAlgorithm.GZIP,
};
// Trace exporter initialization
const traceExporter = new OTLPTraceExporter(exporterOptions);
// SDK initialization with exporter, auto-instrumentation, and resource attributes
const sdk = new NodeSDK({
traceExporter,
instrumentations: [getNodeAutoInstrumentations()],
resource: new Resource({
[ATTR_SERVICE_NAME]: "{{YOUR_SERVICE_NAME}}",
[ATTR_SERVICE_VERSION]: "{{YOUR_SERVICE_VERSION}}",
}),
});
// Start the SDK and register it with the OpenTelemetry API
sdk.start();
// Graceful shutdown of SDK on process exit
process.on("SIGTERM", () => {
sdk
.shutdown()
.then(() => console.log("Tracing terminated"))
.catch((error) => console.log("Error terminating tracing", error))
.finally(() => process.exit(0));
});
```
Run your Express.js application with the [node required](https://nodejs.org/api/cli.html#cli_r_require_module) command.
```bash theme={null}
npx tsc && node -r ./dist/instrumentation.js dist/index.js
```
After creating some traffic, you can check your data from the [infrastack.ai](https://app.infrastack.ai) dashboard.
### Next steps
} />
} />