2024-07-25-Release

Version 1.65.0 • JUL 25, 2024

New Features

• Configurable Measurement Interval

  • Review the Upgrade Notes for upgrade requirements
• Prometheus Metrics
• CLI Completion Command
• Multiple performance improvements for Postgres and Bolt Store
• Added the ability to specify a selector or query to the /agents/labels endpoint

Bug Fixes

• Fixed Configurations page telemetry sorting

Upgrade Notes

Prometheus

If you are not using BindPlane with high availability, no action is required.

BindPlane High Availability users should upgrade their Prometheus Linux Package. The latest version of the package will contain the new recording rules that enable Configurable Measurement Interval. After upgrading, no further action is required.

If you are managing Prometheus manually, you will need to re-review the documentation. Make sure to update your recording rules.

The new recording rules look like this.

groups:
- name: configuration-rollups
  interval: 1m
  rules:
  - record: bindplane_agent_measurements:rollup:rate:1m
    expr: sum without (agent) (rate(bindplane_agent_measurements{}[1m9s999ms] offset 10s))
- name: 5m-configuration-rollups
  interval: 5m
  rules:
  - record: bindplane_agent_measurements:rollup:rate:5m
    expr: sum without (agent) (rate(bindplane_agent_measurements:1m{}[5m59s999ms] offset 10s))
- name: 1h-configuration-rollups
  interval: 1h
  rules:
  - record: bindplane_agent_measurements:rollup:rate:1h
    expr: sum without (agent) (rate(bindplane_agent_measurements:15m{}[1h14m59s999ms] offset 10s))

Configurable Measurement Interval

Agents send configuration throughput metrics to BindPlane every 10 seconds. This interval is now configurable, supporting 10s, 1m, and 15m. It is recommended to use 1m or 15m intervals when managing large numbers of agents. At scale, 10s intervals can be responsible for high overhead.

The interval can be set by modifying a configuration's advanced settings. Select the gear icon on and choose "Advanced Configuration Options".

See the Upgrade Notes for important details regarding configurable measurement intervals.

Prometheus Metrics

BindPlane can expose APM metrics using a built-in Prometheus exporter. Metrics are disabled by default and can be enabled by updating your configuration file.

type: prometheus
interval: 10s
prometheus:
    endpoint: /metrics

CLI Completion Command

The CLI supports shell completion for bash, zsh, fish and powershell. After upgrading your CLI, use the bindplane completion -h command for more information.