github.com/cloudflare/pint

Added

• Added support for Prometheus v3.13.0 experimental PromQL functions:
  min_of(), max_of().
• rule/duplicate now also detects duplicated
  alerting rules that can produce identical alerts from the same source time series.
• alerts/template now validates PromQL queries
  passed to the query template function, reporting syntax errors and result
  labels that the query cannot produce.

Fixed

• Fixed alerts/template was missing support for
  tmpl template function.

Added

• Added support for Prometheus v3.13.0 experimental PromQL functions: min_of(), max_of().
• rule/duplicate now also detects duplicated alerting rules that can produce identical alerts from the same source time series.
• alerts/template now validates PromQL queries passed to the query template function, reporting syntax errors and result labels that the query cannot produce.

Fixed

• Fixed alerts/template was missing support for tmpl template function.

Added

• Added promql/nan check.

Changed

• promql/vector_matching was refactored heavily
  to be faster and more accurate.

Fixed

• Fixed false positive reports from promql/impossible
  when functions like abs(), clamp_min(), hour(), ln(),
  histogram_quantile(), or timestamp() wrap aggregations that already remove
  labels.
• Fixed a crash in promql/aggregate when
  name regexp is not set.
• Fixed alerts/template not populating
  $annotations map, causing template expansion to always return
  empty values for annotation references.
• Fixed rule/label not matching regex key
  patterns on recording rules.
• Fixed bare # pint disable promql/series comments having no effect
  on promql/series checks.
• Fixed pint_rule_file_owner metric using symlink target path instead
  of symlink name, making it inconsistent with pint_problem metric.
• Fixed swapped label name and URL in
  promql/vector_matching error message
  when both sides of a binary operation are missing a label.
• Fixed false positive promql/range_query
  reports when Prometheus retention flag cannot be parsed.
• Fixed promql/counter not checking bare
  counter metrics used without any wrapping function.

Added

• Added promql/nan check.

Changed

• promql/vector_matching was refactored heavily to be faster and more accurate.

Fixed

• Fixed false positive reports from promql/impossible when functions like abs(), clamp_min(), hour(), ln(), histogram_quantile(), or timestamp() wrap aggregations that already remove labels.
• Fixed a crash in promql/aggregate when name regexp is not set.
• Fixed alerts/template not populating $annotations map, causing template expansion to always return empty values for annotation references.
• Fixed rule/label not matching regex key patterns on recording rules.
• Fixed bare # pint disable promql/series comments having no effect on promql/series checks.
• Fixed pint_rule_file_owner metric using symlink target path instead of symlink name, making it inconsistent with pint_problem metric.
• Fixed swapped label name and URL in promql/vector_matching error message when both sides of a binary operation are missing a label.
• Fixed false positive promql/range_query reports when Prometheus retention flag cannot be parsed.
• Fixed promql/counter not checking bare counter metrics used without any wrapping function.

Added

• Added promql/offset check that warns when a PromQL
  query uses an offset larger than configured Prometheus retention.
• Added support for Prometheus v3.12.0 experimental PromQL functions:
  start(), end(), range(), step().

Changed

• BitBucket reporter no longer creates Code Insight annotations.
  All problems are now reported as pull request comments.

Fixed

• Fixed query/cost suggesting recording rules with
  incompatible label matchers.
• Fixed query/cost suggesting recording rules when
  the query and recording rule use different aggregation grouping
  (e.g. sum by(job) vs sum without(instance)).

Added

• Added promql/offset check that warns when a PromQL query uses an offset larger than configured Prometheus retention.
• Added support for Prometheus v3.12.0 experimental PromQL functions: start(), end(), range(), step().

Changed

• BitBucket reporter no longer creates Code Insight annotations. All problems are now reported as pull request comments.

Fixed

• Fixed query/cost suggesting recording rules with incompatible label matchers.
• Fixed query/cost suggesting recording rules when the query and recording rule use different aggregation grouping (e.g. sum by(job) vs sum without(instance)).

Added

• GitHub and GitLab reporters will now automatically delete outdated general
  comments from previous pint ci runs.

Changed

• Reported problems will now trim more parts of the query for which the problem is
  reported, to make it easier to read.
• Reduced the number of low-value reports about smelly regexp selectors from the
  promql/regexp check.

Added

• GitHub and GitLab reporters will now automatically delete outdated general comments from previous pint ci runs.

Changed

• Reported problems will now trim more parts of the query for which the problem is reported, to make it easier to read.
• Reduced the number of low-value reports about smelly regexp selectors from the promql/regexp check.

Added

• rule/dependency check now supports ignoreGroupMismatch
  option for ignoring specific metrics when checking for cross-group
  dependencies - #1795.

Changed

• Reported problems will now trim parts of the query for which the problem is reported
  to make it easier to read.

Fixed

• GitHub and GitLab reporter was trying to create comments on incorrect lines.

Added

• rule/dependency check now supports ignoreGroupMismatch option for ignoring specific metrics when checking for cross-group dependencies - #1795.

Changed

• Reported problems will now trim parts of the query for which the problem is reported to make it easier to read.

Fixed

• GitHub and GitLab reporters were trying to create comments on incorrect lines.

Fixed

• Fixed incorrect reports from promql/regexp when empty match group is used.

Fixed

• Fixed incorrect reports from promql/regexp when empty match group is used.

Fixed

• rule/dependency won't report warnings when one
  query uses a recording rules that produce a static value (vector(1)).
  If the value is always the same the lag doesn't matter and it's a false positive.

Fixed

• rule/dependency won't report warnings when one query uses a recording rule that produces a static value (vector(1)). If the value is always the same the lag doesn't matter and it's a false positive.

Fixed

• GitHub and GitLab reporter was trying to create comments on unmodified files, which is not allowed.

Fixed

• GitHub and GitLab reporters were trying to create comments on unmodified files, which is not allowed.

Changed

• rule/dependency cross-group dependency check now
  only reports problems for recording rules.

Fixed

• Fixed a panic when running pint ci.

Changed

• rule/dependency cross-group dependency check now only reports problems for recording rules.

Fixed

• Fixed a panic when running pint ci.

Fixed

• Fixed GitLab reporter sending invalid line position when a comment is placed
  on a modified line in the diff, causing a 400 error from GitLab API.
• GitHub and GitLab reporters will now correctly handle MRs between two feature branches.

Fixed

• Fixed GitLab reporter sending invalid line position when a comment is placed on a modified line in the diff, causing a 400 error from GitLab API.
• GitHub and GitLab reporters will now correctly handle MRs between two feature branches.

Changed

• When running pint ci pint will now use git diff to calculate modified lines instead of git blame.
• Broken symlinks and unreadable files in the rules directory are now reported as yaml/parse problems instead of causing a fatal error.

Fixed

• Fixed parser not handling \r\n line endings correctly.
• alerts/count check will now more accurately estimate alert counts.

Added

• Added promql/features check.
• Added group/interval check.
• rule/dependency check will now warn when a rule uses a metric produced by a recording rule from a different group, which can introduce evaluation lag.

Fixed

• promql/vector_matching check no longer reports problems that are also reported by promql/impossible.
• Fixed problem description in promql/series check for disable comments that have no effect.
• Fixed invalid suggestions from the query/cost check.
• query/cost check will now skip expressions that don't read any time series, like scalar(), vector(), time(), pi(), or number literals.

Changed

• Removed uber-go/automaxprocs as it's no longer needed with Go 1.25+.

Fixed

• Fixed a crash in rule/label - #1696.
• Fixed false positive reports from promql/impossible check.

Fixed

• Fixed false positive reports from promql/impossible when label_join or label_replace is used - #1631.

Fixed

• Fixed a panic when parsing incomplete rules using relaxed mode.

Added

• The promql/impossible check will now warn about aggregations and binary operations that try to operate on labels that are already removed in the query. Example:

  - record: foo
    expr: sum(foo) / on(cluster) sum(bar)
  

  The above tries to join two series on the cluster label, but sum(...) already removed labels from the results on both sides, so there will be no such label to join on.

• The promql/impossible check will now warn about label joins using group_left(...) and group_right(...) that are not possible or not used in any way.

Fixed

• For queries using binary expressions between two vectors Prometheus will remove the metric name from resulting series, pint will now also apply the same logic when checking queries.

Fixed

• CI comments would sometimes print the problematic query fragment twice.

Added

• Added support for toDuration and now template functions added in Prometheus v3.6.

Fixed

• Some checks would fail to run queries against Prometheus servers if the query had comments in it.

Added

• Added promql/selector check - #1416 and #1540.

Fixed

• Fixed incorrect suggestions from query/cost for function calls with different arguments.

Fixed

• Fixed a bug in GitLab integration causing problems to fail to create comments when they are reported on deleted lines.
• Fixed incorrect suggestions from query/cost for rules joining on multiple metrics.

Fixed

• Fixed a bug in GitLab integration causing some problems to fail to create comments when files were renamed and modified.

Fixed

• Fixed incorrect suggestions generated by query/cost check.
• Fixed unmodified lines incorrectly marked as modified when running pint ci.

Fixed

• Fixed false positive reports from promql/rate check when native histograms or summaries are used.

Fixed

• Fixed false positive reports from promql/fragile check - #1466.
• Fixed incorrect reports from query/cost when multiple rules with rate(...) were present and each had a different rate time window.

Fixed

• Fixed an issue where pint would fail to create an MR comment if GitLab API returned empty diff body.

Fixed

• Fixed incorrect suggestion from query/cost when a query uses joins or unless.

Added

• promql/fragile check will now warn about alerting rules using aggregations that might cause false positives when Prometheus restarts.
• query/cost check will now try to find queries that perform operations for which there is a recording rule, and suggest using these recording rules instead to speed up the query.

Fixed

• Improved accuracy of messages produced by the promql/impossible check.