Instrument Your Application¶

Send traces, metrics, and logs from your application to IAPM using standard OpenTelemetry. No proprietary SDKs required - use the same open-source libraries the industry relies on.

Quick Configuration¶

All you need is your OTLP endpoint and API key:

Get your API key by logging in at portal.iapm.app, then go to Administration > Grids and click Instrument on your Grid.

Environment Variables¶

The fastest way to configure any OpenTelemetry SDK is with environment variables. These work across all languages:

Quick Start by Language¶

Choose your language to see the minimal configuration needed to start sending telemetry:

// Program.cs
builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing
        .AddAspNetCoreInstrumentation()
        .AddHttpClientInstrumentation()
        .AddOtlpExporter(options =>
        {
            options.Endpoint = new Uri("https://otlp.iapm.app");
            options.Headers = "API-Key=YOUR-API-KEY";
        }))
    .WithMetrics(metrics => metrics
        .AddAspNetCoreInstrumentation()
        .AddOtlpExporter(options =>
        {
            options.Endpoint = new Uri("https://otlp.iapm.app");
            options.Headers = "API-Key=YOUR-API-KEY";
        }));

# Download the OpenTelemetry Java agent
curl -L -o opentelemetry-javaagent.jar \
  https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

# Run your application with auto-instrumentation
java -javaagent:opentelemetry-javaagent.jar \
  -Dotel.exporter.otlp.endpoint=https://otlp.iapm.app \
  -Dotel.exporter.otlp.headers=API-Key=YOUR-API-KEY \
  -Dotel.service.name=your-service-name \
  -jar your-app.jar

pip install opentelemetry-distro opentelemetry-exporter-otlp

# Auto-instrument and run
OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.iapm.app \
OTEL_EXPORTER_OTLP_HEADERS="API-Key=YOUR-API-KEY" \
OTEL_SERVICE_NAME=your-service-name \
opentelemetry-instrument python your_app.py

npm install @opentelemetry/sdk-node \
  @opentelemetry/exporter-trace-otlp-grpc \
  @opentelemetry/exporter-metrics-otlp-grpc \
  @opentelemetry/auto-instrumentations-node

// tracing.js - require this before your app
const { NodeSDK } = require('@opentelemetry/sdk-node');
const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-grpc');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter({
    url: 'https://otlp.iapm.app',
    headers: { 'API-Key': 'YOUR-API-KEY' },
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});

sdk.start();

import (
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc"
    "google.golang.org/grpc/credentials"
)

exporter, err := otlptracegrpc.New(ctx,
    otlptracegrpc.WithEndpoint("otlp.iapm.app:443"),
    otlptracegrpc.WithHeaders(map[string]string{
        "API-Key": "YOUR-API-KEY",
    }),
    otlptracegrpc.WithTLSCredentials(credentials.NewClientTLSFromCert(nil, "")),
)

What Gets Collected¶

Once configured, OpenTelemetry captures three types of telemetry:

All three signal types are sent to the same OTLP endpoint. IAPM correlates them automatically so you can navigate from a metric spike to the traces and logs that explain it.

Verify It's Working¶

After deploying your instrumented application:

1. Generate some traffic by making a few requests to your application
2. Open portal.iapm.app and select your Grid
3. Click Enter to open the IAPM experience
4. You should see your service and its telemetry data within a few minutes

Language Guides¶

Detailed setup instructions for each language and platform:

Further Reading¶

• OpenTelemetry Documentation - Official OpenTelemetry reference
• OpenTelemetry Language SDKs - SDK documentation by language