diff --git a/img/integrations/sumologic-trace-detail.png b/img/integrations/sumologic-trace-detail.png new file mode 100644 index 0000000..def64e1 Binary files /dev/null and b/img/integrations/sumologic-trace-detail.png differ diff --git a/img/integrations/sumologic-traces.png b/img/integrations/sumologic-traces.png new file mode 100644 index 0000000..d975775 Binary files /dev/null and b/img/integrations/sumologic-traces.png differ diff --git a/mint.json b/mint.json index 4d5a7c7..04ce2db 100644 --- a/mint.json +++ b/mint.json @@ -142,6 +142,7 @@ "openllmetry/integrations/signoz", "openllmetry/integrations/sentry", "openllmetry/integrations/splunk", + "openllmetry/integrations/sumologic", "openllmetry/integrations/tencent" ] }, diff --git a/openllmetry/integrations/introduction.mdx b/openllmetry/integrations/introduction.mdx index 33f7742..bb10ce7 100644 --- a/openllmetry/integrations/introduction.mdx +++ b/openllmetry/integrations/introduction.mdx @@ -50,5 +50,6 @@ in any observability platform that supports OpenTelemetry. + diff --git a/openllmetry/integrations/sumologic.mdx b/openllmetry/integrations/sumologic.mdx new file mode 100644 index 0000000..0e4df0f --- /dev/null +++ b/openllmetry/integrations/sumologic.mdx @@ -0,0 +1,63 @@ +--- +title: "LLM Observability with Sumo Logic and OpenLLMetry" +sidebarTitle: "Sumo Logic" +--- + +Sumo Logic natively supports OpenTelemetry, so you can send LLM traces directly to its OTLP/HTTP source endpoint or route them through an OpenTelemetry Collector. + +## Option 1: Direct OTLP/HTTP Source + +Create an [OTLP/HTTP Source](https://www.sumologic.com/help/docs/send-data/hosted-collectors/http-source/otlp/) on a Hosted Collector in Sumo Logic. This gives you a presigned URL with the authentication token embedded. + +Set the `TRACELOOP_BASE_URL` to your source endpoint: + +```bash +TRACELOOP_BASE_URL=https://collectors.sumologic.com/receiver/v1/otlp/ +``` + +Alternatively, you can use the base endpoint with an authentication header: + +```bash +TRACELOOP_BASE_URL=https://collectors.sumologic.com/receiver/v1/otlp +TRACELOOP_HEADERS="x-sumo-token=" +``` + +## Option 2: OpenTelemetry Collector + +Install the [Sumo Logic OpenTelemetry Collector](https://www.sumologic.com/help/docs/send-data/opentelemetry-collector/) with the default configuration. + +Ensure the OTLP receiver is configured: + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: "0.0.0.0:4317" + http: + endpoint: "0.0.0.0:4318" +``` + +Then point `TRACELOOP_BASE_URL` to your collector: + +```bash +TRACELOOP_BASE_URL=http://localhost:4318 +``` + +The collector handles authentication and forwarding to Sumo Logic automatically using its installation token. + +## Viewing Traces in Sumo Logic + +Once configured, LLM traces will appear in Sumo Logic's tracing view: + + + Sumo Logic traces overview + + +You can drill into individual traces to see detailed span information: + + + Sumo Logic trace detail view + + +For more information, see the [Sumo Logic OpenLLMetry documentation](https://www.sumologic.com/help/docs/integrations/aiml/opentelemetry/openllmetry/).