diff --git a/beps/0012-telemetry-service/README.md b/beps/0012-telemetry-service/README.md new file mode 100644 index 0000000000..ae7b269a7d --- /dev/null +++ b/beps/0012-telemetry-service/README.md @@ -0,0 +1,85 @@ +--- +title: Backstage Telemetry Service +status: implementable +authors: + - '@kurtaking' +owners: + - '@kurtaking' +project-areas: + - backend + - framework +creation-date: 2025-06-23 +--- + + + +# BEP: Backstage Telemetry Service + +- [Summary](#summary) +- [Motivation](#motivation) + - [Goals](#goals) + - [Non-Goals](#non-goals) +- [Proposal](#proposal) +- [Design Details](#design-details) +- [Release Plan](#release-plan) +- [Dependencies](#dependencies) +- [Alternatives](#alternatives) + +## Summary + +Add a core telemetry service to Backstage's backend system that provides a unified interface for metrics, tracing, and logging instrumentation. The service would offer OpenTelemetry-based telemetry capabilities with zero configuration defaults while allowing extensibility through plugin modules. + +## Motivation + +While individual plugins may implement their own metrics or tracing, there's no unified service that provides a standardized approach for telemetry and observability. This gap makes it difficult for operators to monitor Backstage deployments effectively and for plugin developers to add observability to their plugins consistently. + +### Goals + +- Consistent telemetry patterns across all plugins +- Zero-configuration defaults that work out of the box +- Extensible architecture for custom telemetry backends +- OpenTelemetry integration following industry standards +- Performance monitoring capabilities built into the platform + +### Non-Goals + +## Proposal + + + +## Design Details + + + +## Release Plan + + + +## Dependencies + + + +## Alternatives + +