SigLens

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

1. Get your SigLens Endpoint

1. Ensure SigLens is running: Make sure your SigLens instance is deployed and accessible
2. Get the OTLP endpoint: SigLens accepts OTLP data on port 4318
   • Local deployment: http://localhost:4318/v1/traces
   • Remote deployment: http://<your-siglens-host>:4318/v1/traces
   • Replace <your-siglens-host> with your SigLens server address

Note

SigLens supports direct OTLP ingestion without additional authentication for basic setups.

2. Instrument your application

SDK

For direct integration into your Python applications:

Function Arguments

import shield360

shield360.init(
  otlp_endpoint="YOUR_SIGLENS_HTTP_ENDPOINT"
)

Replace:

1. YOUR_SIGLENS_HTTP_ENDPOINT with your SigLens OTLP endpoint from Step 1.
   • Example (Local): http://localhost:4318/v1/traces
   • Example (Remote): http://siglens.company.com:4318/v1/traces

Environment Variables

import shield360

shield360.init()

Set these environment variables:

export OTEL_EXPORTER_OTLP_ENDPOINT="YOUR_SIGLENS_HTTP_ENDPOINT"
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_DEPLOYMENT_ENVIRONMENT="production"

Replace:

1. YOUR_SIGLENS_HTTP_ENDPOINT with your SigLens OTLP endpoint from Step 1.
   • Example (Local): http://localhost:4318/v1/traces
   • Example (Remote): http://siglens.company.com:4318/v1/traces

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 "YOUR_SIGLENS_HTTP_ENDPOINT" \
  --service-name "my-ai-service" \
  --deployment-environment "production" \
  python app.py

Replace:

1. YOUR_SIGLENS_HTTP_ENDPOINT with your SigLens OTLP endpoint from Step 1.
   • Example (Local): http://localhost:4318/v1/traces
   • Example (Remote): http://siglens.company.com:4318/v1/traces

Environment Variables

# Set environment variables (takes precedence over CLI args)
export OTEL_EXPORTER_OTLP_ENDPOINT="YOUR_SIGLENS_HTTP_ENDPOINT"
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_DEPLOYMENT_ENVIRONMENT="production"

# Run your application
shield360-instrument python app.py

Replace:

1. YOUR_SIGLENS_HTTP_ENDPOINT with your SigLens OTLP endpoint from Step 1.
   • Example (Local): http://localhost:4318/v1/traces
   • Example (Remote): http://siglens.company.com:4318/v1/traces

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

3. Visualize in SigLens

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

1. Access SigLens Interface: Log into your SigLens instance dashboard
2. Navigate to Tracing: Click Tracing in the side navigation menu
3. Explore AI Operations: View your AI application traces including:
   • LLM request traces with detailed timing
   • Token usage and cost information
   • Vector database operations
   • Model performance analytics
   • Request/response payloads (if enabled)
4. Trace Details: Click on any trace to see detailed span information and execution flow
5. Search and Filter: Use SigLens’ powerful search capabilities to filter traces by service, operation, or custom attributes
6. Performance Analysis: Analyze latency patterns and identify performance bottlenecks