This documentation is for a previous version of Cerbos. Choose 0.34.0 from the version picker at the top right or navigate to https://docs.cerbos.dev for the latest version.

Cerbos v0.32.0

Highlights

This release includes a major update to the Cerbos internals to fully migrate from OpenCensus to OpenTelemetry for distributed traces and metrics. Migrating to OpenTelemetry gives users the ability to use push metrics, fine tune trace sampling, and integrate Cerbos with the wider ecosystem of observability products that support the OpenTelemetry protocol (OTLP). As part of this migration, configuring traces using the tracing block of Cerbos configuration file is now deprecated and we advise users to migrate existing configuration to use the well-known OpenTelemetry environment variables instead. Support for the Jaeger native protocol has been deprecated as well in favour of OTLP and it will be removed in the next release of Cerbos along with support for trace configuration via the tracing configuration block.

While we have strived to keep all metric names unchanged, some subtle differences between OpenCensus and OpenTelemetry instruments might have an impact on your existing dashboards and metric-based alerts. Please review your dashboards and metric-based alerts after the upgrade to make sure they are still functioning as expected.

The policy test framework now includes support for defining the contents of globals per test case or for the whole test suite.

When running tests with the --verbose flag, the result output will now include the expected effects and policy outputs for successful test cases as well.

Changelog

Bug Fixes

  • Ignore empty files in policy repository (#1882)

Features

  • Better support for OTLP (#1886)

  • BREAKING Switch metrics to OpenTelemetry and add support for push metrics (#1887)

Enhancements

  • Detect and warn about invalid test suites (#1868)

  • Include expected effect and outputs for successful tests (#1881)

  • Mirror Cerbos image to Docker Hub (#1867)

Documentation

  • Remove outdated playground section (#1864)

Chores

  • Access to check options from custom checkers (#1861)

  • Add pre-cache API to TestFixtureGetter (#1866)

  • Add tests to check fixture loading from testdata (#1877)

  • Allow LoadTestFixture to continue on error (#1859)

  • Bump github.com/sigstore/cosign/v2 from 2.0.3-0.20230523133326-0544abd8fc8a to 2.2.1 in /tools (#1869)

  • Bump go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc from 0.45.0 to 0.46.0 (#1871)

  • Bump version to 0.32.0

  • Enable Otel interceptor for grpc-gateway client (#1892)

  • Fix Kafka integration tests (#1878)

  • Fix legacy OTLP exporter initialization (#1891)

  • Replace deprecated GoReleaser --skip-publish flag (#1893)

  • Simplify residual expression (#1876)

  • Update amannn/action-semantic-pull-request action to v5.4.0 (#1862)

  • Update bufbuild/buf-setup-action action to v1.28.0 (#1873)

  • Update github actions deps (#1884)

  • Update go deps (#1863)

  • Update go deps (#1874)

  • Update go deps (#1885)

  • Update go deps (#1888)

  • Upgrade to CEL 0.18 (#1860)