Metadata-Version: 2.4
Name: forgesight-prometheus
Version: 0.1.1
Summary: ForgeSight Prometheus exporter — pull /metrics + push-gateway for agent telemetry.
Project-URL: Homepage, https://github.com/Scaffoldic/forgesight
Project-URL: Repository, https://github.com/Scaffoldic/forgesight
Project-URL: Issues, https://github.com/Scaffoldic/forgesight/issues
Project-URL: Changelog, https://github.com/Scaffoldic/forgesight/blob/main/docs/releases/v0.1.md
Author: kjoshi
License-Expression: Apache-2.0
Keywords: ai-agents,forgesight,metrics,observability,prometheus
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: forgesight-core
Requires-Dist: prometheus-client>=0.20
Description-Content-Type: text/markdown

# forgesight-prometheus

The Prometheus exporter for [ForgeSight](https://github.com/Scaffoldic/forgesight).
Bridges ForgeSight's product metrics + GenAI histograms onto a Prometheus registry
with a pull `/metrics` endpoint (and an optional Pushgateway for short-lived runs).

```bash
pip install forgesight-prometheus
```

```python
import forgesight
from forgesight_prometheus import PrometheusExporter

forgesight.configure(exporters=[PrometheusExporter(port=9464, prefix="forgesight")])
# Prometheus scrapes http://<host>:9464/metrics
```

Or by name via config: `exporters: [{name: prometheus, config: {port: 9464}}]`.

- Labels are cardinality-bounded (agent name / provider / model / status / …);
  `run_id`/`trace_id` are never labels.
- `push_gateway: http://pushgateway:9091` pushes on shutdown for CI / batch runs.

## License

Apache-2.0
