OneUptime

To send OpenTelemetry metrics and traces generated by Shield360 from your AI Application to OneUptime, follow the below steps.

1. Get your Credentials

1. Sign in to your OneUptime account
2. Navigate to Project Settings:
   • Click on More in the Navigation bar
   • Click on Project Settings
3. Create Telemetry Ingestion Key:
   • On the Telemetry Ingestion Key page, click on Create Ingestion Key to create a token
4. Copy the Token:
   • Once you created a token, click on View to view and copy the token

2. Instrument your application

SDK

For direct integration into your Python applications:

Function Arguments

import shield360

shield360.init(
  otlp_endpoint="https://otlp.oneuptime.com",
  otlp_headers="x-oneuptime-token=YOUR_ONEUPTIME_SERVICE_TOKEN"
)

Replace:

1. YOUR_ONEUPTIME_SERVICE_TOKEN with the OneUptime Ingestion Key value you copied in Step 1.

Environment Variables

import shield360

shield360.init()

Set these environment variables:

export OTEL_EXPORTER_OTLP_ENDPOINT="https://otlp.oneuptime.com"
export OTEL_EXPORTER_OTLP_HEADERS="x-oneuptime-token=YOUR_ONEUPTIME_SERVICE_TOKEN"

Replace:

1. YOUR_ONEUPTIME_SERVICE_TOKEN with the OneUptime Ingestion Key value you copied in 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://otlp.oneuptime.com" \
  --otlp-headers "x-oneuptime-token=YOUR_ONEUPTIME_SERVICE_TOKEN" \
  --service-name "my-ai-service" \
  --deployment-environment "production" \
  python app.py

Replace:

1. YOUR_ONEUPTIME_SERVICE_TOKEN with the OneUptime Ingestion Key value you copied in Step 1.

Environment Variables

# Set environment variables (takes precedence over CLI args)
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otlp.oneuptime.com"
export OTEL_EXPORTER_OTLP_HEADERS="x-oneuptime-token=YOUR_ONEUPTIME_SERVICE_TOKEN"
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_DEPLOYMENT_ENVIRONMENT="production"

# Run your application
shield360-instrument python app.py

Replace:

1. YOUR_ONEUPTIME_SERVICE_TOKEN with the OneUptime Ingestion Key value you copied in Step 1.

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

3. Visualize in OneUptime

Once your LLM application is instrumented, you can explore the telemetry data in OneUptime:

1. Navigate to Telemetry: Go to your OneUptime project dashboard
2. View Traces: Check the Telemetry Traces page to see your AI application traces