Create a /quality-metrics endpoint

cmd/query/app/http_handler.go

@@ -22,6 +22,7 @@ import (
 	"go.uber.org/zap"
 
 	"github.com/jaegertracing/jaeger-idl/model/v1"
+	"github.com/jaegertracing/jaeger/cmd/query/app/qualitymetrics"
 	"github.com/jaegertracing/jaeger/cmd/query/app/querysvc"
 	"github.com/jaegertracing/jaeger/internal/storage/metricstore/disabled"
 	"github.com/jaegertracing/jaeger/internal/storage/v1/api/metricstore"
@@ -121,6 +122,7 @@ func (aH *APIHandler) RegisterRoutes(router *mux.Router) {
 	aH.handleFunc(router, aH.calls, "/metrics/calls").Methods(http.MethodGet)
 	aH.handleFunc(router, aH.errors, "/metrics/errors").Methods(http.MethodGet)
 	aH.handleFunc(router, aH.minStep, "/metrics/minstep").Methods(http.MethodGet)
+	aH.handleFunc(router, aH.getQualityMetrics, "/quality-metrics").Methods(http.MethodGet)
 }
 
 func (aH *APIHandler) handleFunc(
@@ -552,3 +554,12 @@ func spanNameHandler(spanName string, handler http.Handler) http.Handler {
 		handler.ServeHTTP(w, r)
 	})
 }
+
+func (aH *APIHandler) getQualityMetrics(w http.ResponseWriter, r *http.Request) {
+	data := qualitymetrics.GetSampleData()
+	structuredRes := structuredResponse{
+		Data:   data,
+		Errors: []structuredError{},
+	}
+	aH.writeJSON(w, r, &structuredRes)
+}

cmd/query/app/http_handler_test.go

@@ -863,6 +863,17 @@ func TestGetMetricsSuccess(t *testing.T) {
 	}
 }
 
+func TestGetQualityMetrics(t *testing.T) {
+	handler := &APIHandler{}
+	req := httptest.NewRequest(http.MethodGet, "/quality-metrics", nil)
+	rr := httptest.NewRecorder()
+	handler.getQualityMetrics(rr, req)
+	assert.Equal(t, http.StatusOK, rr.Code)
+	assert.Equal(t, "application/json", rr.Header().Get("Content-Type"))
+	var resp structuredResponse
+	assert.NoError(t, json.Unmarshal(rr.Body.Bytes(), &resp), "unable to unmarshal response")
+}
+
 func TestMetricsReaderError(t *testing.T) {
 	metricsReader := &metricsmocks.Reader{}
 	ts := initializeTestServer(t, HandlerOptions.MetricsQueryService(metricsReader))

cmd/query/app/qualitymetrics/data.go

@@ -0,0 +1,102 @@
+// Copyright (c) 2025 The Jaeger Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+package qualitymetrics
+
+func GetSampleData() TQualityMetrics {
+	return TQualityMetrics{
+		TraceQualityDocumentationLink: "https://github.com/jaegertracing/jaeger-analytics-java#trace-quality-metrics",
+		BannerText: &BannerText{
+			Value: "🛑 Made up data, for demonstration only!",
+			Styling: map[string]any{
+				"color":      "blue",
+				"fontWeight": "bold",
+			},
+		},
+		Scores: []Score{
+			{
+				Key:   "coverage",
+				Label: "Instrumentation Coverage",
+				Max:   100,
+				Value: 90,
+			},
+			{
+				Key:   "quality",
+				Label: "Trace Quality",
+				Max:   100,
+				Value: 85,
+			},
+		},
+		Metrics: []Metric{
+			{
+				Name:                    "Span Completeness",
+				Category:                "coverage",
+				Description:             "Measures the completeness of spans in traces.",
+				MetricDocumentationLink: "https://example.com/span-completeness-docs",
+				MetricWeight:            0.6,
+				PassCount:               1500,
+				PassExamples: []Example{
+					{TraceID: "trace-id-001"},
+					{TraceID: "trace-id-002"},
+				},
+				FailureCount: 100,
+				FailureExamples: []Example{
+					{TraceID: "trace-id-003"},
+				},
+				Details: []Detail{
+					{
+						Description: "Detailed breakdown of span completeness.",
+						Header:      "Span Completeness Details",
+						Columns: []ColumnDef{
+							{Key: "service", Label: "Service"},
+							{Key: "spanCount", Label: "Span Count"},
+						},
+						Rows: []Row{
+							{"service": "sample-service-A", "spanCount": 150},
+							{"service": "sample-service-B", "spanCount": 200},
+						},
+					},
+				},
+			},
+			{
+				Name:                    "Error Rate",
+				Category:                "quality",
+				Description:             "Percentage of spans that resulted in errors.",
+				MetricDocumentationLink: "https://example.com/error-rate-docs",
+				MetricWeight:            0.4,
+				PassCount:               1400,
+				PassExamples: []Example{
+					{TraceID: "trace-id-004"},
+				},
+				FailureCount: 80,
+				FailureExamples: []Example{
+					{TraceID: "trace-id-005"},
+				},
+				Details: []Detail{
+					{
+						Description: "Detailed breakdown of error rates.",
+						Header:      "Error Rate Details",
+						Columns: []ColumnDef{
+							{Key: "service", Label: "Service"},
+							{Key: "errorCount", Label: "Error Count"},
+						},
+						Rows: []Row{
+							{"service": "sample-service-A", "errorCount": 5},
+							{"service": "sample-service-B", "errorCount": 3},
+						},
+					},
+				},
+			},
+		},
+		Clients: []Client{
+			{
+				Version:    "1.0.0",
+				MinVersion: "0.9.0",
+				Count:      10,
+				Examples: []Example{
+					{TraceID: "trace-id-006"},
+				},
+			},
+		},
+	}
+}

cmd/query/app/qualitymetrics/data_test.go

@@ -0,0 +1,21 @@
+// Copyright (c) 2025 The Jaeger Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+package qualitymetrics
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+
+	"github.com/jaegertracing/jaeger/pkg/testutils"
+)
+
+func TestGetSampleData(t *testing.T) {
+	data := GetSampleData()
+	assert.NotEmpty(t, data.TraceQualityDocumentationLink)
+}
+
+func TestMain(m *testing.M) {
+	testutils.VerifyGoLeaks(m)
+}

cmd/query/app/qualitymetrics/data_types.go

@@ -0,0 +1,83 @@
+// Copyright (c) 2025 The Jaeger Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+package qualitymetrics
+
+// TQualityMetrics represents the entire quality metrics response.
+type TQualityMetrics struct {
+	TraceQualityDocumentationLink string      `json:"traceQualityDocumentationLink"`
+	BannerText                    *BannerText `json:"bannerText,omitempty"`
+	Scores                        []Score     `json:"scores"`
+	Metrics                       []Metric    `json:"metrics"`
+	Clients                       []Client    `json:"clients,omitempty"`
+}
+
+// BannerText stores the optional banner text with styling
+type BannerText struct {
+	Value   string         `json:"value"`
+	Styling map[string]any `json:"styling,omitempty"`
+}
+
+// Score represents individual score entries.
+type Score struct {
+	Key   string `json:"key"`
+	Label string `json:"label"`
+	Max   int    `json:"max"`
+	Value int    `json:"value"`
+}
+
+// Metric represents individual metrics with detailed information.
+type Metric struct {
+	Name                    string    `json:"name"`
+	Category                string    `json:"category"`
+	Description             string    `json:"description"`
+	MetricDocumentationLink string    `json:"metricDocumentationLink"`
+	MetricWeight            float64   `json:"metricWeight"`
+	PassCount               int       `json:"passCount"`
+	PassExamples            []Example `json:"passExamples"`
+	FailureCount            int       `json:"failureCount"`
+	FailureExamples         []Example `json:"failureExamples"`
+	ExemptionCount          *int      `json:"exemptionCount"`
+	ExemptionExamples       []Example `json:"exemptionExamples"`
+	Details                 []Detail  `json:"details"`
+}
+
+// Detail represents additional details for a metric.
+type Detail struct {
+	Description string      `json:"description"`
+	Header      string      `json:"header"`
+	Columns     []ColumnDef `json:"columns"`
+	Rows        []Row       `json:"rows"`
+}
+
+// ColumnDef represents column definitions in details.
+type ColumnDef struct {
+	Key         string         `json:"key"`
+	Label       string         `json:"label"`
+	PreventSort bool           `json:"preventSort"`
+	Styling     map[string]any `json:"styling,omitempty"`
+}
+
+// Row represents a single row of data in details.
+type Row map[string]any
+
+// StyledValue represents a value that may include styling or a link.
+type StyledValue struct {
+	LinkTo  string         `json:"linkTo"`
+	Styling map[string]any `json:"styling"`
+	Value   any            `json:"value"`
+}
+
+// Example represents a sample trace
+type Example struct {
+	SpanIDs []string `json:"spanIDs"`
+	TraceID string   `json:"traceID"`
+}
+
+// Client represents client information.
+type Client struct {
+	Version    string    `json:"version"`
+	MinVersion string    `json:"minVersion"`
+	Count      int       `json:"count"`
+	Examples   []Example `json:"examples"`
+}