wehub-resource-sync
8a21a212f8
Deploy Documentation / deploy (push) Has been cancelled
Canary / build-cli (push) Has been skipped
Canary / Upload Install Script (push) Has been skipped
Canary / bundle-desktop (push) Has been skipped
Canary / bundle-desktop-intel (push) Has been skipped
Canary / bundle-desktop-linux (push) Has been skipped
Canary / bundle-desktop-windows (push) Has been skipped
Canary / bundle-desktop-windows-cuda (push) Has been skipped
Canary / Release (push) Has been skipped
Cargo Deny / deny (push) Has been skipped
Unused Dependencies / machete (push) Has been skipped
Canary / Prepare Version (push) Failing after 1s
Live Provider Tests / check-fork (push) Failing after 0s
Create Minor Release PR / check-version-bump-pr (push) Has been skipped
Publish Ask AI Bot Docker Image / docker (push) Failing after 1s
Live Provider Tests / changes (push) Has been skipped
Scorecard supply-chain security / Scorecard analysis (push) Has been skipped
Publish Docker Image / docker (push) Failing after 1s
CI / changes (push) Failing after 8s
Create Minor Release PR / release (push) Has been skipped
Live Provider Tests / Smoke Tests (push) Has been cancelled
Live Provider Tests / Smoke Tests (Code Execution) (push) Has been cancelled
Live Provider Tests / Compaction Tests (push) Has been cancelled
CI / Build Rust Project on Windows (push) Has been cancelled
Live Provider Tests / Build Binary (push) Has been cancelled
CI / Lint Rust Code (push) Has been cancelled
CI / Check Generated Schemas are Up-to-Date (push) Has been cancelled
CI / Test and Lint Electron Desktop App (push) Has been cancelled
CI / Check Rust Code Format (push) Has been cancelled
CI / Build and Test Rust Project (push) Has been cancelled
CI / Check MSRV (push) Has been cancelled
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
---
|
|
description: Integrate goose with Laminar to observe performance
|
|
---
|
|
|
|
# Observability with Laminar
|
|
|
|
This tutorial covers how to integrate goose with Laminar to trace your goose sessions and understand how the agent is performing.
|
|
|
|
## What is Laminar
|
|
|
|
[Laminar](https://laminar.sh/) is an open-source observability platform purpose-built for AI agents. It traces LLM calls, tool execution, and custom functions so you can debug, evaluate, and improve agent behavior.
|
|
|
|
## Why Laminar for goose
|
|
|
|
- High-signal traces for LLM calls, tools, and sub-agents.
|
|
- Replay any span in the Playground to compare prompts and models.
|
|
- Build datasets from production traces and run evaluations.
|
|
- Analyze trace patterns with natural language queries and dashboards.
|
|
|
|
## Set up Laminar
|
|
|
|
Sign up for Laminar Cloud at [laminar.sh](https://laminar.sh) or self-host Laminar from the [open-source repo](https://github.com/lmnr-ai/lmnr). Grab your project API key.
|
|
|
|
## Configure goose to export OTLP to Laminar
|
|
|
|
goose exports OpenTelemetry data over OTLP/HTTP. Point the exporter to Laminar and provide your API key as an authorization header.
|
|
|
|
### Laminar Cloud
|
|
|
|
```bash
|
|
export LMNR_PROJECT_API_KEY=lmnr_proj_...
|
|
export OTEL_EXPORTER_OTLP_ENDPOINT="https://api.lmnr.ai"
|
|
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer ${LMNR_PROJECT_API_KEY}"
|
|
export OTEL_EXPORTER_OTLP_TIMEOUT=10000
|
|
```
|
|
|
|
### Self-hosted Laminar
|
|
|
|
```bash
|
|
export LMNR_PROJECT_API_KEY=lmnr_proj_...
|
|
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:8000"
|
|
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer ${LMNR_PROJECT_API_KEY}"
|
|
```
|
|
|
|
If your self-hosted instance does not require auth, you can omit `OTEL_EXPORTER_OTLP_HEADERS`.
|
|
|
|
:::tip
|
|
If you do not see traces, try setting the endpoint to the explicit OTLP path, such as `https://api.lmnr.ai/v1/traces` or `http://localhost:8000/v1/traces`.
|
|
:::
|
|
|
|
## Run goose with Laminar enabled
|
|
|
|
Start goose normally. With the OTLP environment variables set, Laminar will capture traces of your goose sessions and tool execution.
|
|
|
|
_[Example trace (public) in Laminar](https://laminar.sh/shared/traces/63010af0-cf31-b8b6-0d77-fc9924bcaa4c)_
|
|
|
|
|