@@ -440,49 +440,27 @@ Beyond goose's built-in [logging system](/docs/guides/logs), you can export tele
440440
441441### OpenTelemetry Protocol (OTLP)
442442
443- Configure goose to export traces, metrics, and logs to any
444- [ OpenTelemetry] ( https://opentelemetry.io/docs/ ) compatible platform.
445- When configured, goose exports telemetry asynchronously and flushes on exit.
443+ Configure goose to export traces and metrics to any OTLP-compatible observability platform.
444+ OTLP is the standard protocol for sending telemetry collected by [ OpenTelemetry] ( https://opentelemetry.io/docs/ ) . When configured, goose exports telemetry asynchronously and flushes on exit.
446445
447- goose respects standard [ OTel SDK environment variables] [ otel-env ] . The
448- simplest way to enable export is to set a collector endpoint:
449-
450- ``` bash
451- export OTEL_EXPORTER_OTLP_ENDPOINT=" http://localhost:4318"
452- ```
453-
454- This enables OTLP export for all signals (traces, metrics, logs). You can
455- control each signal independently with ` OTEL_{SIGNAL}_EXPORTER ` where signal
456- is ` TRACES ` , ` METRICS ` , or ` LOGS ` :
457-
458- | Variable pattern | Purpose | Values |
459- | ---| ---| ---|
460- | ` OTEL_EXPORTER_OTLP_ENDPOINT ` | Base OTLP endpoint (applies ` /v1/traces ` , etc.) | URL |
461- | ` OTEL_EXPORTER_OTLP_{SIGNAL}_ENDPOINT ` | Override endpoint for a specific signal | URL |
462- | ` OTEL_{SIGNAL}_EXPORTER ` | Exporter type per signal | ` otlp ` , ` console ` , ` none ` |
463- | ` OTEL_SDK_DISABLED ` | Disable all OTel export | ` true ` |
464-
465- Additional variables like ` OTEL_SERVICE_NAME ` , ` OTEL_RESOURCE_ATTRIBUTES ` ,
466- and ` OTEL_EXPORTER_OTLP_TIMEOUT ` are also supported.
467- See the [ OTel environment variable spec] [ otel-env ] for the full list.
468-
469- ** Examples:**
446+ | Variable | Purpose | Values | Default |
447+ | ----------| ---------| --------| ---------|
448+ | ` OTEL_EXPORTER_OTLP_ENDPOINT ` | OTLP endpoint URL | URL (e.g., ` http://localhost:4318 ` ) | None |
449+ | ` OTEL_EXPORTER_OTLP_TIMEOUT ` | Export timeout in milliseconds | Integer (ms) | ` 10000 ` |
450+
451+ ** When to use OTLP:**
452+ - Diagnosing slow tool execution or LLM response times
453+ - Understanding intermittent failures across multiple sessions
454+ - Monitoring goose performance in production or CI/CD environments
455+ - Tracking usage patterns, costs, and resource consumption over time
456+ - Setting up alerts for performance degradation or high error rates
457+
458+ ** Example:**
470459``` bash
471- # Export everything to a local collector
472460export OTEL_EXPORTER_OTLP_ENDPOINT=" http://localhost:4318"
473-
474- # Export only traces, disable metrics and logs
475- export OTEL_TRACES_EXPORTER=" otlp"
476- export OTEL_METRICS_EXPORTER=" none"
477- export OTEL_LOGS_EXPORTER=" none"
478- export OTEL_EXPORTER_OTLP_ENDPOINT=" http://localhost:4318"
479-
480- # Debug traces to console (no collector needed)
481- export OTEL_TRACES_EXPORTER=" console"
461+ export OTEL_EXPORTER_OTLP_TIMEOUT=10000
482462```
483463
484- [ otel-env ] : https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/
485-
486464### Langfuse Integration
487465
488466These variables configure the [ Langfuse integration for observability] ( /docs/tutorials/langfuse ) .
0 commit comments