Metadata-Version: 2.4
Name: floe-telemetry-jaeger
Version: 0.1.0a1
Summary: Jaeger telemetry backend plugin for floe - OTLP exporter for Jaeger
Project-URL: Homepage, https://github.com/Obsidian-Owl/floe
Project-URL: Documentation, https://github.com/Obsidian-Owl/floe/tree/main/docs
Project-URL: Repository, https://github.com/Obsidian-Owl/floe
Author-email: Obsidian Owl <team@obsidianowl.dev>
License-Expression: Apache-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: floe-core<0.2.0,>=0.1.0a1
Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
Requires-Dist: opentelemetry-sdk>=1.20.0
Provides-Extra: dev
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.3; extra == 'dev'
Description-Content-Type: text/markdown

# floe-telemetry-jaeger

Jaeger telemetry backend plugin for floe - OTLP exporter for Jaeger distributed tracing.

## Overview

This plugin provides a `JaegerTelemetryPlugin` that configures OpenTelemetry to export traces to Jaeger via OTLP. This is recommended for:

- Production environments requiring distributed tracing
- Visualization of trace data with Jaeger UI
- Integration with existing Jaeger infrastructure

## Installation

```bash
pip install floe-telemetry-jaeger
```

## Usage

### Via manifest.yaml (Recommended)

```yaml
# manifest.yaml
plugins:
  telemetry_backend: jaeger
```

### Programmatic Usage

```python
from floe_telemetry_jaeger import JaegerTelemetryPlugin

plugin = JaegerTelemetryPlugin()
# Plugin will be loaded automatically by TelemetryProvider
```

## Configuration

The Jaeger plugin configures the OTLP exporter to send traces to a Jaeger collector. Default configuration:

- Endpoint: `jaeger-collector:4317` (gRPC)
- Protocol: OTLP/gRPC
- TLS: Disabled for local development

For production, configure via environment variables:
- `OTEL_EXPORTER_OTLP_ENDPOINT`: Jaeger collector endpoint
- `OTEL_EXPORTER_OTLP_INSECURE`: Set to "false" for TLS

## Requirements

- Python 3.10+
- floe-core >= 0.1.0
- opentelemetry-sdk >= 1.20.0
- opentelemetry-exporter-otlp >= 1.20.0

## License

Apache-2.0
