SigNoz/signoz · warning

span evaluation feature is disabled and is experimental

Error message

span evaluation feature is disabled and is experimental

What it means

Returned by BuildQueryRangeParams in the Kafka messaging-queues integration when queryContext is 'producer-consumer-eval' but the kafkaSpanEval feature flag is disabled. This guards the experimental span-evaluation query path.

Source

Thrown at pkg/query-service/app/integrations/messagingQueues/kafka/translator.go:15

package kafka

import (
	"fmt"

	"github.com/SigNoz/signoz/pkg/query-service/common"
	v3 "github.com/SigNoz/signoz/pkg/query-service/model/v3"
)

var defaultStepInterval int64 = 60

func BuildQueryRangeParams(messagingQueue *MessagingQueue, queryContext string, kafkaSpanEval bool) (*v3.QueryRangeParamsV3, error) {

	if !kafkaSpanEval && queryContext == "producer-consumer-eval" {
		return nil, fmt.Errorf("span evaluation feature is disabled and is experimental")
	}

	// ToDo: propagate this through APIs when there are different handlers
	queueType := KafkaQueue

	chq, err := BuildClickHouseQuery(messagingQueue, queueType, queryContext)

	if err != nil {
		return nil, err
	}

	cq, err := buildCompositeQuery(chq, queryContext)
	if err != nil {
		return nil, err
	}

	queryRangeParams := &v3.QueryRangeParamsV3{
		Start:          messagingQueue.Start,

View on GitHub (pinned to 5069bf80b0)

Solutions

1. Enable the Kafka span evaluation feature flag in query-service configuration
2. Or avoid the producer-consumer-eval query context until the feature is stable
3. Check release notes for the flag name in your SigNoz version

Example fix

// before
BuildQueryRangeParams(mq, "producer-consumer-eval", false)

// after
BuildQueryRangeParams(mq, "producer-consumer-eval", true)

if (queryContext==='producer-consumer-eval' && !kafkaSpanEval) throw new Error('span eval disabled');

When it happens

Trigger: Requesting Kafka producer-consumer eval data while the span evaluation feature flag is off in query-service settings.

Common situations: Using Kafka monitoring dashboards/APIs that call the eval context without enabling the experimental span-eval flag in your SigNoz config.

Related errors

• consumer_group not found in the request
• partition not found in the request
• invalid type for Topic
• invalid type for Partition
• invalid type for consumer group

AI-assisted analysis of SigNoz/signoz@5069bf80b0 (2026-08-28). Data as JSON: /api/errors/427ecfd0d252db8f. Report an issue: GitHub.