Sensu Go release notes

Versioning

Sensu Go adheres to semantic versioning using MAJOR.MINOR.PATCH release numbers, starting at 5.0.0. MAJOR version changes indicate incompatible API changes; MINOR versions add backwards-compatible functionality; PATCH versions include backwards-compatible bug fixes.

Upgrading

Read the upgrade guide for information on upgrading to the latest version of Sensu Go.


5.10.2 release notes

June 27, 2019 — The latest release of Sensu Go, version 5.10.2, is now available for download. This is a stability release with a bug fix for expired licenses. See the upgrade guide to upgrade Sensu to version 5.10.2.

FIXES:

  • Sensu now handles expired licenses as expected.

5.10.1 release notes

June 25, 2019 — The latest release of Sensu Go, version 5.10.1, is now available for download. This release is a stability release with key bug fixes around proxy checks and entity deletion. See the upgrade guide to upgrade Sensu to version 5.10.1.

FIXES:

  • The proxy_requests entity_attributes are now all considered when matching entities.
  • Events are now removed when their corresponding entity is deleted.

5.10.0 release notes

June 19, 2019 — The latest release of Sensu Go, version 5.10.0, is now available for download. There are some exciting feature additions in this release, including the ability to perform advanced filtering in the web UI and use PostgreSQL as a scalable event store. This release also includes key bug fixes, most notably around high CPU usage. See the upgrade guide to upgrade Sensu to version 5.10.0.

NEW FEATURES:

  • (Licensed tier) The Sensu web UI now includes fast, predictive filtering for viewing checks, entities, events, handlers, and silences, including the ability to filter based on custom labels. Select the filter bar and start building custom views using suggested attributes and values. For more information, see the dashboard docs.
  • Free-tier Sensu instances can now delete entities in the web UI entities page. See the docs to get started using the Sensu web UI.
  • (Licensed tier) Sensu now supports using an external PostgreSQL instance for event storage in place of etcd. PostgreSQL can handle significantly higher volumes of Sensu events, letting you scale Sensu beyond etcd’s storage limits. See the datastore reference for more information.
  • Sensu now includes a cluster ID API endpoint and sensuctl cluster id command to return the unique Sensu cluster ID. See the cluster API docs for more information.

IMPROVEMENTS:

  • The sensuctl create command now supports specifying the namespace for a group of resources at the time of creation, allowing you to replicate resources across namespaces without manual editing. See the sensuctl reference for more information and usage examples.
  • Sensu cluster roles can now include permissions to manage your Sensu license using the license resource type. See the RBAC reference to create a cluster role.
  • The web UI now displays up to 100,000 events and entities on the homepage.
  • The Sensu API now returns 204 (No Content) responses for some POST and PUT endpoints. See the API docs for individual endpoint responses.

FIXES:

  • Sensu now optimizes scheduling for proxy checks, solving an issue with high CPU usage when evaluating proxy entity attributes.
  • The Sensu API now validates resource namespaces and types in request bodies to ensure RBAC permissions are enforced.
  • Check state and total_state_change attributes now update as expected based on check history.
  • Incident and entity links in the web UI homepage now navigate to the correct views.
  • The web UI now displays non-standard cron statements correctly, for example: @weekly.
  • On sign in, the web UI now ensures that users are directed to a valid namespace.
  • In the web UI, code block scrollbars now display only when necessary.
  • The web UI now displays the handler timeout attribute correctly.
  • When editing resources, the web UI now fetches the latest resource prior to editing.
  • The web UI now handles array values correctly when creating and editing resources.

5.9.0 release notes

May 28, 2019 — The latest release of Sensu Go, version 5.9.0, is now available for download. There are some exciting feature additions in this release, including the ability to log raw events to a file (licensed tier) and view event handlers in the web UI. See the upgrade guide to upgrade Sensu to version 5.9.0. If you’re upgrading a Sensu cluster from 5.7.0 or earlier, see the instructions for upgrading a Sensu cluster from 5.7.0 or earlier to 5.8.0 or later.

NEW FEATURES:

  • The Sensu web UI now includes a handlers page that displays available event handlers and handler configuration. See the docs to get started using the Sensu web UI.
  • (Licensed tier) Manage your Sensu event handlers from your browser: Sensu’s web UI now supports creating, editing, and deleting handlers. See the docs to get started using the Sensu web UI.
  • (Licensed tier) Sensu now supports event logging to a file using the event-log-file and event-log-buffer-size configuration flags. You can use this event log file as an input source for your favorite data lake solution. See the backend reference for more information.

IMPROVEMENTS:

  • The Sensu web UI now includes simpler, more efficient filtering in place of filtering using Sensu query expressions.
  • Sensu packages are now available for Ubuntu 19.04 (Disco Dingo). See the supported platforms page for a complete list of Sensu’s supported platforms and the installation guide to install Sensu packages for Ubuntu.

FIXES:

  • The occurrences and occurrences_watermark event attributes now increment as expected, giving you useful information about recent events. See the events reference for an in-depth discussion of these attributes.
  • The /silenced/subscriptions/:subscription and /silenced/checks/:check API endpoints now return silences by check or subscription.
  • Sensu now handles errors when seeding initial data, avoiding a panic state.

5.8.0 release notes

May 22, 2019 — The latest release of Sensu Go, version 5.8.0, is now available for download. This is mainly a stability release with bug fixes and performance improvements. Additionally, we have added support for configurable etcd cipher suites. See the upgrade guide to upgrade Sensu to version 5.8.0.

IMPORTANT:

  • To upgrade to Sensu Go 5.8.0, Sensu clusters with multiple backend nodes must be shut down during the upgrade process. See the upgrade guide for more information.

IMPROVEMENTS:

  • The sensuctl command-line tool now supports the --chunk-size flag to help you handle large datasets. See the sensuctl reference for more information.
  • Sensu backends now support the etcd-cipher-suites configuration option, letting you specify the cipher suites that can be used with etcd TLS configuration. See the backend reference for more information.
  • The Sensu API now includes the version API, returning version information for your Sensu instance. See the API docs for more information.
  • Tessen now collects the numbers of events processed and resources created, giving us better insight into how we can improve Sensu. As always, all Tessen transmissions are logged for complete transparency. See the Tessen reference for more information.
  • Sensu licenses now include the entity limit attached to your Sensu licensing package. See the license management docs to learn more about entity limits.
  • Sensu backends now perform better at scale using increased worker pool sizes for events and keepalives.
  • The maximum size of the etcd database and etcd requests is now configurable using the etcd-quota-backend-bytes and etcd-max-request-bytes backend configuration options. These are advanced configuration options requiring familiarly with etcd; use with caution. See the backend reference for more information.
  • Most Sensu resources now use protobuf serialization in etcd.

FIXES:

  • Events produced by checks now execute the correct number of write operations to etcd.
  • API pagination tokens for the users and namespaces APIs now work as expected.
  • Keepalive events for deleted and deregistered entities are now cleaned up as expected.

KNOWN ISSUES:

  • Auth tokens may not be purged from etcd, resulting in a possible impact to performance.

5.7.0 release notes

May 9, 2019 — The latest release of Sensu Go, version 5.7.0, is now available for download. This is mainly a stability release with bug fixes. Additionally, we have added support for Windows packages and updated our usage policy. See the upgrade guide to upgrade Sensu to version 5.7.0.

IMPROVEMENTS:

  • The Sensu agent for Windows is now available as an MSI package, making it easier to install and operate. See the installation guide and the agent reference to get started.

FIXES:

  • Sensu now enforces resource separation between namespaces sharing a similar prefix.
  • The sensuctl cluster commands now output correctly in JSON and wrapped JSON formats.
  • The API now returns an error message if label and field selectors are used without a license.

5.6.0 release notes

April 30, 2019 — The latest release of Sensu Go, version 5.6.0, is now available for download. We have added some exciting new features in this release including API filtering and the ability to create and manage checks through the web UI with the presence of a valid license key. See the upgrade guide to upgrade Sensu to version 5.6.0.

NEW FEATURES:

  • (Licensed tier) Manage your Sensu checks from your browser: Sensu’s web user interface now supports creating, editing, and deleting checks. See the docs to get started using the Sensu web UI.
  • (Licensed tier) The Sensu web UI now includes an option to delete entities.
  • (Licensed tier) Sensu now supports resource filtering in the Sensu API and sensuctl command line tool. Filter events using custom labels and resource attributes, such as event status and check subscriptions. See the API docs and sensuctl reference for usage examples.

IMPROVEMENTS:

  • (Licensed tier) Sensu’s LDAP and Active Directory integrations now support mutual authentication using the trusted_ca_file, client_cert_file, and client_key_file attributes. See the guide to configuring an authentication provider for more information.
  • (Licensed tier) Sensu’s LDAP and Active Directory integrations now support connecting to an authentication provider using anonymous binding. See the LDAP and AD binding configuration docs to learn more.
  • The health API response now includes the cluster ID.
  • The sensuctl cluster health and sensuctl cluster member-list commands now include the cluster ID in tabular format.

FIXES:

  • You can now configure labels and annotations for Sensu agents using command line flags. For example: sensu-agent start --label example_key="example value". See the agent reference for more examples.
  • The Sensu web UI now displays the correct checkbox state when no resources are present.

5.5.1 release notes

April 17, 2019 — The latest release of Sensu Go, version 5.5.1, is now available for download. This release is a stability release with key bug fixes, including addressing an issue with backend CPU utilization. Additionally, we have added support for honoring the source attribute for events received via agent socket. See the upgrade guide to upgrade Sensu to version 5.5.1.

IMPROVEMENTS:

  • Sensu agents now support annotations, non-identifying metadata that helps people or external tools interacting with Sensu. See the agent reference to add annotations in the agent configuration file.
  • The agent socket event format now supports the source attribute to create a proxy entity.
  • Sensu 5.5.1 is built with Go version 1.12.3.

FIXES:

  • Backends now reinstate etcd watchers in the event of a watcher failure, fixing an issue causing high CPU usage in some components.

5.5.0 release notes

April 4, 2019 — The latest release of Sensu Go, version 5.5.0, is now available for download. This release has some key bug fixes and additions including the introduction of Tessen into Sensu Go. For more information, we encourage you to read Sean Porter’s blog post on Tessen. See the upgrade guide to upgrade Sensu to version 5.5.0.

NEW FEATURES:

  • Tessen, the Sensu call-home service, is now enabled by default in Sensu backends. See the Tessen docs to learn about the data that Tessen collects.

IMPROVEMENTS:

  • Sensu now includes more verbose check logging to indicate when a proxy request matches an entity according to its entity attributes.

FIXES:

  • The Sensu web UI now displays silences created by LDAP users.
  • The web UI now uses a secondary text color for quick-navigation buttons.

5.4.0 release notes

March 27, 2019 — The latest release of Sensu Go, version 5.4.0, is now available for download. This release has some very exciting feature additions including the introduction of our new homepage. 5.4.0 also includes support for API pagination to more efficiently handle large data sets and agent buffering for robustness in lower connectivity situations along with key bug fixes. See the upgrade guide to upgrade Sensu to version 5.4.0.

NEW FEATURES:

  • The Sensu dashboard now includes a homepage designed to highlight the most important monitoring data, giving you instant insight into the state of your infrastructure. See the dashboard docs for a preview.
  • The Sensu API now supports pagination using the limit and continue query parameters, letting you limit your API responses to a maximum number of objects and making it easier to handle large data sets. See the API overview for more information.
  • Sensu now surfaces internal metrics using the /metrics API. See the metrics API reference for more information.

IMPROVEMENTS:

  • Sensu now lets you specify a separate TLS certificate and key to secure the dashboard. See the backend reference to configure the dashboard-cert-file and dashboard-key-file flags, and check out the guide to securing Sensu for the complete guide to making your Sensu instance production-ready.
  • The Sensu agent events API now queues events before sending them to the backend, making the agent events API more robust and preventing data loss in the event of a loss of connection with the backend or agent shutdown. See the agent reference for more information.

FIXES:

  • The backend now processes events without persisting metrics to etcd.
  • The events API POST and PUT endpoints now add the current timestamp to new events by default.
  • The users API now returns a 404 response code in the event that a username cannot be found.
  • The sensuctl command line tool now correctly accepts global flags when passed after a sub-command flag (for example: --format yaml --namespace development).
  • The sensuctl handler delete and sensuctl filter delete commands now correctly delete resources from the currently configured namespace.
  • The agent now terminates consistently on SIGTERM and SIGINT.
  • In the event of a loss of connection with the backend, the agent now attempts to reconnect to any backends specified in its configuration.
  • The dashboard now handles cases in which the creator of a silence is inaccessible.
  • The dashboard event details page now displays “-” in the command field if no command is associated with the event.

5.3.0 release notes

March 11, 2019 — The latest release of Sensu Go, version 5.3.0, is now available for download. This release has some very exciting feature additions and key bug fixes. 5.3.0 enables Active Directory to be configured as an authentication provider with a valid license key. Additionally, round robin scheduling has been fully re-implemented and is available for use. See the upgrade guide to upgrade Sensu to version 5.3.0.

NEW FEATURES:

  • Round-robin check scheduling lets you distribute check executions evenly over a group of Sensu agents. To enable round-robin scheduling, set the round_robin check attribute to true. See the check reference for more information.
  • Sensu now provides license-activated support for using Microsoft Active Directory as an external authentication provider. Read the authentication guide to configure Active Directory, and check out the getting started guide for more information about licensing.
  • The dashboard now features offline state detection and displays an alert banner in the event that the dashboard loses connection to the backend.

IMPROVEMENTS:

  • The agent socket event format now supports the handlers attribute, giving you the ability to send socket events to a Sensu pipeline. See the agent reference to learn more about creating and handling monitoring events using the agent socket.
  • Assets now feature improved download performance using buffered I/O.
  • The sensuctl CLI now uses a 15-second timeout period when connecting to the Sensu backend.
  • The dashboard now includes expandable configuration details sections on the check and entity pages. You can now use the dashboard to review check details like command, subscriptions, and scheduling, as well as entity details like platform, IP address, and hostname.

SECURITY:

  • Sensu Go 5.3.0 fixes all known TLS vulnerabilities affecting the backend, including increasing the minimum supported TLS version to 1.2 and removing all ciphers except those with perfect forward secrecy.
  • Sensu now enforces uniform TLS configuration for all three backend components: apid, agentd, dashboardd.
  • The backend no longer requires the trusted-ca-file flag when using TLS.
  • The backend no longer loads server TLS configuration for the HTTP client.

FIXES:

  • Sensu can now download assets with download times over 30 seconds without timing out.
  • The agent now communicates entity subscriptions to the backend in the correct format.
  • Sensu no longer includes the edition configuration attribute or header.
  • DNS resolution in Alpine Linux containers now uses the built-in Go resolver instead of the glibc resolver.
  • The sensuctl user list command can now output yaml and wrapped-json formats when used with the --format flag.
  • The dashboard check details page now displays long commands correctly.
  • The dashboard check details page now displays the timeout attribute correctly.

5.2.1 release notes

February 11, 2019 — The latest release of Sensu Go, version 5.2.1, is now available for download. This release is a stability release with a key bug fix for proxy check functionality. See the upgrade guide to upgrade Sensu to version 5.2.1.

FIXES:

  • Sensu agents now execute checks for proxy entities at the expected interval.

5.2.0 release notes

February 7, 2019 — The latest release of Sensu Go, version 5.2.0, is now available for download. This release has a ton of exciting content, including the availability of our first enterprise-only features. For more details on these features, see our blog post. 5.2.0 also has some key improvements and fixes; we added support for self-signed CA certificates for sensuctl, check output truncation, and the ability to manage silencing from the event details page on our web UI just to name a few. See the upgrade guide to upgrade Sensu to version 5.2.0.

IMPORTANT:

  • Due to changes in the release process, Sensu binary-only archives are now named following the pattern sensu-enterprise-go_5.2.0_$OS_$ARCH.tar.gz, where $OS is the operating system name and $ARCH is the CPU architecture. These archives include all files in the top level directory. See the installation guide for the latest download links.

NEW FEATURES:

IMPROVEMENTS:

  • Sensu now includes support for Debian 8 and 9. See the installation guide to install Sensu for Debian.
  • Sensu’s binary-only distribution for Linux is now available for arm64, armv5, armv6, armv7, and 386 in addition to amd64. See the installation guide for download links.
  • The Sensu dashboard now provides the ability to silence and unsilence events from the events page.
  • The Sensu dashboard entity page now displays the platform version and deregistration configuration.
  • sensuctl now supports TLS configuration options, allowing you to use a self-signed certificate without adding it to the operating system’s CA store, either by explicitly trusting the signer or by disabling TLS hostname verification. See the sensuctl reference for more information.
  • sensuctl now provides action-specific confirmation messages, like Created, Deleted, and Updated.

FIXES:

  • Check TTL failure events now persist through cluster member failures and cluster restarts.
  • The Sensu backend now correctly handles errors for missing keepalive events.
  • Token substituted values are now omitted from event data to protect sensitive information.
  • Sensu now correctly processes keepalive and check TTL states following entity deletion.
  • sensuctl can now run sensuctl version without being configured.
  • When disabling users, sensuctl now provides the correct prompt for the action.

5.1.1 release notes

January 24, 2019 — The latest patch release of Sensu Go, version 5.1.1, is now available for download. This release includes some key fixes and improvements, including refactored keepalive functionality with increased reliability. Additionally, based on Community feedback, we have added support for the Sensu agent and sensuctl for 32-bit Windows systems. See the upgrade guide to upgrade Sensu to version 5.1.1.

NEW FEATURES:

IMPROVEMENTS:

  • The Sensu agent and sensuctl tool are now available for 32-bit Windows. See the installation guide for instructions.
  • Keepalive events now include an output attribute specifying the entity name and time last sent.
  • The Sensu backend includes refactored authentication and licensing to support future enterprise features.

SECURITY:

  • Sensu 5.1.1 is built with Go version 1.11.5. Go 1.11.5 addresses a security vulnerability impacting TLS handshakes and JWT tokens. See the CVE for more information.

FIXES:

  • Keepalive events now continue to execute after a Sensu cluster restarts.
  • When requested, on-demand check executions now correctly retrieve asset dependencies.
  • Checks now maintain a consistent execution schedule following updates to the check definition.
  • Proxy check request errors now include the check name and namespace.
  • When encountering an invalid line during metric extraction, Sensu now logs an error and continues extraction.
  • sensuctl now returns an error when attempting to delete a non-existent entity.
  • sensuctl now removes the temporary file it creates when executing the sensuctl edit command.
  • The Sensu dashboard now recovers from errors correctly when shutting down.
  • The Sensu dashboard includes better visibility for buttons and menus in the dark theme.

5.1.0 release notes

December 19, 2018 — The latest release of Sensu Go, version 5.1.0, is now available for download. This release includes an important change to the Sensu backend state directory as well as support for Ubuntu 14.04 and some key bug fixes. See the upgrade guide to upgrade Sensu to version 5.1.0.

IMPORTANT:

  • NOTE: This applies only to Sensu backend binaries downloaded from s3-us-west-2.amazonaws.com/sensu.io/sensu-go, not to Sensu RPM or DEB packages. For Sensu backend binaries, the default state-dir is now /var/lib/sensu/sensu-backend instead of /var/lib/sensu. To upgrade your Sensu backend binary to 5.1.0, make sure your /etc/sensu/backend.yml configuration file specifies a state-dir. See the upgrade guide for more information.

NEW FEATURES:

  • Sensu agents now include trusted-ca-file and insecure-skip-tls-verify configuration flags, giving you more flexibility with certificates when connecting agents to the backend over TLS.

IMPROVEMENTS:

  • Sensu now includes support for Ubuntu 14.04.

FIXES:

  • The Sensu backend now successfully connects to an external etcd cluster.
  • SysVinit scripts for the Sensu agent and backend now include correct run and log paths.
  • Once created, keepalive alerts and check TTL failure events now continue to occur until a successful event is observed.
  • When querying for an empty list of assets, sensuctl and the Sensu API now return an empty array instead of null.
  • The sensuctl create command now successfully creates hooks when provided with the correct definition.
  • The Sensu dashboard now renders status icons correctly in Firefox.

5.0.1 release notes

December 12, 2018 — Sensu Go 5.0.1 includes our top bug fixes following last week’s general availability release. See the upgrade guide to upgrade Sensu to version 5.0.1.

FIXED:

  • The Sensu backend can now successfully connect to an external etcd cluster.
  • The Sensu dashboard now sorts silences in ascending order, correctly displays status values, and reduces shuffling in the event list.
  • Sensu agents on Windows now execute command arguments correctly.
  • Sensu agents now correctly include environment variables when executing checks.
  • Command arguments are no longer escaped on Windows.
  • Sensu backend environments now include handler and mutator execution requests.

5.0.0 release notes

December 5, 2018 — We’re excited to announce the general availability release of Sensu Go! Sensu Go is the flexible monitoring event pipeline, written in Go and designed for container-based and hybrid-cloud infrastructures. Check out the Sensu blog for more information about Sensu Go and version 5.0.

For a complete list of changes from Beta 8-1, see the Sensu Go changelog. Going forward, this page will be the official home for the Sensu Go changelog and release notes.

To get started with Sensu Go: