Release Notes #

See the updates and improvements in the latest releases of Satori.

v2.0.2 #

Released: October 7, 2024

Added #

  • Add Boolean, Number-Array, String-Array, Unix-Timestamp, Duration as core Validators.
  • Add support to arrays, time, and duration operators to Audience filter form mode.
  • Add support for Hiro-Auctions: feature flag, validator, and events.`
  • Add endpoint to download experiment phase’s results as a CSV file.
  • Add menu option to download phase results as a CSV file in the Console’s experiment details page"
  • Add status filter for experiments.

Changed #

  • Display the count in the tables for Audiences, Live Events, Experiments, Metrics, and Feature Flags.
  • Display property values containing unix timestamps as datetimes.
  • Update Hiro-Unlockables, Hiro-Economy, and Hiro-Inventory.
  • Improve performance by configuring BigQuery client to use gRPC.

Fixed #

  • Change input validator to support recovery codes.
  • Fix the validation of metric association on data imports.
  • Fix Live Events regression that prevent the system from loading recurring Live Events without an end.
  • Fix validation of conflicting Experiment Phase’ flags when configuring concurrent experiments.
  • Fix datalake event metadata loading for event’s affected by experiments using the ALL audience.
  • Modify example audiences to render correctly in Audience filter’s form mode.
  • Highlight APNs documentation link.

v2.0.1 #

Released: October 7, 2024

Added #

  • Add categorization of Live Events, Experiments, and Message Schedules in dashboard UI.
  • Allow associating categorization labels during the creation of Live Events, Experiments, Feature Flags, and Message Schedules.
  • Add the start time, end time, duration, and cron expr to API.GetLiveEvents.
  • Display the metric order, type, and composition in the Metrics’s Detail page.
  • Add search by status in Live Event and Experiments (UI).

Changed #

  • Reduce the amount of data loaded for the pages Live Event list and calendar.
  • Return metrics’ data as float64 instead of int64.
  • Use caches to avoid loading live event and/or experiment data when adding extra metadata to datalake’s events.
  • Improve the execution time of the Experiment Phase interruption.
  • Improve the performance of Feature Flag search (UI).
  • Improve UI copy.

Fixed #

  • Setup of the buffer processor metrics.
  • Permissions required to interrupt an experiment phase.
  • Configure gRPC gateway to use structured JSON logging.
  • Fix display of Experiment Phase’s metrics with the width of 1h.

v2.0.0 #

Released: August 16, 2024

Added #

  • Add audience filter visual expression editor.
  • Add Experiment calendar listing endpoint to power dashboard UI’s calendar view for experiments.
  • Allow users to assign a color to experiments in the dashboard UI.
  • Set fundamental metrics as core concepts that are immutable.
  • Add creation and modification wizards for Live Events and Experiments.
  • Add Experiment templates powered by Hiro (Dynamic pricing and timed offers).
  • Add Live Event templates powered by Hiro (Dynamic pricing and timed offers).
  • Add schema validators, metrics, and feature flags that support Hiro templates as core concepts.
  • Add buildNumber, city, platform, pushTokenHuawei, pushTokenIos, and state as default properties for identities.
  • Extended audit log of all operations performed through the dashboard UI.
  • Add new S3 Data Lake integration.
  • Allow Satori instances to import the definitions of multiple entities from other Satori instances.
  • Allow admins to set the preferred timezone that timestamps should be display in across dashboard UI.
  • Add title and image_url to the identity inbox and message listing operations.
  • Add location information derived from GeoIP data to events sent to datalakes.
  • Add identity context information to events sent to datalakes, e.g, current audiences, live events, experiment, custom properties, and session metadata.
  • Request audience membership recalculation when previously defined events are published.
  • Represent identity’s computed properties on the value field as floats, i.e. valueSum, valueHigh, and valueLow.

Changed #

  • Vastly improved dashboard UI experience.
  • Better encoding, compression, and delivery of dashboard UI static assets.
  • Improve value editor interfaces across the dashboard UI.
  • Increase the number of data points returned by the metrics endpoint by default.
  • Update UI assets build process in order to use Heroic Labs’s new design system.
  • Unify the creation/update of an Experiment and its dependencies in one single operation to avoid interference from concurrent changes.
  • Unify the creation/update of an Experiment phase and its dependencies in one single operation to avoid interference concurrent and/or temporary changes to experiment grouping the phase.
  • Unify the creation/update of a Live Event and its dependencies in one single operation to avoid interference from concurrent changes.
  • Rename Experiment phase stop operation to Experiment phase interrupt.
  • Adjust the dashboard UI default session token configuration.
  • Replace default purchaseCompleted metric by a Revenue metric.
  • Add SessionLength, AverageSessionLength, SessionCount, InstallationCount as standard metrics across the dashboard UI.
  • Improve performance of request handling across all API endpoints.
  • Reduce database resource usage by unifying all metric calculations.
  • Improve performance of the continuous Audience processing system.
  • Increase the maximum length of Event value fields.
  • Improve pagination for endpoints that list Message Schedules, participants and candidates of Live Events, and candidates of Experiment Phases.
  • Improve performance when deleting audiences with large identity membership.
  • Remove the restriction on the value length for default properties.
  • Allow users to define the delivery mechanism used by Message Schedules.
  • Add Categories as a new Taxonomy configuration.
  • Add categorization of Feature Flags in dashboard UI.
  • Improve error handling semantics across all API endpoints.
  • Experiment phases are now returned as part of the same Experiment retrieval structure.

Fixed #

  • Gracefully handle badly formatted tokens.
  • Block the deletion of Metrics referenced by other Metrics in the dashboard UI.
  • Return Feature Flag information per each experiment phase returned by the Experiment phase listing operation.
  • Fill the position field of the Flag retrieval operation.
  • Update ACL for Identity retention access.
  • Avoid classifying self-references as external references in schema validators.
  • Fix the overlap verification of Feature Flags associated to Live Events using the Live Event flag creation operation.
  • Correctly handle all edge cases for Audience overrides and exclusion evaluation in the Audience processor.
  • Correctly apply structured logging to the Data Lake client for Snowflake.
  • Fix the reporting format of Event processors.
  • Fix the format of Live Event run listings in the dashboard UI.

v1.8.5 #

Released: July 30, 2024

Added #

  • Easier configurability for maximum feature flag value sizes.

Changed #

  • Increase default maximum feature flag value size from 64 KB to 128 KB.

v1.8.4 #

Released: July 30, 2024

Added #

  • Always set a default limit for dashboard UI message listings.

Fixed #

  • Exclude holdouts from dashboard UI identity live events view.
  • Exclude holdouts from dashboard UI identity feature flag view, when the flag value is determined by an active live event.

v1.8.3 #

Released: April 9, 2024

Changed #

  • Ensure audience processing logs more concise useful information.

v1.8.2 #

Released: April 9, 2024

Added #

  • Add JSON editor for Experiment flag variant overrides in the dashboard UI.
  • Progress indicator for dashboard UI data management actions.
  • New dashboard UI hints for Audience filter expressions.
  • Extend list of default supported event names.
  • More relevant data exposed in _liveEventJoin event.

Changed #

  • Feature Flag changes now require confirmation through a modal.
  • Dashboard UI scaling and polish updates.
  • Better responsive dashboard UI handling on Live Events participants view.
  • Improve parallelism in background Audience processing.

Fixed #

  • Improve Redshift data lake connection stability.
  • Clarify event name used in Redshift data lake adapter.
  • Ensure UTC timezone is used for all metrics continuous aggregates and convert to local time at point of display only.

v1.8.1 #

Released: April 9, 2024

Added #

  • New Metrics type support for more complex “hybrid” metrics.

v1.8.0 #

Released: April 9, 2024

Added #

  • New Retention graphing feature in dashboard UI.
  • OneSignal message transport support.
  • Deletion confirmation modals now highlight the name of the item being deleted.
  • Add endpoint name as label in exported Prometheus metrics data.
  • Show immediate Schema outward references in dashboard UI.
  • Add new default Audiences for commonly used country groupings.
  • Improved Live Event results view in dashboard UI.

Changed #

  • Adjust default event retention window.
  • Live Event and Experiment details dashboard UI improvements.
  • Better Data Management dashboard UI controls and modals.
  • Always open documentation links in new browser tabs for convenience.
  • No longer strictly require description fields on creates or updates.
  • Metric creation includes a more verbose check for description field length.

Fixed #

  • Clarify errors on schema validation rejections shown in the dashboard UI.
  • Correctly set session keepalive config on Snowflake data lake connections.
  • More useful information added to logs for token rejections.
  • Fix dashboard UI visual artefact on deleting metrics.
  • Fix display of phase metric results that have no events.
  • Correct binomial metric query reliability for varying data.
  • More useful information added to logs on context cancellations.
  • Fix appearance of a duplicated event on Live Event and Experiment joins.
  • Faster loading of modals with JSON editor components.
  • Fix dashboard UI scaling for large Audience filter expressions.
  • Correctly handle creation of complex Feature Flags when using the UI form view.
  • Fix dashboard UI graphing layout for Experiment results.

v1.7.7 #

Released: April 9, 2024

Fixed #

  • Correct Live Event membership tracking displayed in dashboard UI.
  • Ensure concurrent requests for event retrieval are identified separately in logs.

v1.7.6 #

Released: April 9, 2024

Fixed #

  • Load audience names on initial flag retrieval operations to avoid a round trip.

v1.7.5 #

Released: April 9, 2024

Changed #

  • Audience filter property lookups now handle stored empty property values based on the type of the default input.

Fixed #

  • Consistently handle order of audiences in live event edge processing to ensure directly comparable measurements across process instances.

v1.7.4 #

Released: April 9, 2024

Fixed #

  • Fix Feature Flag search field visual placeholder in dashboard UI.
  • Fix value editor validation state when transitioning views.
  • Ensure consistent Live Event flag override variant processing order.
  • Clean up handling of logs for concurrent authentication operations for the same identity.

v1.7.3 #

Released: April 9, 2024

Added #

  • Allow schema value to be set directly in the new schema creation modal.

Changed #

  • Ensure all client endpoints return an accurate error if the identity making the call does not exist.
  • Audience filters now parse string property values as floats where possible.

Fixed #

  • Hide schema request warning from value field editor.

v1.7.2 #

Released: April 9, 2024

Changed #

  • Better handling of large numbers in computed properties updates.

Fixed #

  • Correctly display Live Event flag override variants configuration in Identity Feature Flags page.

v1.7.1 #

Released: April 9, 2024

Changed #

  • Serve monaco editor assets from assets path consistent with other UI elements.

v1.7.0 #

Released: April 9, 2024

Added #

  • New core schema validator for ’empty’ values.
  • Introduce audience-based variants for Live Event feature flag overrides.
  • Dashboard elements to attach messages schedules to live events outside the live event details page.
  • Introduce monaco editor for large text inputs.

Changed #

  • Sample data now triggers graph display in experiment phase results.
  • Better log messages when property updates are rejected.
  • Use constant data for rendering preview message templates.
  • Preview message templates as soon as page is shown.
  • Audience filters now attempt to parse property values according to type of default value given.
  • Improve message scheduling reference anchors for schedules tied to Live Events.

Fixed #

  • Consistent schema usage when creating Big Query data lake export destination.
  • Correct dashboard validation for values governed by the ’empty’ schema.
  • Fix UI sizing for Experiments and Live Events with large value fields.
  • Fix update of message schedule relative offset when corresponding Live Event is moved.
  • Ensure disabled audiences/holdouts are not selectable in dropdowns.
  • Fix sidebar scrolling issue on small screen displays.
  • Fix accessibility hints for dashboard form inputs on the login page.
  • Ensure Live Events are fully re-validated when updating holdouts.

v1.6.6 #

Released: April 9, 2024

Fixed #

  • Fix identifier selection in feature flag variant imports.

v1.6.5 #

Released: December 5, 2023

Changed #

  • Allow event metadata up to 4096 bytes, up from 1024 bytes.
  • Build with Go 1.21.4 and use Debian bookworm-slim for base docker images.

v1.6.4 #

Released: October 30, 2023

Added #

  • Create a v2 continuous aggregate for events to speed up event stats query.

Changed #

  • Switched relevant socket metrics to use v2 events count aggregate.
  • Enable Prometheus by default on port 7452.
  • Return better errors on client API in cases of no identity found.

v1.6.3 #

Released: October 11, 2023

Added #

  • Support for Facebook App-to-User messaging.

Changed #

  • Build with Go 1.21.3.

Fixed #

  • Enable form view if schema type is absent and its inferred type is an object.
  • Fix horizontal tab navigation errors.
  • Force max modal width on Audience create.

v1.6.1 #

Released: September 21, 2023

Added #

  • Add Live Event option to toggle membership binding.

Fixed #

  • Fix issue with observing Live Event edges when computing Flag overrides.

v1.6.0 #

Released: September 18, 2023

Added #

  • Continuous aggregate to pre-compute experiment phase metrics.
  • Display phase metrics as graphs for continuous aggregate queries.
  • Add continuous aggregates to improve socket metrics performance.
  • Add optional experiment max participant threshold.
  • Allow listing of experiment phase and variant participants.
  • Allow assigning identities directly to experiment phase variants via console.
  • Allow moving identities to different experiment phase variants via console.
  • Add option to export experiment phase variants as flag variants.
  • Expose metrics for client API, console API, and event processing components.
  • Syntax highlighting and completion for audience filter expressions in console UI.
  • Add console UI views for identity message listings and pagination.
  • Add semver utility functions to available audience filter elements.
  • Add support for holdouts to live events configuration.
  • Add synthetic event when an identity joins a live event.

Changed #

  • Allow client API property update operations with only audience re-computation specified.
  • Filter out invalid or unknown properties in client API property update operations.
  • Open info modal in console UI after user creation.
  • Avoid unnecessary logging of context cancelled errors.
  • Console schema validator inference now inspects first element of an array.
  • Ensure identities remain part of live events until the next reset.
  • Build with Go 1.21.1.

Fixed #

  • Ensure API spec lists schema ID inputs as required.
  • Fix event conversion and delivery to Snowflake data lake.
  • Correctly handle audience creation in the console UI when using the ALL audience as base.
  • Ensure console UI sidebar footer renders correctly when items are hidden due to insufficient permissions.

v1.5.1 #

Released: August 16, 2023

Fixed #

  • Fix dynamic form building for schemas with patternProperties syntax.
  • Remove unwanted link to live event details in general message schedule view.
  • Fix dialog typo in experiment variant identities export.are changed.

v1.5.0 #

Released: August 8, 2023

Added #

  • New Geo-IP resolved default properties for “state” and “city”.
  • Extended Data Management tab in Settings panel.
  • Ability to re-insert default data such as audiences bundled with every fresh deployment.
  • Client API endpoint to delete the caller’s identity and data.
  • Data Management options to delete data from the console UI.
  • New details page for individual Live Events.
  • New templates feature to manage client-facing multi-language text elements.
  • Schedule outgoing messages to be delivered relative to Live Event start and end times.
  • AppNava ML data lake target support in underlying adapters.
  • Data Management options to export configuration data from the console UI.
  • Add column for Feature Flag default value in console UI flag list.
  • Add column for Feature Flag variant count in console UI flag list.
  • Add optional descriptions for Feature Flags.
  • Add filtering to Feature Flag listing view in the console UI.
  • Include AppNava Data Lake status in Stats endpoint response.
  • Add initial properties to _identityCreate event.
  • Allow clients to request recompute of audience memberships on properties update operations.
  • Allow multiple metrics to be defined for each event name.
  • Allow experiments to override same feature flags on disjoint audience/holdout configurations.
  • Add _experimentJoin event when an identity first joins a phase, including experiment/phase/variant info.
  • Allow easy creation of new audiences using existing ones as a base definition.
  • Add ‘platform’, ‘version’, and ‘buildNumber’ as new default properties.
  • Import/Export of configuration, taxonomy, and related data.
  • Add button to export phase variant participants to new audience definitions at the end of a phase.

Changed #

  • Update IP2Location database, use DB3 LITE instead of DB1 LITE source for extra region and city info.
  • Remove query workarounds needed for older timescale-toolkit versions.
  • Remove “toolkit_experimental” prefix from “approx_count_distinct” query usage.
  • Build UI assets with cache busting options enabled by default.
  • Upgrade to pgx v5.
  • Allow Feature Flag values and variant values up to 64KB.
  • Add 0.5x to 1.5x jitter between audience processor runs.
  • Clarify wording in Server Key management popup.
  • Use console wait/timeout configured values for /stats endpoint on the metrics port.
  • Unknown properties submitted from clients will now be ignored, instead of returning an error.
  • Better formatting of identity counter in audience view.
  • Improved schema format for BigQuery Data Lake adapter to expand metadata fields.

Fixed #

  • Fix restriction on selecting event metadata schemas.
  • Remove un-toggleable ‘Reset schedule’ input.
  • Fix ACL requirements for endpoints.
  • Forcefully log out console users when their permissions or other details are changed.

v1.4.1 #

Released: June 14, 2023

Fixed #

  • Fix issue where templates were still being unnecessarily resolved.

v1.4.0 #

Released: June 14, 2023

Added #

  • New validation schemas feature.
  • Split key selection options for experiments.
  • Add option to delete experiment variants.
  • Add option to copy password reset link in user management modals.

Changed #

  • Rename title of identity properties add modal.

Fixed #

  • Fix intermittent issue where audience cache may be out of sync.
  • Fix intermittent issue where API key cache may be out of sync.
  • Fix intermittent issue where server key cache may be out of sync.

v1.3.5 #

Released: May 25, 2023

Added #

  • Server key management endpoints and UI.

Changed #

  • Build with Go 1.20.4.
  • Allow multiple server keys with individual permissions.

Fixed #

  • Fix console UI Settings submenu routing when user does not have User Management permissions.
  • Fix Experiment Flag value fields not being editable on variant creation and update.

v1.3.4 #

Released: May 11, 2023

Fixed #

  • Fix nil pointer in audience processor identity pagination.

v1.3.3 #

Released: May 11, 2023

Added #

  • Add dropdown to select properties to add in Identity Properties view.
  • Add “pretty JSON” button to Feature Flag detail view flag value field.
  • Add “pretty JSON” button to Feature Flag variant modal value field.

Changed #

  • Experiments now disallow same metric on both goal and monitor lists.
  • Avoid sending unnecessary deletes and inserts for audience edges during audience processor runs.
  • New icon for Data Lakes sidebar item.
  • Remove ID column from Metrics list view table.
  • Feature Flag detail view shows larger default field for flag value.
  • Make Feature Flag variant modals larger by default.
  • Updated Experiment detail view layout.
  • Use updated Satori logos throughout the UI.
  • More efficient workload distribution to audience processor workers.

Fixed #

  • Add missing ExperimentFlagAdd ACL permission.
  • Delete button no longer scrolls out of view in Metrics list view table.

v1.3.2 #

Released: April 24, 2023

Added #

  • Add custom metric detail view.
  • Add custom metric graphs and controls in metric detail view.

Changed #

  • Update expr dependency, improve performance of generic registered functions.
  • Reduce use of large string concatenation in audience processor worker.
  • Build with Go 1.20.3 and use Debian bullseye-slim for base docker images.
  • Eliminate use of reflection-based functions with expr in the audience processor.

Fixed #

  • Fix missing Experiment Variant endpoint permission handling.

v1.3.1 #

Released: April 10, 2023

Changed #

  • Include experiment phase start time in variant selection hash input.

Fixed #

  • Introduce IPv6 GeoIP lookup data in addition to existing IPv4.
  • Allow identity properties form to submit with empty computed property values.

v1.3.0 #

Released: March 10, 2023

Added #

  • Add tooltips to metric creation dialog.
  • Add optional default and custom properties input to authentication operation.

Changed #

  • Experiment phases now show partial results while the phase is still in progress.
  • Hide Split Key fields from all UI areas.
  • Update GeoIP embedded file format.
  • Update GeoIP database to latest available version as of 2023-02-24.
  • Make config export button more visible on Settings > Configuration tab.
  • Include total identity count in audience details view.
  • Rename “Users” to “Identities” on experiment phase results.
  • Clicking the audience in identity audiences view now redirects to the audience details.
  • Rename “Flag Name” to “Variant Name” in feature flag variants table header.
  • Do not highlight all experiment phase variants as best if all their values all zero.

Fixed #

  • Allow sample data deletion to succeed even if some of it is still referenced.
  • Prevent accidental bypass of the confirmation word when pressing enter on the form.
  • Enforce typing out the confirmation word by turning off input autocomplete/suggestions.
  • Disabling data lake adapters now requires typed confirmation.
  • Rotating API keys now requires typed confirmation.
  • Rotating the server key now requires typed confirmation.
  • Fix NaN experiment phase result variant values.
  • Do not allow ALL audience in experiment holdouts.
  • Do not allow experiment audiences and holdouts to contain any overlapping audiences.

v1.2.0 #

Released: March 2, 2023

Added #

  • Live events can now override feature flag values.
  • Live events calendar view.
  • New sample data live event “VIP-Guilds-Event” that resets every Sunday and runs for 2 hours.

Changed #

  • Rename “Source” to “API Key” in identity events view.

v1.1.1 #

Released: February 8, 2023

Changed #

  • Better error messages when failing to insert sample data.

Fixed #

  • Fix a routing bug with the registered path for fetching console configuration data.

v1.1.0 #

Released: February 8, 2023

Added #

  • Experiments can now override feature flag values.
  • Add sample data to showcase experiment feature flag overrides.
  • Dedicated configuration view in the settings panel.
  • Better audience filter, overrides, and excludes tooltip info about audience processor timing.

Changed #

  • Move data lakes view to the top level in the sidebar.
  • Filter out session start events from trying to affect their own session duration.

Fixed #

  • Do not double-count identity creations when identifying as a new ID.
  • Do not create a new session when identifying as a new ID.
  • Correctly disregard old experiment phase memberships when a new phase starts.
  • Fix label for console user password resets.