Overview
This guide walks you through integrating SigNoz with Langtrace to gain visibility into your LLM and AI applications. By combining Langtrace's specialized LLM instrumentation with SigNoz's observability platform, you can monitor and analyze traces from your AI workloads.
Prerequisites
- A SigNoz Cloud account with an active ingestion key or Self Hosted SigNoz instance
- Internet access to send telemetry data to SigNoz Cloud
- Python 3.10+ with
langtrace-python-sdkinstalled - For Python:
pipinstalled for managing Python packages - For this example: An OpenAI API key. You can get it from OpenAI platform
Integrate SigNoz with Langtrace
For more information on getting started with Langtrace in your Python environment, refer to the Langtrace Quickstart Guide. For more information on integrating SigNoz with Langtrace, refer to the Langtrace SigNoz Guide.
Step 1: Install the necessary packages in your Python environment.
pip install \
langtrace-python-sdk \
openai
For this guide example, we are using OpenAI, but you can use any LLM provider or LLM framework supported by Langtrace.
Step 2: Create an example LLM application (using OpenAI in this example)
from langtrace_python_sdk import langtrace
import os
from openai import OpenAI
langtrace.init()
client = OpenAI()
chat_completion = client.chat.completions.create(
messages=[
{
"role": "user",
"content": "What is SigNoz?",
}
],
model="gpt-3.5-turbo",
)
print(chat_completion.choices[0].message.content)
Before running this code, ensure that you have set the environment variable OPENAI_API_KEY with your generated OpenAI API key.
Step 3: Run your application with env variables
Run your application with the following environment variables set. This configures OpenTelemetry to export traces to SigNoz.
OTEL_EXPORTER_OTLP_ENDPOINT="https://ingest.<region>.signoz.cloud:443" \
OTEL_EXPORTER_OTLP_HEADERS="signoz-ingestion-key=<your_ingestion_key>" \
OTEL_RESOURCE_ATTRIBUTES=service.name="<service_name>" \
OTEL_EXPORTER_OTLP_PROTOCOL="grpc" \
<your_run_command>
<service_name>is the name of your service- Set the
<region>to match your SigNoz Cloud region - Replace
<your_ingestion_key>with your SigNoz ingestion key - Replace
<your_run_command>with the actual command you would use to run your application. In this case we would use:python main.py
Using self-hosted SigNoz? Most steps are identical. To adapt this guide, update the endpoint and remove the ingestion key header as shown in Cloud → Self-Hosted.
View Traces in SigNoz
Your AI usage should now automatically emit traces.
You should be able to view traces in Signoz Cloud under the traces tab:
When you click on a trace in SigNoz, you'll see a detailed view of the trace, including all associated spans, along with their events and attributes.
Troubleshooting
If you don't see your telemetry data:
- Verify network connectivity - Ensure your application can reach SigNoz Cloud endpoints
- Check ingestion key - Verify your SigNoz ingestion key is correct
- Wait for data - OpenTelemetry batches data before sending, so wait 10-30 seconds after making API calls
- Try a console exporter — Enable a console exporter locally to confirm that your application is generating telemetry data before it’s sent to SigNoz
Setup OpenTelemetry Collector (Optional)
What is the OpenTelemetry Collector?
Think of the OTel Collector as a middleman between your app and SigNoz. Instead of your application sending data directly to SigNoz, it sends everything to the Collector first, which then forwards it along.
Why use it?
- Cleaning up data — Filter out noisy traces you don't care about, or remove sensitive info before it leaves your servers.
- Keeping your app lightweight — Let the Collector handle batching, retries, and compression instead of your application code.
- Adding context automatically — The Collector can tag your data with useful info like which Kubernetes pod or cloud region it came from.
- Future flexibility — Want to send data to multiple backends later? The Collector makes that easy without changing your app.
See Switch from direct export to Collector for step-by-step instructions to convert your setup.
For more details, see Why use the OpenTelemetry Collector? and the Collector configuration guide.
Additional resources:
- Set up alerts for high latency or error rates
- Learn more about querying traces
- Explore log correlation
