Complimentary Gartner® Report! 'A CTO's Guide to Open-Source Software: Answering the Top 10 FAQs.'Read more

Release Notes

The latest product updates from observIQ

RSS feed
  • VERSION 1.84.0

    New Features

    • OIDC Authentication
      • BindPlane web interface now supports OpenID Connect for authentication
    • Postgres vacuum command
    • Serve font files locally
      • All required fonts are now bundled within the BindPlane binary
    • New Copy Field
      • Documentation coming soon!

    Bug Fixes

    • File source will now work with an empty Log Type parameter value

    CLI: Vacuum Command

    New commands admin vacuum-analyze to assist in managing your Postgres database. When directed by support, performing a manual Postgres Vacuum can help with performance issues. Generally a manual vacuum is not required.

    The commands require system auth.

    bash
    1$ bindplane admin vacuum-analyze
    2
    3? WARNING: This command will significantly degrade BindPlane's performance while it runs. Are you sure you want to continue? (y/n) y
    4database vacuumed.
  • VERSION 1.83.0

    New Features

    Bug Fixes

  • VERSION 1.82.0

    New Features

    • Added timeout option to OTLP and BindPlane Gateway sources
    • Parse Timestamp Processor recommendation enhancements
      • Support RFC1123 format
      • Skip recommendation or fields generated by Log Deduplication processor
      • Recommend time parsing for unknown time formats when fields ts, datatime, and timestamp are detected

    Bug Fixes

    • Resolved an issue where ARM64 builds of BindPlane did not include the correct Transform Agent binary

    Misc

    • Postgres database migration errors are now saved to the database for simplified troubleshooting
  • VERSION 1.81.0

    New Features

    Bug Fixes

    • Deleting the last source from a configuration will no longer cause a blank screen
  • VERSION 1.80.0

    Bug Fixes

    • Resolved an issue where Rename Fields processor would output incorrect field names.
    • Resolved an issue where deleted agents would reconnect without their labels, causing them to receive a nop configuration from BindPlane.
  • VERSION 1.79.0

    Agent Version Compatibility

    BindPlane Agent v1.63.0 or newer is not compatible with BindPlane OP server v1.59.1 or older. If you are using BindPlane OP v1.59.1 or older, it is recommended to upgrade to v1.79.0.

    It is safe to upgrade from v1.59.1 to v1.79.0. However, if you are on v1.59.0 or older, it is recommended to first upgrade to v1.59.1 and then to v1.79.0.

    License

    Licenses have always been required when operating BindPlane OP. If a license was not configured, the web interface would prompt for one. As of v1.79.0, new installations of BindPlane OP will require a license key in the configuration file. If you are installing BindPlane OP with the installation script or the Helm chart, no further steps are required.

    If you are installing BindPlane OP Linux packages without using the install script, you must run the init command or modify /etc/bindplane/config.yaml to configure a license before starting the service.

    New Features

    Bug Fixes

    • Resolves an issue where Postgres migrations could happen out of order

    Deprecated Resources

    The following processors have been deprecated and replaced by a version 2 implementation.

    • Add Fields v1
    • Rename Fields v1
    • Delete Fields v1

    Deprecated resources are available to users who are already using them within a configuration. It is recommended that you replace your existing processors with the new v2 implementation.

  • VERSION 1.77.0

    New Features

    • Expose Batch processor Options in Kafka Stream source
    • Add max_log_size option to TCP and Syslog sources
    • Add region option to Google SecOps destination
    • Backup Boltstore database on version upgrade
    • BindPlane SaaS Web interface support menu
      • SaaS users can interact with support directly from the BindPlane web interface
    • Rename Fields processor recommendation
      • Google Cloud and Google Prometheus Engine configurations will recommend the rename fields processor if duplicate attribute and resource keys are detected

    Bug Fixes

    • Fixed an issue where users could configure two destinations with the same name
  • VERSION 1.76.0

    Upgrade Notes

    Agent Version Support

    important

    Couchbase source need to take care when upgrading their BindPlane Agent. This is due to changes to the OpenTelemetry Transformation Language (OTTL) which impact the Couchbase source.

    BindPlane v1.76.0 is required for BindPlane Agent v1.63.0 or newer. Users with BindPlane agent version v1.60.0 or older must upgrade to v1.61.0 or v1.62.0 before upgrading to v1.63.0.

    If you are not using the Couchbase source, you can ignore Agent Version Support upgrade notes.

    New Features

    Minimum TLS Version

    When using TLS, BindPlane defaults to a minimum TLS version of 1.3. Users can opt into TLS 1.2 for supporting client devices that do not support TLS 1.3.

    To configured TLS 1.2, update network.tlsMinVersion string value to "1.2".

    yaml
    1network:
    2  tlsMinVersion: "1.2"
  • VERSION 1.75.0

    New Features

    • Kafka Source: New advanced options
      • Max Message Bytes
      • Required Acks
      • Flush Max Messages
    • New QRadar Destination
    • Support OTTL conditions on Sample Logs Processor
    • New Delete Fields processor recommendation.
      • Live Preview will recommend the deletion of severity and timestamp fields which were previously parsed to a log record.

    Bug Fixes

    • Kafka destination will no longer require a mutual TLS keypair when TLS is enabled
  • VERSION 1.74.0

    New Features

    Bug Fixes

    • Coralogix Destination: Fix domain option and add support for USA2 and APAC3 regions
    • S3 Destination: Fix file_prefix option
    • Fixed an issue where deleting a configuration would not delete rollout history when using Bolt store
  • VERSION 1.73.0

    New Features

    • Add HTTP DataPlane exporter option to SecOps
    • Implement custom-message based throughput measurements
      • Agent v1.59.2 or newer throughput metrics are published over OpAMP instead of a dedicated HTTP connection.
    • Okta source

    Bug Fixes

    • Fixed an issue where BindPlane v1.72 would render destinations incorrectly
      • New Relic
      • Sumo Logic
    • Fixed an issue where un-linking a resource library source would cause processors to be removed
  • VERSION 1.72.0

    New Features

    • Add NATS Event Bus option to the init command
    • Add "Delete After Read" option to File source
    • Add resize handles to snapshot console
    • Support editing project names in the web interface

    Bug Fixes

    • Escape backslashes in filter by condition & add fields processors
    • Kubernetes agents telemetry port binds to all network interfaces
      • Resolves an issue where agents' metrics port was not reachable by Prometheus scrapers
    • Filter duplicate sources and destinations when adding new components to a configuration
    • Fixed an issue where customer resources were not available on free edition
  • VERSION 1.71.0

    New Features

    • TCP logs source: Support mutual TLS

    Bug Fixes

    • Syslog source: Set correct client ca file parameter
    • Prometheus destination: Remove duplicate TLS CA certificate option

    Other

    • BindPlane will prevent a rollout from starting if the configuration is using unlicensed components
      • This can happen when downgrading the license
  • VERSION 1.70.1

    Bug Fixes

    • Add additional sanitation and escaping to the /v1/agent-versions/:version/install-command API endpoint.
  • VERSION 1.70.0

    New Features

    • BindPlane SaaS: Support Multi Factor authentication
      • Email authentication users are urged to opt into MFA
      • Google authentication users can continue to use Google MFA without configuring BindPlane MFA.
    • Victoria Metrics destination

    SaaS Multi Factor Authentication

    Users can opt into multi factor authentication (MFA) by navigating to their project's "Users" tab and selecting the MFA toggle next to their username.

    Once the user is enrolled in MFA, MFA will be required for all of the users projects.

  • VERSION 1.69.0

    Bug Fixes

    • Resolved an issue with Bolt Store where agent status was reported incorrectly
    • Improve agents table measurements sort performance
    • Resolved an issue where mutual TLS would not use the configured certificate for verifying client certificates

    Deprecations

    Kafka Event Bus for BindPlane High Availability is deprecated, use the built in distributed eventbus. It is simpler to use and does not require additional infrastructure.

    note

    Kafka sources and destinations are unrelated and fully supported.

    Miscellaneous

    • Systemd: Increase default max open files from 55,000 to 65,000
  • VERSION 1.68.0

    New Features

    • BindPlane Managed Agent Labels
    • Added support for zstd compression to the Sumo Logic destination
    • Various Postgresql backend performance improvements

    Bug Fixes

    • Fixed an issue with the Sumo Logic destination's compression settings
    • Fixed an issue where the Summary page could show inaccurate data reduction values

    BindPlane Managed Agent Labels

    When an agent is connected for the first time, its OpAMP labels will be used as the initial set of labels. Future agent label changes will be stored on the BindPlane server only, they will not be sent to the agent.

    This allows BindPlane to be the single source of truth for agent labels and it prevents an agent reconfiguration due to label changes.

  • VERSION 1.67.0

    New Features

    • CLI: Support --selector and --query flags for label agents command
    • CLI: New init license command, for updating a Linux server's license
    • New CrowdStrike destination

    Bug Fixes

    • Fixed an issue with the Overview page's performance when working with an extreme amount of agents (> 100,000)
    • Fixed an issue where the Google Filter by Regex processor would fail to filter on attributes
    • Removed the Resource Detection from Live Preview to prevent confusing results
      • Resource Detection processor functionality should be checked by navigating to an individual agent and selecting "View Recent Telemetry".

    Label Agents Command

    You can now label agents based on criteria passed to the --selector or --query flags.

    bash
    1# label agents where the label env has values dev, test, or stage
    2bindplane label agents configuration=test --selector 'env in (dev,test,stage)' --overwrite
    3
    4# label agents where the label env has the value test
    5bindplane label agents configuration=test --query 'env:test' --overwrite

    Init License Command

    A new command is available for updating BindPlane's license. Similar to the init server command, the BindPlane license can be updated by executing the init license command on the BindPlane host.

    bash
    1sudo BINDPLANE_CONFIG_HOME=/var/lib/bindplane \
    2  /usr/local/bin/bindplane init license \
    3  --config /etc/bindplane/config.yaml

    note

    The command must be executed on the BindPlane Linux host to update the configuration file at /etc/bindplane/config.yaml.

  • VERSION 1.66.0

    New Features

    • Processor recommendation enhancements
      • When a processor is recommended, the processor node will be highlighted to notify the user.
      • Sumo Logic Windows Events recommendation will add the _sourceCategory and sumo.datasource attributes when sending Windows Events to Sumo Logic.
    • Extract Metric Processor enhancements

    Bug Fixes

    • Resolved an issue where the Overview page could show incorrect agent counts and status for a brief time after server restart

    Extract Metric Processor

    The new extract metric processor allows multiple metrics to be created in a single processor instance. Improvements on the previous processor include specifying the metric type, using an OTTL autocomplete field for the metric field parameter, and a variety of default units that can be selected from while still allowing custom units to be specified.

  • VERSION 1.65.1

    Bug Fixes

    • Skip client request retry on server 401 status.
  • VERSION 1.65.0

    New Features

    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.

    yaml
    1groups:
    2- name: configuration-rollups
    3  interval: 1m
    4  rules:
    5  - record: bindplane_agent_measurements:rollup:rate:1m
    6    expr: sum without (agent) (rate(bindplane_agent_measurements{}[1m9s999ms] offset 10s))
    7- name: 5m-configuration-rollups
    8  interval: 5m
    9  rules:
    10  - record: bindplane_agent_measurements:rollup:rate:5m
    11    expr: sum without (agent) (rate(bindplane_agent_measurements:1m{}[5m59s999ms] offset 10s))
    12- name: 1h-configuration-rollups
    13  interval: 1h
    14  rules:
    15  - record: bindplane_agent_measurements:rollup:rate:1h
    16    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".

    release-v1.65.0-0.png

    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.

    yaml
    1type: prometheus
    2interval: 10s
    3prometheus:
    4    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.

  • VERSION 1.64.0

    New Features

    • Add max log size option to Kubernetes Container source
    • New Parse Severity processor
      • Supports flexible parsing, such as parsing HTTP status codes.
      • Parse Severity v1 has been deprecated and should be replaced by the new processor.
    • New command bindplane init auth for updating the BindPlane server's authentication configuration

    Bug Fixes

    • Fail to save resources if all pipelines are disabled
      • The web interface will not allow you to save a resource that does not have logs, metrics, or traces enabled.
  • VERSION 1.63.1

    Bug Fixes

    • Fix rendering Windows Events sources using remote collection and custom channels.
  • VERSION 1.62.0

    New Features

    • New init ldap CLI command, for configuring and migrating authentication to ldap

    Bug Fixes

    • Return 401 for missing account header (measurements)
    • Enforce NATS mutual TLS
    • Conditional Builder Regex escaping

    Init LDAP

    When operating BindPlane OP on Linux, you can migrate to LDAP by executing the following command on the Linux server.

    bash
    1sudo BINDPLANE_CONFIG_HOME=/var/lib/bindplane \
    2    /usr/local/bin/bindplane init ldap \
    3    --config /etc/bindplane/config.yaml

    The command will prompt for your ldap server information, and migrate your BindPlane accounts to the new authentication mechanism.

    Upgrade Procedure

    After upgrading to BindPlane v1.62.0, review your configurations for pending rollouts. Update any configurations that contain processors with conditions built using the condition builder. Previous versions of BindPlane will have required the user to handle regex escaping on their own. v1.62.0 handles the escaping for you, however, existing conditions will need to be updated to take this into account.

  • VERSION 1.61.1

    New Features

    Bug Fixes

    • Add validation to guard against applying resources without metadata.name
    • Correctly handle deleting multiple configs
    • Handle duplicating configs without a current version

    Other

    • Rebrand Google Chronicle to Google SecOps

    NATS Event Bus

    Enterprise users operating BindPlane in High Availability can now use the NATS Event Bus. The NATS Event Bus eliminates the need for an external event bus such as Google Pub/Sub or Apache Kafka.

  • VERSION 1.60.0

    New Features

    Bug Fixes

    • Fix transform processor in Couchbase source
    • Fix small rollout segment width when configurations have a low agent count

    Other

    • Optimize agents GraphQL queries
    • Return 452 status when there is no license for the organization
    • Include error in log for BindPlane Transform Agent process
    • Upgrade to opamp-go v0.15.0

    Agent Metrics Port

    Agents managed by BindPlane expose metrics on TCP port 8888 by default. The port is now configurable using a global setting. Modifying the port will affect all agents.

    The BindPlane configuration file's advanced section can be updated to include the agent.telemetryPort option.

    yaml
    1advanced:
    2  agent:
    3    telemetryPort: 8888

    Modifying advanced options should be considered an advanced operation, and is not recommended unless guided by BindPlane support.

    OpAMP Authentication

    A new configuration section agents allow users to configure OpAMP authentication. Currently, secretKey is the only supported authentication type. It supports one or more headers. In this example, the BindPlane control plane will check for X-Bindplane-Authorization first and then Authorization if the first header is not present.

    yaml
    1agents:
    2  auth:
    3    type: secretKey
    4    secretKey:
    5      headers: 
    6      - X-Bindplane-Authorization
    7      - Authorization

    Modifying the agent authentication options should be considered an advanced operation, and is not recommended unless guided by BindPlane support.

  • VERSION 1.59.0

    New Features

    • Organizations and Projects
    • New Kubernetes Prometheus source
      • Detect and scrape Prometheus exporters using Prometheus Kubernetes service discovery.

    Bug Fixes

    • Google Cloud destination: Set location resource if not already set
      • Resolves an issue where Google rejects metric types that require a location.
    • Audit log CSV exporter now respects users timezone
    • Require configuration match labels
      • If match labels are not present, configuration=<configuration name> will be added automatically when creating a configuration using the API.

    Other

    • Agent's telemetry port 8888 will now bind to localhost on Linux, Windows, and macOS.
    • Deprecated Filter by Field processor in favor of Filter by Condition processor

    Organizations and Projects

    Starting in 1.59 each deployment of BindPlane OP will have a new top-level Organization made up of all the previous existing Accounts on the deployment. Accounts will now be referred to as Projects, which still contain all of the Agents and Resources associated with the account.

    Some things to note:

    • Any previous Admin level users now also receive the Organization Admin role. Organization admins can see all projects in an organization and any user that uses those projects.
    • Organization Admins can access the new Organization page found in the settings menu.
    • New Project creation is now limited to Organization Admins only.
  • VERSION 1.58.0

    New Features

    Bug Fixes

    Progressive Rollouts

    With Progressive Rollouts you can now deploy your configuration changes incrementally, one stage at a time. Tag specific agents as belonging to dev, stage, and prod environments and then BindPlane will pause the rollout after it completes each stage.

    The stages themselves are entirely configurable, so you can create the exact rollout that works best for your environment.

    Get started

  • VERSION 1.57.0

    New Features

    Updated telemetry displayed in the Edit Processors (Live Preview) dialog to show more detail.

    • Log
      • Added fields
        • observed_time
        • severity_number
        • severity_text
        • span_id.string
        • trace_id.string
    • Metrics
      • Support for histogram and exponential histogram metrics
      • Added fields
        • value_int
        • value_double
        • quantile_values
        • explicit_bounds
        • bucket_counts
        • count
        • sum
        • description
        • type
        • aggregation_temporality
        • is_monotonic
    • Traces
      • Added fields
        • span_id.string
        • parent_span_id
        • trace_id.string
        • kind
        • kind.string
        • status.code
        • status.message
    BindPlane OP v1.57.0 Notes 0
  • VERSION 1.56.0

    New Features

    • Additional TLS options for Postgres
    • An option to change the default gRPC max incoming message size on the OTLP and Bindplane Gateway sources
    • Storing attributes specified on OpAMP AgentDescription
    • Additional processor recommendations for parsing sev, severity field
    • Better visibility of deleted telemetry fields in Live Preview
    BindPlane OP Deleted Fields Styling

    Fixes

    • Delete fields properly deletes nested fields
  • VERSION 1.55.0

    New Features

    AWS S3 Rehydration Source

    v1.55.0 adds a new source for rehydrating data stored in an AWS S3 bucket. Read the source documentation here.

    Filter By Condition Processor

    Filter By Condition is a new processor introduced in v1.55.0. It can be used to include or exclude telemetry based on a condition that is evaluated against the telemetry data. Read the processor documentation here.

  • VERSION 1.54.0

    New Features

    • New nop destination
    • Processor Recommendations
    • Secret key management

    Processor Recommendations

    v1.54.0 introduces processor recommendations. BindPlane will recommend processors when viewing Live Preview.

    The initial release recommendation feature set includes the following recommendations:

    • Parse Log Body as JSON
    • Parse Severity
    • Remove Debug Logs
    • Remove Empty Values
    BindPlane OP Processor Recommendations

    Secret Key Management

    New CLI command for rotating secret keys. Run bindplane secret --help for details.

    bash
    1Manage secret keys
    2
    3Usage:
    4  bindplane secret [command]
    5
    6Available Commands:
    7  add         Add secret key
    8  default     Set default secret key
    9  delete      Delete secret key
    10  get         Get secret keys
  • VERSION 1.53.0

    New Features

    • New Telemetry Selector for components that support multiple telemetry types
    • Chronicle destinations are now supported when using a Google license

    Fixes

    • Improved agent heartbeat
      • Resolves an issue where agents could become disconnected when using a Kubernetes Service mesh such as Istio
  • VERSION 1.52.0

    New Features

    • New processor Condition Builder
      • Easily create OTTL conditions for most processors
      • See Upgrade and Downgrade for upgrade considerations
    • New Gateway source and destination
    • Add force_flush_period and max_log_size parameters to file log source

    Upgrade and Downgrade

    Downgrades from 1.52.0 to previous versions of BindPlane are not supported if you make use of the new OTTL condition builder feature. BindPlane 1.52.0 introduces a new parameter type that will not render

    Condition Builder

    The new condition builder allows the user to easily create OTTL.

    observIQ docs - Release v1.52.0 Condition Builder - image 1

    Bug Fixes

    • Minor UI fixes
  • VERSION 1.51.0

    New Features

    • New Resource Detection processor. The previous processor is deprecated, with this new one matching OTel capabilities.
      • New Detectors:
        • Consul
        • AWS EKS
        • Kubernetes
        • OpenShift
      • Adds support for user-provided list of detectors
    • Synthetic Telemetry Generator Source Type

    Bug Fixes

    • Various fixes for large-scale environments (100k agents)
    • Fix for connected agents sometimes appearing as disconnected in the UI

    Other

    • Improvements to resource display in Configuration topology
  • VERSION 1.50.0

    New Features

    • Agent labeling
    • New Logstash source

    Labels

    We added new functionality that allows users to assign custom labels to agents. Agent labels can be managed either individually or in bulk. To manage labels individually, users can click on the labels in the details of the agent. To manage labels in bulk, users can select multiple agents from the agents table and click the new “Manage Labels” button that will appear. In addition to this, labels are now displayed in the agents table. If labels are truncated in this view, users can use the hover interaction to display all labels.

    Bug Fixes

    • VMware vCenter: Resolved an issue where disabling TLS verification would not work
    • Move Fields Processor: Fixed OTTL exists condition
  • VERSION 1.49.0

    New Features

    Bug Fixes

    • Corrupted concurrent downloads of offline agent updates
    • Prevent scroll jitter in snapshot console
  • VERSION 1.48.0

    New Features

    • Resource Library adds the ability to unlink Sources and Processors
    • Application onboarding
    • Determining Agent capabilities from OpAMP
  • VERSION 1.47.0

    New Features

    • New Resource Library page for reusable Sources, Destinations, and Processors.
    • New Destination: Azure Monitor
    • New Destination: Snowflake
    • New Processor: Parse CSV
    • New Processor: Key Value processor
    • Add endpoint parameter to Honeycomb Destination.
  • VERSION 1.46.0

    Upgrade Notes

    important

    🚧 BindPlane v1.46.0 contains breaking changes.

    As of 1.46.0, Prometheus is required to store agent throughput measurements. Throughput measurement support has been removed from Bolt Store and PostgreSQL.

    Single-instance users do not need to take action. BindPlane will spawn a Prometheus sub-process automatically.

    High-availability users will need to make sure Prometheus is configured in their environment. Documentation for configuring Prometheus in a BindPlane HA architecture can be found here.

    Helm users should upgrade to chart version 1.2.0. Consult the chart release notes before upgrading. Once upgraded to Chart version 1.2.0, it is safe to upgrade to Chart version 1.2.1, which contains BindPlane v1.46.0.

    New Features

    • Added Splunk TCP source to Kubernetes Gateway Agent
    • Added Encoding param to Kafka destination
    • Added Optional Path Prefix parameter to OTLP HTTP
    • New Lookup Table processor
    • Agent health monitoring
    • Terraform Provider: Added support for Extensions

    Bug Fixes

    • Added missing TLS options to CLI
  • VERSION 1.45.0

    New Features

    • New Dynatrace Destination
  • VERSION 1.44.0

    New Features

    • Introduced search capability to processor live preview and agent recent telemetry
    • Added support for metrics to Azure Event Hub Source
    • Added TLS server name override option to OTLP destination

    Bug Fixes

    • Removed compression option from Splunk Cloud destination
      • Compression is always enabled
  • VERSION 1.43.1

    Bug Fixes

    Fixes an issue where changing the system account username would cause the user to lose access to their account.

    It is recommended that all users upgrade from 1.43.0 to 1.43.1.

  • VERSION 1.42.0

    New Features

    • Azure Event Hub Source

    Bug Fixes and Improvements

    • Improved OpAMP debugging

    Migration Notes

    This release includes a change that will break future downgrade compatibility for users with a single account boltstore installation of BindPlane. Before upgrading, those users should create a backup of their storage file, which can be used in the event of a downgrade.*

    To downgrade, those users should follow these steps:

    1. Stop the BindPlane service
    2. Replace the storage file with the backed-up version
    3. Restart the BindPlane service

    Changes made after upgrading will not be persisted when performing this downgrade.


    * If, instead, BindPlane is configured with either multi-account or postgres, this release is backward compatible and no action is needed to downgrade safely. BindPlane is multi-account if accounts.enable is true in its configuration:

    yaml
    1accounts:
    2  enable: true
  • VERSION 1.41.0

    New Features

    • New destinations
      • Observe, Inc
      • Chronicle Forwarder
    • Source changes
      • TCP Logs: Added new encoding option

    Bug Fixes and Improvements

    • Resolved an issue where Prometheus backed agent measurements were inconsistent in some cases

    Upgrade Procedure

    Prometheus

    Agent measurement values will be inconsistent in some situations. Upgrading to v1.41.0 solves this issue.

    If you are using BindPlane's built in Prometheus service, no action is required. If you are unsure, generally this means your BindPlane server is managing it's own Prometheus service behind the scenes. You can skip this procedure.

    If you are using a self managed Prometheus instance for your measurements backend, you must update your Prometheus recording rule at /etc/prometheus/rules.yml.

    yaml
    1groups:
    2- name: configuration-rollups
    3  interval: 1m
    4  rules:
    5  - record: bindplane_agent_measurements:rollup:rate:1m
    6    expr: sum without (agent) (rate(bindplane_agent_measurements{}[1m9s999ms] offset 10s))

    Once updated, restart the service.

    bash
    1sudo systemctl restart prometheus
  • VERSION 1.40.0

    New Features

    • UI will link out to resource (source, destination, processor, extension) documentation when viewing a given resource.
    • Add Compression Param to Chronicle
    • Support headers for http protocol on OTLP exporters
    • Extension: Go Performance Profiler (pprof)
    • Extension: Health Check

    Bug Fixes and Improvements

    • Improved live preview loading times
  • VERSION 1.39.0

    New Features

    • Summary Page Beta
    • Updated Configuration Editing flow
    • Kubernetes Gateway agent installation as deployment
    • File Source sort by mtime option.
    • Extension Audit Events
    • Automatic removal of unused deprecated resources
    • Improved error messages for CLI
  • VERSION 1.38.0

    New Features

    • Amazon Managed Prometheus destination
    • Honeycomb destination
    • Rename metric processor
    • Add sort by mtime option to file source
    • Extensions UI
    • Added TTL parameter to ClickHouse destination
    • Include support bundle script in releases
      • See /var/lib/bindplane/scripts/create-support-bundle.sh after upgrading
  • VERSION 1.37.0

    New Features

    • ClickHouse Destination Type
    • Jaeger OTLP Destination Type
    • Sumo Logic Destination Type
    • HTTPCheck Source Type
    • Extension Support
    • Optional Prometheus measurements database, promising much faster and more reliable measurements

    Bug Fixes

    • Ongoing UI polish
    • Severity processor now handles numeric values
    • Deleting configuration doesn’t leave zombie agents
    • Named source measurement fixes
    • Unmasking sensitive parameters in sources
  • VERSION 1.36.0

    New Features

    • Azure Blob Rehydrator Source Type
    • UI Updates and Polish
      • Improved Configuration details section
      • Agent Installation Wizard
      • Onboarding message for empty Agent and Configuration tables
      • Errored rollouts contain link to errored agents
    • init server improvements
      • Postgres configuration questions
      • Command offers to restart after running
      • Suggest users change from the default password if they are using admin
    • A new migration command to manage database migrations

    Bug Fixes

    • Many UI polish and spacing issues
    • Various init server command fixes

    Other

    • Correct swagger documentation for the /agents api endpoint.