Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions enterprise/analytics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

Laminar helps you understand what your OpenHands deployment is doing in production:

- Inspect prompts, tool calls, answers, and nested agent behavior in Laminar's [trace views](https://laminar.sh/docs/platform/viewing-traces).

Check warning on line 19 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L19

Did you really mean 'Laminar's'?
- Use [session replay for browser agents](https://laminar.sh/docs/tracing/browser-agent-observability) when conversations drive browser automation.
- For Helm installs, define [signals](https://laminar.sh/docs/signals/introduction) to classify failures, measure outcomes, and monitor recurring patterns across many traces.

Expand Down Expand Up @@ -107,13 +107,13 @@
Once the deployment status shows **Ready**, navigate to the Laminar frontend URL:

- VM install: `https://analytics.app.<your-base-domain>`
- Kubernetes install: the hostname configured in `laminar.frontend.ingress.hostname`

Check warning on line 110 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L110

Did you really mean 'hostname'?

Click the **Continue with Keycloak** button:

Check warning on line 112 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L112

Did you really mean 'Keycloak'?

![Laminar Keycloak Auth](./images/laminar-keycloak-auth.png)

Check warning on line 114 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L114

Did you really mean 'Keycloak'?

If you want more background on Laminar Cloud versus self-hosting outside OHE, see Laminar's official [hosting options](https://laminar.sh/docs/hosting-options).

Check warning on line 116 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L116

Did you really mean 'Laminar's'?

## Create a Laminar Project

Expand Down Expand Up @@ -268,13 +268,46 @@

![Laminar Trace](./images/laminar-trace.png)

## Query Traces with SQL

Use [Laminar's CLI](https://laminar.sh/docs/platform/cli) for expected read-only access to trace data. The CLI authenticates as your Laminar user, not with the ingest-only project API key configured for OpenHands trace collection.

For Laminar Cloud:

```bash
lmnr-cli login
lmnr-cli sql query "SELECT * FROM traces ORDER BY start_time DESC LIMIT 1"
```

For self-hosted Laminar, point the CLI at your frontend and API before logging in:

```bash
export LMNR_FRONTEND_URL=https://example.com
export LMNR_BASE_URL=https://api.example.com
export LMNR_HTTP_PORT=8000

lmnr-cli login
lmnr-cli sql query "SELECT * FROM traces ORDER BY start_time DESC LIMIT 1"
```

For scripts that need to call the SQL endpoint directly, send a `POST` request to `/v1/sql/query` with a read-capable Laminar project API key:

```bash
curl https://api.lmnr.ai/v1/sql/query \
-H "Authorization: Bearer $LMNR_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"SELECT * FROM traces ORDER BY start_time DESC LIMIT 10"}'
```

For self-hosted Laminar, replace `https://api.lmnr.ai` with your Laminar API endpoint.

## What to Do Next in Laminar

Once traces are flowing, use Laminar's official docs to go deeper:

Check warning on line 306 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L306

Did you really mean 'Laminar's'?

- [Viewing Traces](https://laminar.sh/docs/platform/viewing-traces) to inspect a single conversation in transcript, tree, or timeline views.
- For Helm installs, [Signals](https://laminar.sh/docs/signals/introduction) to extract structured outcomes or failure modes across many traces.
- [Session replay for browser agents](https://laminar.sh/docs/tracing/browser-agent-observability) to debug browser-based automations.

Check warning on line 310 in enterprise/analytics.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/analytics.mdx#L310

Did you really mean 'automations'?
- [Observability for OpenHands Software Agent SDK](https://laminar.sh/docs/tracing/integrations/openhands-sdk) for the OpenHands-specific tracing model.

## Next Steps
Expand Down
Loading