{"record":{"id":"1da99c1a3677d383","repo":"SigNoz/signoz","slug":"error-in-builder-queries","errorCode":null,"errorMessage":"error in builder queries","messagePattern":"error in builder queries","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/query-service/app/querier/querier.go","lineNumber":193,"sourceCode":"\tresults := make([]*v3.Result, 0)\n\terrQueriesByName := make(map[string]error)\n\tvar errs []error\n\n\tfor result := range ch {\n\t\tif result.Err != nil {\n\t\t\terrs = append(errs, result.Err)\n\t\t\terrQueriesByName[result.Name] = result.Err\n\t\t\tcontinue\n\t\t}\n\t\tresults = append(results, &v3.Result{\n\t\t\tQueryName: result.Name,\n\t\t\tSeries:    result.Series,\n\t\t})\n\t}\n\n\tvar err error\n\tif len(errs) > 0 {\n\t\terr = fmt.Errorf(\"error in builder queries\")\n\t}\n\n\treturn results, errQueriesByName, err\n}\n\nfunc (q *querier) runPromQueries(ctx context.Context, orgID valuer.UUID, params *v3.QueryRangeParamsV3) ([]*v3.Result, map[string]error, error) {\n\tchannelResults := make(chan channelResult, len(params.CompositeQuery.PromQueries))\n\tvar wg sync.WaitGroup\n\tcacheKeys := q.keyGenerator.GenerateKeys(params)\n\n\tfor queryName, promQuery := range params.CompositeQuery.PromQueries {\n\t\tif promQuery.Disabled {\n\t\t\tcontinue\n\t\t}\n\t\twg.Add(1)\n\t\tgo func(queryName string, promQuery *v3.PromQuery) {\n\t\t\tdefer wg.Done()\n\t\t\tcacheKey, ok := cacheKeys[queryName]","sourceCodeStart":175,"sourceCodeEnd":211,"githubUrl":"https://github.com/SigNoz/signoz/blob/5069bf80b08f1f00d7e014eccc09902f9871004f/pkg/query-service/app/querier/querier.go#L175-L211","documentation":"Aggregate error returned by runBuilderQueries when one or more individual builder queries failed (details are in the per-query errs map / errQueriesByName). The generic message signals partial or total failure of a query-range execution.","triggerScenarios":"Any builder query inside a composite POST /api/v3/query_range failing — e.g. invalid filter, ClickHouse error, or unsupported aggregate — causes the top-level response to carry this error alongside per-query errors.","commonSituations":"One panel query referencing a non-existent attribute; ClickHouse connectivity/permission issues; version drift where a function or attribute changed.","solutions":["Inspect the errQueriesByName map in the response to find the failing query and its real error","Fix the specific query (attribute name, filter, aggregate function)","If the cause is a ClickHouse error, check ClickHouse health/logs next"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":"// pre-flight each builder query's filters/aggregates against known schema before executing\nfor name, q := range params.CompositeQuery.BuilderQueries { validateFiltersAndAggregates(name, q) }","typeGuard":null,"tryCatchPattern":"Check errQueriesByName per query; render successful results and mark failed series as errors in the panel rather than failing the whole request.","preventionTips":["Log per-query errors with query names for fast triage","Monitor ClickHouse health since many root causes originate there","Pin attribute names by validating against the schema cache"],"tags":["signoz","query-range","aggregate-error","clickhouse"],"backgroundTag":"partial-query-failure","analyzedSha":"5069bf80b08f1f00d7e014eccc09902f9871004f","analyzedAt":"2026-08-28T06:22:12.824Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}