Skip to main content
You are viewing the documentation for Interana version 2. For documentation on the most recent version of Interana, go to


Scuba Docs

Interana 2.24 Release Notes

This document introduces new features included in Interana release 2.24 and lists newly resolved and known issues.

See Release, and 2.24.4 for information on the latest maintenance releases.

New features

Interana release 2.24 includes the following new features:

New installation and configuration tools

You can now install and configure a single or multi-node Interana cluster on any private cloud provider (AWS, Azure, GCP) or on-premises hardware (with VMWare) to run and manage yourself. See the Admin Guide for more information, or see the Sandbox Deployment Guide if you want to quickly set up a single-node cluster on AWS. 

There's also a newly improved command-line interface (CLI) that you can use to install, configure, and maintain your Interana cluster. See the Interana CLI reference for more information. 

Streaming ingest API

To support the new ingest methods, we've built a streaming ingest API. This allows Interana to accept events via an add_events HTTP API (rather than only accepting events in the form of files). See Configuring the Interana SDK for ingest for more information. 

JavaScript SDK

Interana's JavaScript SDK can be used for tracking events and sending them to Interana via the streaming ingest API. You can use the CLI to create a pipeline and job to ingest these events into an Interana table. See the SDK guide for more information.

New integrations with Segment, mParticle, and Kafka

As of version 2.24, you can use webhooks to connect your Segment data source to Interana for data ingestion. See the Segment integration cookbook for more information.

You can also use the Interana Transformer Library to transform your mParticle data logs and import data into Interana. See the mParticle integration cookbook for more information. 

We also support ingesting data directly from a Kafka system. An Interana admin can set up a pipeline to consume directly from an external Kafka topic. See Create a pipeline for an existing Kafka cluster for more information. 

Easier exploration from dashboards

When exploring from our living dashboards, you can now open a query in a new tab by right-clicking on the Explore link. Alternatively, you can press Control-click (on Windows) or Command-click (on Mac) to open the link in a new tab.

Support diagnostics file

Users of our Growth Edition can export a diagnostics file to share with the Interana support team. This diagnostics file has information about the OS, memory and disk usage, log files, and general system stats. This file can be created by running: 

sudo /opt/interana/backend/deploy/

See Create a support diagnostic file for more information about the contents of this file. 

Cluster usage loopback

Interana Growth Edition customers may choose to analyze the query usage of their own cluster. Users create a table to "loopback" query and ingest logs into an Interana table. Here are the current steps to enable the feature on the latest 2.24:


ia table create event QUERY_TABLE "__time__" milliseconds username
ia settings update usage_loopback query_table QUERY_TABLE
(on the API node) iactl restart


ia table create event INGEST_TABLE "__time__" milliseconds <pipeline_id>
ia settings update usage_loopback ingest_table INGEST_TABLE
(on every import node) iactl restart

See Analyzing Interana logs for more information. 

Log-based monitoring

We currently have monitors and alerts for our Managed Edition customers using Datadog. For Growth Edition customers, we now have now made a collection of Interana log messages available via syslog so customers can monitor using their own system. See How to analyze Interana logs with Datadog to learn how to use this feature.

Improved session metrics

Based on feedback from our users, we have changed the way we calculate session metrics. As of 2.24, only events that satisfy the session filter are included in session metric calculations.

Kafka Ingest

Users can now configure Interana to consume from an external Kafka topic.

Resolved issues

HIG-9113 Headers in export files from Bar and Pie views include Javascript codes
HIG-9375 Clone job and Edit job operations do not work for datasets with continuous Import
HIG-9531 First last aggregators with string derived column returns string ID instead of string value
HIG-10161 During import, auto-detect misinterprets time columns as hex columns.
HIG-10187 Per-session metric values change when user adjusts the time frame
HIG-10625 String queries are blocked during rebalance operations
HIG-10820 Monthly resolution snaps end time to 18 days after written end time
HIG-10862 Cohort end time "today" is interpreted as "now." With this fix, "Today" is interpreted properly (12:00 AM of the current day). This applies only to newly created or edited cohorts. For existing cohorts, you must change the start / end time to “today” to apply the change.
HIG-11013 Session Restart Event disappears after saving a new session
HIG-11018 External API rate limit settings are not working
HIG-11024 Sending precacher missing cache key events to syslog makes syslog very large
HIG-11049 Samples export includes usage log data in the bottom row
HIG-11060 Query returns "write() send(): Broken pipe" error
HIG-11141 Application settings added with the command line interface are not prepended with dashes

Known issues

HIG-8746 static_string type derived columns appear as options in aggregation functions.
HIG-9505 Cannot share a query for Distribution view that uses unpublished metrics.
HIG-9809 Must refresh to apply a column name change made from data tooltips in the Explorer.
HIG-10159 In the Explorer, scrolling doesn't work when the mouse pointer is on a table view.
HIG-10168 A dashboard that points to a non-existent table results in a confusing error message.
HIG-10170 Copying an invalid cohort is allowed, which then causes the UI to hang.
HIG-10180 Filter this out selects the contents of the entire table row instead of the column that was selected.
HIG-10194 Queries run while rebalancing return inaccurate results.
HIG-10268 If you re-use the name of a deleted table, the old derived columns appear in the new table as deleted.
HIG-10285 Admins are unable to edit the last column in datasets.
HIG-10289 Unable to make decimal columns aggregable.
HIG-10383 An edited metric does not update with new information until you perform a hard refresh.
HIG-10462 Newlines in advanced filter text break permalinks.
HIG-10485 Text no longer wraps for small dashboard charts, and cuts off the very bottom of the text for the first line.
HIG-10716 Emailed stacked bar dashboard charts lose sort order
HIG-10735 No visual indicator when pasting an API token when using the CLI 
HIG-10891 The enabled parameter of the update auth password_auth command does not correctly enable password authorization requirements.
HIG-11026 In Explorer filters, if you exact match the name of a named expression, the named expression is added to the filter.
HIG-11028 In some cases, creating a Time view query using monthly resolution shows an extra month of data before the specified start time
HIG-11034 Recreating a table with the same name as a deleted table inherits schema from the deleted table.
HIG-11406 Interana includes a samplesAlways attribute when exporting a table using the ia table exportcommand. You must manually remove the samplesAlways attribute to use the exported file to create a new table.
HIG-11408 Interana includes a copy_id: False attribute when exporting a table using the ia table exportcommand. You must manually remove the copy_id: False attribute to use the exported file to create a new table.  
HIG-11801 Deleting a global filter prevents any charts that use that filter from loading. Instead of deleting global filters, we recommend that you clear the filter conditions. 
HIG-11813 Long numeric values are displayed as rounded numbers in the UI (hashes created for hex columns are not accurately represented in the user interface)
HIG-11936 The unsampled checkbox remains checked even when aggregation sampling is in process.
HIG-12235 After using the ia table delete command to delete a table, Interana returns the error "No table named <table> exists!"
HIG-12350 Cannot use a new hex column to create a Table view query if the column was converted from a string or int column
HIG-12454 Growth Edition customers cannot change time zone offsets for dashboards. Contact Interana Support for help with this issue. 
HIG-12568 Lookup column source names in settings view are actually not the source names - instead they are the familiar names.

Release 2.24.1

This maintenance release fixes the following issues:

HIG-11295 Interana failed to start after an upgrade, if the system had more than one network interface.
HIG-11339 Long chart names did not display completely in Number View.
HIG-11343 In some cases, there were difficulties with the consistent performance with some types of ingest pipelines.
HIG-11487 You were unable to create new email reports, but could still use existing reports.
HIG-11517 A loopback import job would stop when a process failed, and should have continued in spite of the failure.
HIG-11518 Charts on the left side of the dashboard did not align correctly when a medium size chart was placed in the row above.

Release 2.24.2

This maintenance release fixes the following issues:

HIG-11554 When Global filters were updated, the dashboard charts that referenced the filters were not updated.
HIG-11604 Unable to do a daily count of users that were active over a time window (such as 7 or 28 days). For example, if a user was active on a particular day, they are included in the metric. However, if a user was not active in the current time slice, even if they met the definition of being active over the time window, they are not included in the metric.
HIG-11669 Decimal columns in Table view were not sorted correctly. 

Release 2.24.3

This section introduces new features included in Interana release 2.24.3 and lists newly resolved and known issues.

New features

This release includes the following new features.

New scripts for data balancing

We added a script that you can run on your Interana cluster to analyze the volume of actor events across all shards. See Balancing data for efficient sampling for more information about running this script and guidelines for balancing your data.

Day of week updates for time queries

In this release, we updated the default assumptions used when you use the name of a day in a query (for example, “Monday” as the start time). We have updated the documentation to clarify how Interana works with day names in queries, and also when used with "next" and "last." See “Days of the week” in the Time query syntax reference for detailed information.

New order_by field in Query API

We added an optional order_by parameter to the Query API. This allows you to specify whether results should be returned in ascending or descending order. See the Query API reference for more information.

Resolved issues

This release fixes the following issues:

Update to improve the accuracy of Percentile view calculations Inconsistent behavior when using relative time windows in named expressions Monthly (30-day) resolution snaps to the wrong date

Update to improve the accuracy of Percentile view calculations Inconsistent behavior when using relative time windows in named expressions Monthly (30-day) resolution snaps to the wrong date

HIG-8721 Update to improve the accuracy of Percentile view calculations
HIG-9408, HIG-12411 Inconsistent behavior when using relative time windows in named expressions
HIG-10415 Improved error message for time window errors
HIG-10820 Monthly (30-day) resolution snapping to the wrong date                                                                                            
HIG-11962 Lookup columns do not update
HIG-12283 Session metrics issue on a string derived column
HIG-12294 Unable to embed distribution view charts
HIG-12306 Sampled queries do not scale correctly when using an activity metric

Release 2.24.4

This maintenance release fixes the following known issue.

HIG-12739 Sampled count events would sometimes return a decimal value. Now, decimal sampled count event values are rounded to the nearest whole number
  • Was this article helpful?