Skip to main content
Portkey supports sending your Analytics data to OpenTelemetry (OTel) compatible collectors, allowing you to integrate Portkey’s analytics with your existing observability infrastructure.

​
Overview

While Portkey leverages Clickhouse as the primary Analytics Store for the Control Panel by default, enterprise customers can integrate Portkey’s analytics data with their existing data infrastructure through OpenTelemetry. This export focuses on aggregated metrics and analytics data such as:
  • Request counts and latency metrics
  • Token usage statistics
  • Cost tracking data
  • Error rates and status codes
For exporting complete request/response logs with full prompt and completion content, see Complete Logs Export.

​
Configuration

Portkey supports pushing your analytics data to an OTel compatible endpoint. The following environment variables are needed for pushing to OTel: 
OTEL_PUSH_ENABLED: true
OTEL_ENDPOINT: http://localhost:4318
OTEL_EXPORTER_OTLP_HEADERS: x-api-key=my-api-key,x-another-header=value

​
Environment Variables

VariableRequiredDescription
OTEL_PUSH_ENABLEDYesSet to true to enable analytics export
OTEL_ENDPOINTYesThe OTLP endpoint URL
OTEL_EXPORTER_OTLP_HEADERSNoComma-separated headers in key=value format

​
Resource Attributes

You can configure arbitrary resource attributes of the OTel logs by setting a comma-separated value for OTEL_RESOURCE_ATTRIBUTES: 
OTEL_SERVICE_NAME: portkey-gateway
OTEL_RESOURCE_ATTRIBUTES: ApplicationShortName=gateway,AssetId=12323,deployment.service=production
VariableDescription
OTEL_SERVICE_NAMEService name for the telemetry data
OTEL_RESOURCE_ATTRIBUTESComma-separated key=value pairs for additional resource attributes

​
Integration Options

Enterprise customers commonly use these analytics exports with:
  • Datadog: Monitor and analyze your AI operations alongside other application metrics
  • AWS S3: Store analytics data for long-term retention and analysis
  • Prometheus/Grafana: Build custom dashboards and alerting
  • Splunk: Integrate with existing SIEM infrastructure
  • Other OTel-compatible systems: Any system that can ingest OpenTelemetry data

​
Use Cases

This feature enables:
  • Centralized observability across your entire tech stack
  • Long-term storage of analytics data
  • Custom analytics dashboards in your preferred tools
  • Integration with existing alerting systems
  • Compliance and audit trail requirements

​
Getting Support

For additional assistance with setting up analytics data export: Our team can help you with best practices for configuring your OTel collectors and integrating with your existing systems.