Laminar observability

1
1. Run `npx lmnr-cli setup` at the project root to get started with Laminar. This command will authenticate the user, save a new project API key to .env, and install the Laminar skill.
2
2. Instrument this project with Laminar using the installed skill or the docs:
3
   https://laminar.sh/docs/tracing/integrations/vercel-ai-sdk
4
3. Run a traced path inside your application.
5
4. Verify instrumentation:
6
   `lmnr-cli sql query "SELECT * FROM traces ORDER BY start_time DESC LIMIT 1" --json`

1
export async function register() {
2
  // prevent this from running in the edge runtime
3
  if (process.env.NEXT_RUNTIME === 'nodejs') {
4
    const { registerTelemetry } = await import('ai');
5
    const { LaminarAiSdkTelemetry } = await import('@lmnr-ai/lmnr');
6

7
    registerTelemetry(new LaminarAiSdkTelemetry());
8
  }
9
}

1
const nextConfig = {
2
  serverExternalPackages: ['@lmnr-ai/lmnr'],
3
};
4

5
export default nextConfig;

1
import { openai } from '@ai-sdk/openai';
2
import { generateText } from 'ai';
3

4
const { text } = await generateText({
5
  model: openai('gpt-5.4-mini'),
6
  prompt: 'What is Laminar flow?',
7
});

1
module.exports = {
2
  experimental: {
3
    instrumentationHook: true,
4
  },
5
};

1
import { registerOTel } from '@vercel/otel';
2

3
export async function register() {
4
  if (process.env.NEXT_RUNTIME === 'nodejs') {
5
    const { registerTelemetry } = await import('ai');
6
    const { initializeLaminarInstrumentations, LaminarAiSdkTelemetry } =
7
      await import('@lmnr-ai/lmnr');
8

9
    // Next.js telemetry
10
    registerOTel({
11
      serviceName: 'my-service',
12
      instrumentations: initializeLaminarInstrumentations(),
13
    });
14

15
    // Laminar AI SDK telemetry
16
    registerTelemetry(new LaminarAiSdkTelemetry());
17
  }
18
}

1
export async function register() {
2
  if (process.env.NEXT_RUNTIME === 'nodejs') {
3
    const { registerTelemetry } = await import('ai');
4
    const Sentry = await import('@sentry/node');
5
    const { LaminarAiSdkTelemetry } = await import('@lmnr-ai/lmnr');
6

7
    Sentry.init({
8
      dsn: process.env.SENTRY_DSN,
9
    });
10

11
    // Make sure to initialize Laminar **after** `Sentry.init`
12
    registerTelemetry(new LaminarAiSdkTelemetry());
13
  }
14
}

1
import { registerTelemetry } from 'ai';
2
import { LaminarAiSdkTelemetry } from '@lmnr-ai/lmnr';
3

4
registerTelemetry(new LaminarAiSdkTelemetry());

1
import { openai } from '@ai-sdk/openai';
2
import { generateText } from 'ai';
3

4
const { text } = await generateText({
5
  model: openai('gpt-5.4-mini'),
6
  prompt: 'What is Laminar flow?',
7
});

1
const { LaminarAiSdkTelemetry } = await import('@lmnr-ai/lmnr');
2
const Sentry = await import('@sentry/node');
3
const { registerTelemetry } = await import('ai');
4

5
Sentry.init({
6
  dsn: process.env.SENTRY_DSN,
7
});
8

9
registerTelemetry(new LaminarAiSdkTelemetry());

1
import { registerTelemetry } from 'ai';
2
import { LaminarAiSdkTelemetry } from '@lmnr-ai/lmnr';
3

4
registerTelemetry(new LaminarAiSdkTelemetry({
5
  laminarOptions: {
6
    projectApiKey: process.env.LMNR_PROJECT_API_KEY,
7
    baseUrl: "http://localhost",
8
    httpPort: 8000,
9
    grpcPort: 8001,
10
  },
11
})));

1
import { registerTelemetry } from 'ai';
2
import { LaminarAiSdkTelemetry } from '@lmnr-ai/lmnr';
3

4
registerTelemetry(new LaminarAiSdkTelemetry({
5
  recordInputs: false, // default true
6
  recordOutputs: false, // default true
7
})));

1
import { registerTelemetry } from 'ai';
2
import { LaminarAiSdkTelemetry } from '@lmnr-ai/lmnr';
3

4
registerTelemetry(new LaminarAiSdkTelemetry({
5
  createStepSpan: true, // default false
6
})));

1
const { text } = await generateText({
2
  model: openai('gpt-5.4-mini'),
3
  prompt: `Write a poem about Laminar flow.`,
4
  telemetry: {
5
    functionId: 'poem-writer',
6
  },
7
});

1
import { observe } from '@lmnr-ai/lmnr';
2

3
const result = await observe({ name: 'my-function' }, async () => {
4
  // ... some work
5
  await generateText({
6
    //...
7
  });
8
  // ... some work
9
});

1
const result = await observe(
2
  { name: 'poem writer' },
3
  async (topic: string, mood: string) => {
4
    const { text } = await generateText({
5
      model: openai('gpt-5.4-mini'),
6
      prompt: `Write a poem about ${topic} in ${mood} mood.`,
7
    });
8
    return text;
9
  },
10
  'Laminar flow',
11
  'happy',
12
);

1
const { text } = await generateText({
2
  model: openai('gpt-5.4-mini'),
3
  prompt: `Write a poem about Laminar flow.`,
4
  telemetry: {
5
    metadata: {
6
      'my-key': 'my-value',
7
      'another-key': 'another-value',
8
    },
9
  },
10
});

1
const { text } = await generateText({
2
  model: openai('gpt-5.4-mini'),
3
  prompt: `Write a poem about Laminar flow.`,
4
  telemetry: {
5
    metadata: {
6
      tags: ['fallback-model', 'api-handler'],
7
    },
8
  },
9
});

1
const { text } = await generateText({
2
  model: openai('gpt-5.4-mini'),
3
  prompt: `Write a poem about Laminar flow.`,
4
  telemetry: {
5
    metadata: {
6
      sessionId: 'session-123',
7
      userId: 'user-123',
8
    },
9
  },
10
});