With HoneyHive, we allow users to track:

  1. Model inference calls as model events
  2. External API calls (like retrieval) as tool events
  3. Groups of inference & external API calls as chain events
  4. An entire trace of requests as a session

​
Logging a Trace

We use OpenTelemetry to automatically instrument your AI application.

You can find the full list of supported packages here.

Prerequisites

  • You have already created a project in HoneyHive, as explained here.
  • You have an API key for your project, as explained here.

Expected Time: 5 minutes

Steps

1

Installation

To install our SDKs, run the following commands in the shell.

2

Authenticate the SDK & initialize the tracer

To initialize the tracer, we require 3 key details:

  1. Your HoneyHive API Key
  2. Name of the project to log the trace to
  3. Name for this session - like “Chatbot Session” or “Customer RAG Session”.
3

Structure your traces using function decorators

The above initialization will auto-capture all interactions with our supported providers.

To further trace other execution steps, we provide an optional function decorator. It helps with tracing specific steps that aren’t included automatically.

Tracing custom spans (Python)

Structure your Python traces using our @trace function decorator

Tracing custom spans (JS/TS)

Structure your JavaScript traces using our traceFunction function wrapper

​
View the trace

Now that you have successfully traced your session, you can review it in the platform.

  1. Navigate to the project in the platform via the projects page or the dropdown in the Header.
  2. Follow these steps after

​

​
Learn more

Tracer Troubleshooting

Learn how to troubleshoot common issues with our tracers.

API Reference

Learn how to use HoneyHive’s APIs to trace your pipelines in any language.

Data Model Overview

Learn how HoneyHive’s core data model works.

Instrumentation Best Practices

Learn best-practices for instrumenting your application.

Private CloudTroubleshooting & FAQs