Murnitur

To send OpenTelemetry traces generated by Shield360 from your AI Application to Murnitur.ai, follow the below steps.

1. Get your Credentials

1. Visit Murnitur.ai: Go to Murnitur.ai to create your account
2. Generate API Key: Navigate to your dashboard and generate your API key
3. Save your credentials:
   • API Key: Your Murnitur trace token for authentication
   • Endpoint: https://middleware.murnitur.ai

Note

Murnitur.ai is optimized for trace data. The integration automatically disables metrics to focus on trace observability.

2. Instrument your application

SDK

For direct integration into your Python applications:

Function Arguments

import shield360

shield360.init(
  otlp_endpoint="https://middleware.murnitur.ai",
  otlp_headers="x-murnix-trace-token=YOUR_MURNITUR_API_KEY",
  disable_metrics=True  # Murnitur focuses on trace data
)

Replace:

1. YOUR_MURNITUR_API_KEY with your Murnitur API key from Step 1.

Environment Variables

import shield360

shield360.init()

Set these environment variables:

export OTEL_EXPORTER_OTLP_ENDPOINT="https://middleware.murnitur.ai"
export OTEL_EXPORTER_OTLP_HEADERS="x-murnix-trace-token=YOUR_MURNITUR_API_KEY"
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_DEPLOYMENT_ENVIRONMENT="production"
export SHIELD360_DISABLE_METRICS="true"

Replace:

1. YOUR_MURNITUR_API_KEY with your Murnitur API key from Step 1.

Refer to the Shield360 SDK configuration reference for more advanced configurations and use cases.

CLI

For zero-code auto-instrumentation via command line:

CLI Arguments

# Using CLI arguments
shield360-instrument \
  --otlp-endpoint "https://middleware.murnitur.ai" \
  --otlp-headers "x-murnix-trace-token=YOUR_MURNITUR_API_KEY" \
  --service-name "my-ai-service" \
  --deployment-environment "production" \
  --disable-metrics \
  python app.py

Replace:

1. YOUR_MURNITUR_API_KEY with your Murnitur API key from Step 1.

Environment Variables

# Set environment variables (takes precedence over CLI args)
export OTEL_EXPORTER_OTLP_ENDPOINT="https://middleware.murnitur.ai"
export OTEL_EXPORTER_OTLP_HEADERS="x-murnix-trace-token=YOUR_MURNITUR_API_KEY"
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_DEPLOYMENT_ENVIRONMENT="production"
export SHIELD360_DISABLE_METRICS="true"

# Run your application
shield360-instrument python app.py

Replace:

1. YOUR_MURNITUR_API_KEY with your Murnitur API key from Step 1.

Refer to the Shield360 SDK configuration reference for more advanced configurations and use cases.

3. Visualize in Murnitur.ai

Once your LLM application is instrumented, you can explore the telemetry data in Murnitur.ai:

1. Navigate to Murnitur.ai: Go to your Murnitur.ai Dashboard
2. Explore Traces: View your AI application traces including:
   • LLM request traces with detailed timing and execution flow
   • Model performance analytics and latency metrics
   • Request/response data for debugging and optimization
   • Token usage and cost tracking information
   • Complete trace hierarchy showing the full request lifecycle
3. Trace Analytics: Analyze patterns, performance bottlenecks, and usage trends
4. Performance Monitoring: Monitor latency, throughput, and error rates
5. Debugging Tools: Use detailed trace data to debug and optimize your AI applications

Your Shield360-instrumented AI applications will appear automatically in Murnitur.ai with comprehensive trace observability focused on LLM performance, execution flow, and detailed debugging capabilities optimized for AI workloads.