---
id: opentelemetry-instrumentation-groq
version: "0.62.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-groq — OpenTelemetry Groq instrumentation

License: permissive · Maintenance: active · Downloads: 2.9M/mo

## What it is and what it does

This package is an OpenTelemetry instrumentation plugin that hooks into the official Groq Python SDK to automatically capture traces of LLM API calls. When installed and initialized, it intercepts Groq SDK requests and logs prompts, completions, and other metadata as OpenTelemetry span attributes, giving you visibility into how your LLM application behaves in production.

By default, it logs full prompt and completion content to help with debugging and quality evaluation. However, you can disable content logging by setting the TRACELOOP_TRACE_CONTENT environment variable to false if you need to protect sensitive user data or reduce trace size. The instrumentation integrates with the standard OpenTelemetry ecosystem, so traces can be exported to any compatible backend (Jaeger, Datadog, etc.) for centralized monitoring.

Use it for:

- Debug LLM application behavior by inspecting actual prompts and completions sent to Groq in production traces.
- Monitor token usage and latency of Groq API calls across your application using OpenTelemetry-compatible observability platforms.
- Evaluate output quality by correlating prompts with completions in distributed traces for performance analysis.
- Audit LLM interactions for compliance by capturing structured span data without modifying application code.
- Troubleshoot integration issues between your application and Groq by examining instrumented request/response cycles.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Automatically captures traces of Groq SDK API calls, logging prompts, completions, and metadata to OpenTelemetry spans for observability and debugging of LLM applications.

Yes, if you use the Groq SDK and need observability. The package is actively maintained, has no known vulnerabilities, and integrates seamlessly with OpenTelemetry. The privacy control (TRACELOOP_TRACE_CONTENT) makes it suitable for production use. Install it if you want automatic LLM tracing without manual instrumentation code.

## Install

pip install opentelemetry-instrumentation-groq
uv add opentelemetry-instrumentation-groq
poetry add opentelemetry-instrumentation-groq

## Installing opentelemetry-instrumentation-groq

Before you install: Low friction: pure Python wheel with four stable OpenTelemetry runtime dependencies. Actively maintained with a recent release (4 days old) and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows free use, modification, and distribution in both open and proprietary projects without copyleft obligations.

Quickstart:

pip install opentelemetry-instrumentation-groq

from opentelemetry.instrumentation.groq import GroqInstrumentor

GroqInstrumentor().instrument()

Requires Python 3.10 or later; Groq SDK must be installed separately for instrumentation to function.

Verify before relying:

- Whether the instrumentation works with all Groq SDK versions or has version constraints beyond what the fact sheet states
- Performance overhead of tracing on high-volume LLM applications
- Whether sensitive data redaction beyond the TRACELOOP_TRACE_CONTENT flag is supported

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

groq api tracing, llm observability instrumentation, opentelemetry groq, trace groq completions, ai model monitoring, groq prompt logging, llm span instrumentation, llm-observability, groq-sdk, distributed-tracing

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-groq) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-groq/)