{"record":{"id":"f073cd3df5634cba","repo":"elastic/elasticsearch","slug":"missing-required-field-buckets-path-for-derivati","errorCode":null,"errorMessage":"Missing required field [buckets_path] for derivative aggregation [{pipelineAggregatorName}]","messagePattern":"Missing required field \\[buckets_path\\] for derivative aggregation \\[(.+?)\\]","errorType":"validation","errorClass":"ParsingException","httpStatus":null,"severity":"error","filePath":"modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java","lineNumber":217,"sourceCode":"                        paths.add(path);\n                    }\n                    bucketsPaths = paths.toArray(new String[paths.size()]);\n                } else {\n                    throw new ParsingException(\n                        parser.getTokenLocation(),\n                        \"Unknown key for a \" + token + \" in [\" + pipelineAggregatorName + \"]: [\" + currentFieldName + \"].\"\n                    );\n                }\n            } else {\n                throw new ParsingException(\n                    parser.getTokenLocation(),\n                    \"Unexpected token \" + token + \" in [\" + pipelineAggregatorName + \"].\"\n                );\n            }\n        }\n\n        if (bucketsPaths == null) {\n            throw new ParsingException(\n                parser.getTokenLocation(),\n                \"Missing required field [\"\n                    + BUCKETS_PATH_FIELD.getPreferredName()\n                    + \"] for derivative aggregation [\"\n                    + pipelineAggregatorName\n                    + \"]\"\n            );\n        }\n\n        DerivativePipelineAggregationBuilder factory = new DerivativePipelineAggregationBuilder(pipelineAggregatorName, bucketsPaths[0]);\n        if (format != null) {\n            factory.format(format);\n        }\n        if (gapPolicy != null) {\n            factory.gapPolicy(gapPolicy);\n        }\n        if (units != null) {\n            factory.unit(units);","sourceCodeStart":199,"sourceCodeEnd":235,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java#L199-L235","documentation":"Error \"Missing required field [buckets_path] for derivative aggregation [{pipelineAggregatorName}]\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java:217 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"db6a809a667c081ca1dc7500389d26975573215f","analyzedAt":"2026-08-12T01:39:14.192Z","schemaVersion":2},"datasetVersion":"2026-08-12T12:31:55.035Z"}