{"record":{"id":"26fb0cf4a20f8f45","repo":"hashicorp/nomad","slug":"unsupported-version-s-matches-version-filter-s","errorCode":null,"errorMessage":"unsupported version=%s matches version filter %s","messagePattern":"unsupported version=(.+?) matches version filter (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"command/operator_debug.go","lineNumber":2129,"sourceCode":"\treturn version\n}\n\n// checkVersion verifies that version satisfies the constraint\nfunc checkVersion(version string, versionConstraint string) error {\n\tv, err := goversion.NewVersion(version)\n\tif err != nil {\n\t\treturn fmt.Errorf(\"error: %v\", err)\n\t}\n\n\tc, err := goversion.NewConstraint(versionConstraint)\n\tif err != nil {\n\t\treturn fmt.Errorf(\"error: %v\", err)\n\t}\n\n\tif !c.Check(v) {\n\t\treturn nil\n\t}\n\treturn fmt.Errorf(\"unsupported version=%s matches version filter %s\", version, minimumVersionPprofConstraint)\n}\n","sourceCodeStart":2111,"sourceCodeEnd":2131,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/command/operator_debug.go#L2111-L2131","documentation":"When the checked version parses and the constraint parses but the version DOES satisfy the constraint, checkVersion returns this error. It is used as an inclusion filter: any server whose version matches minimumVersionPprofConstraint is \"unsupported\" for pprof collection, so the debug collector should skip it and proceed without pprof endpoints.","triggerScenarios":"Running `nomad operator debug` against a Nomad server whose agent version matches minimumVersionPprofConstraint (i.e. older than the version range where pprof is supported), so pprof capture is skipped for that node.","commonSituations":"Mixed-version clusters during rolling upgrades where some agents still run pre-pprof versions; debugging older clusters where the pprof endpoints do not exist.","solutions":["Treat this as an expected skip: ignore the error and continue collecting other debug data without pprof.","Upgrade the Nomad server to a version outside the excluded constraint to enable pprof capture.","If pprof data is essential, pin/label the target node to a supported version before running debug."],"exampleFix":"// before\nif err := checkVersion(v, minimumVersionPprofConstraint); err != nil { return err }\n// after\nif err := checkVersion(v, minimumVersionPprofConstraint); err != nil {\n    ui.Output(fmt.Sprintf(\"skipping pprof for %s: %v\", nodeID, err))\n    return nil // unsupported version: proceed without pprof\n}","handlingStrategy":"fallback","validationCode":"v, _ := goversion.NewVersion(agentVersion)\nunsupported, _ := goversion.NewConstraint(minimumVersionPprofConstraint)\nif v != nil && unsupported.Check(v) {\n    // server version is known-unsupported: plan to skip pprof\n}","typeGuard":null,"tryCatchPattern":"if err := checkVersion(v, minimumVersionPprofConstraint); err != nil {\n    ui.Output(fmt.Sprintf(\"skipping pprof: %v\", err))\n    return nil // graceful skip\n}","preventionTips":["Expect this error on pre-pprof server versions and handle it as a normal skip, not a failure.","Upgrade mixed-version clusters so all agents support pprof endpoints.","Log which node was skipped so missing pprof archives in the bundle are explainable."],"tags":["versioning","feature-detection","nomad"],"backgroundTag":"unsupported-version","analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}