Health Monitoring App v1.x Release Notes

The following are the Health Monitoring App release notes for versions 1.x. Starting in version 1.1.0, the Health Monitoring App provides two comprehensive dashboards in the Tetra Data Platform (TDP) user interface to help customers gain an end-to-end understanding of data usage and downtime as well as platform usage:

📘

NOTE

Health Monitoring App v1.0.0 and earlier includes only the Health Monitoring dashboard, not the Operational Insights dashboard.

v1.1.0

Release date: 22 December 2025

What's New

TetraScience has released its next version of the Health Monitoring App, version 1.1.0. This release introduces a new Operational Insights dashboard in the TDP user interface that provides metrics for data volume and flow as well as user activity and engagement.

Prerequisites

Health Monitoring App v1.1.0 requires the following:

For Customer-Hosted TDP Environments Only

  • The TetraScience Databricks integration (which supports the Lakehouse). Contact your customer account leader to set this up.

New Functionality

New Functionality includes features not previously available in the Health Monitoring App.

Operational Insights Dasbhoard

A new Operational Insights dashboard in the TDP user interface provides metrics for data volume and flow as well as user activity and engagement.

The new dashboard includes two tabs:

Data Volume & Flow Data Volume & Flow tab

The Data Volume & Flow tab displays the following metrics:

Performance MetricMetric TypeDescription
Total Data Ingested in TerabytesKPITotal data ingested in terabytes
Total Workflow RunsKPITotal number of workflow runs
File Asset InventoryChartTotal number of files by type
Total Data Ingested Over TimeChartTotal data ingested over time
Total Workflow Runs Over TimeChartTotal workflow runs over time
Agent Files UploadedTableTotal number of files uploaded by agents

Available Data Volume & Flow Tab Filters

You can filter the Data Volume & Flow tab data using the following options:

  • Time Range: Select a predefined time range or set a custom date range.
  • File Type: Filter by specific type of file, such as RAW, IDS,PROCESSED, or TMP. This list is dynamically populated by the existing data. So you might only see some of these labels if you don't have files of a specific type.

User Activity & Engagement User Activity & Engagement tab

The User Activity & Engagement tab displays the following metrics:

Performance MetricMetric TypeDescription
Total Searches Over TimeChartTotal number of searches over time
Total Downloads Over TimeChartTotal number of downloads over time
Total App Usage Over TimeChartTotal number of unique app sessions over time
Count of App Users Per AppChartTotal number of unique app users per app

Available User Activity & Engagement Tab Filters

You can filter the User Activity & Engagement tab data using the following options:

  • Time Range: Select a predefined time range or set a custom date range.

For more information, see Operational Insights.

Enhancements

Enhancements are modifications to existing functionality that improve performance or usability, but don't alter the function or intended use of the system.

  • There are no enhancements in this release.

Bug Fixes

There are no bug fixes in this release.

Limitations

The following are known limitations of Health Monitoring App v1.1.0:

  • Metrics data for the Operational Insights dashboard is backfilled with data from July 2025 and later only when the app is activated. However, it can take several days for the data to backfill (one month of data takes about a day to populate). Until the data backfill completes, only the latest data captured from when the app is updated appears in the dashboard.
  • Metrics data for the Health Monitoring App dashboard isn't backfilled when the app is activated, so the available data spans one day in duration only when the new Health Monitoring dashboard first appears in customers' TDP environments.
  • If the available data spans one day in duration only (for example, when the new dashboard is first activated) then charts in the new Health Monitoring dashboard will appear empty. If customers hover their cursors over an empty chart, they will see a single data point, which is a summary statistic for that day. Once customers have two days of data available, then the charts and tables will populate as normal.
  • The File Ingestion Journey chart on the FLA tab won't show any file search indexing events or other downstream file events if those events occur outside of the Time range filter defined by customers. This behavior occurs because all File Ingestion Journey events are a subset of the original files that were scanned during the specified time range.
  • There is a maximum number of table rows available for each of the following troubleshooting metrics:
    • Last Agent Heartbeat: 100 row maximum
    • File Status: 1,000 row maximum
    • Workflow Status: 1,000 row maximum
    • Path Status (Latest Scan): 1,000 row maximum

Deprecated Features

There are no new deprecated features in this release. For more information about TDP deprecations, see Tetra Product Deprecation Notices.

Known and Possible Issues

The following are known issues for Health Monitoring App v1.1.0:

  • When customers upgrade to Health Monitoring App v1.1.0 from v1.0.0 and select Change Version, a 404 error page might display until the installation dialog appears. After the new app version is installed, the 404 page disappears and the app's dashboards load. A fix for this issue is in development and testing and is scheduled for a future Tetra Data Platform (TDP) release.
  • After being activated, the Health Monitoring App may return a 500 internal server error as it establishes a new user database. To resolve the issue, customers should log out of the TDP, close their web browser, and then reopen the browser and sign back in to the TDP.
  • After selecting Enter fullscreen on a graph, the graph can sometimes fail to render and an error appears. To resolve the issue, navigate back to the dashboard and re-enter the fullscreen view.
  • The app might also display a Workgroup Not Found error when opened for the first time. To resolve the issue, customers must rotate their organization-level SQL Credentials. Keep in mind, the new set of generated credentials will cause the previous set of credentials to stop working.

Security

The Health Monitoring App implements the following security measures:

  • All dashboard data is encrypted in transit using TLS 1.2+
  • Access to metrics is controlled through TDP's role-based access control system
  • Audit logging tracks all dashboard configuration changes
  • Alert configurations are encrypted at rest

Upgrade Considerations

To upgrade to Health Monitoring App v1.1.0, TDP v4.4.0 or higher is required.

When activating the Health Monitoring App, keep in mind the following:

  • After being activated, the app may return a 500 internal server error as it establishes a new user database. To resolve the issue, customers should log out of the TDP, close their web browser, and then reopen the browser and sign back in to the TDP.
  • The app might also display a Workgroup Not Found error when opened for the first time. To resolve the issue, customers must rotate their organization-level SQL Credentials. Keep in mind, the new set of generated credentials will cause the previous set of credentials to stop working.
  • The app can be deactivated at any time, if needed. (For customer-hosted deployments only) Activating the Health Monitoring App introduces additional data processing costs in the Data Lakehouse. To process integration events in near real time, the app creates its own silver Lakehouse Tables that are required for data cleaning and validation. These tables support the analytics displayed in the Health Monitoring App and are activated through a feature flag (enable_dam_silver_tables), which can be turned off at any time. For a cost estimate based on your specific needs, contact your customer account leader. (Updated on 14 November 2025)

For more information about the Health Monitoring App, see Health Monitoring App.

v1.0.0

Release date: 30 June 2025

What's New

TetraScience has released its first general availability (GA) version of the Health Monitoring App (previously known as the Superset Monitoring App), version 1.0.0. This release introduces persistence for Superset metadata, including charts, dashboards, and authentication sessions. It also introduces several new graphs for Empower and a new Chromeleon tab.

Prerequisites

Last updated: 18 August 2025

Health Monitoring App v1.0.0 requires the following:

For Customer-Hosted TDP Environments Only

  • The TetraScience Databricks integration (which supports the Lakehouse). Contact your customer account leader to set this up.

New Functionality

New Functionality includes features not previously available in the Health Monitoring App.

  • Superset metadata persistence: Any changes made to the app configuration now persist between user sessions, and when customers upgrade to the latest app version.

Enhancements

Enhancements are modifications to existing functionality that improve performance or usability, but don't alter the function or intended use of the system.

  • New Empower charts were added for latency, top injections, and projects.
  • An Agent Name field was added to charts relating to Agents, and users can now filter by Agent name.
  • A new tab for Tetra Chromeleon Agents was added.

Bug Fixes

The following bugs are now fixed:

  • User cookies are now persisted, which solves intermittent 500 internal server errors when the app is activated. However, a 500 error may still be seen when upgrading to the latest app version. To resolve the issue, customers should log out of the TDP, close their web browser, and then reopen the browser and sign back in to the TDP.

Limitations

The following are known limitations of Health Monitoring App v1.0.0:

  • Metrics data isn't backfilled when the app is activated, so the available data spans one day in duration only when the new Health Monitoring dashboard first appears in customers' TDP environments.
  • If the available data spans one day in duration only (for example, when the new dashboard is first activated) then charts in the new Health Monitoring dashboard will appear empty. If customers hover their cursors over an empty chart, they will see a single data point, which is a summary statistic for that day. Once customers have two days of data available, then the charts and tables will populate as normal.
  • The File Ingestion Journey chart on the FLA tab won't show any file search indexing events or other downstream file events if those events occur outside of the Time range filter defined by customers. This behavior occurs because all File Ingestion Journey events are a subset of the original files that were scanned during the specified time range.
  • There is a maximum number of table rows available for each of the following troubleshooting metrics:
    • Last Agent Heartbeat: 100 row maximum
    • File Status: 1,000 row maximum
    • Workflow Status: 1,000 row maximum
    • Path Status (Latest Scan): 1,000 row maximum

Deprecated Features

There are no new deprecated features in this release. For more information about TDP deprecations, see Tetra Product Deprecation Notices.

Known and Possible Issues

The following are known issues for Health Monitoring App v1.0.0:

  • After being activated, the Health Monitoring App may return a 500 internal server error as it establishes a new user database. To resolve the issue, customers should log out of the TDP, close their web browser, and then reopen the browser and sign back in to the TDP.
  • After selecting Enter fullscreen on a graph, the graph can sometimes fail to render and an error appears. To resolve the issue, navigate back to the dashboard and re-enter the fullscreen view.

Security

The Health Monitoring App implements the following security measures:

  • All dashboard data is encrypted in transit using TLS 1.2+
  • Access to metrics is controlled through TDP's role-based access control system
  • Audit logging tracks all dashboard configuration changes
  • Alert configurations are encrypted at rest

Upgrade Considerations

Last updated: 14 November 2025

When activating the Health Monitoring App, keep in mind the following:

  • After being activated, the app may return a 500 internal server error as it establishes a new user database. To resolve the issue, customers should log out of the TDP, close their web browser, and then reopen the browser and sign back in to the TDP.
  • The app might also display a Workgroup Not Found error when opened for the first time. To resolve the issue, customers must rotate their organization-level SQL Credentials. Keep in mind, the new set of generated credentials will cause the previous set of credentials to stop working.
  • The app can be deactivated at any time, if needed. (Updated on 14 November 2025) (For customer-hosted deployments only) Activating the Health Monitoring App introduces additional data processing costs in the Data Lakehouse. To process integration events in near real time, the app creates its own silver Lakehouse Tables that are required for data cleaning and validation. These tables support the analytics displayed in the Health Monitoring App and are activated through a feature flag (enable_dam_silver_tables), which can be turned off at any time. For a cost estimate based on your specific needs, contact your customer account leader. (Updated on 14 November 2025)

For more information about the Health Monitoring App, see Health Monitoring App.

Other Release Notes

To view previous release notes for the Superset Monitoring App (EAP versions), see Superset Monitoring App EAP Release Notes.

To view other release notes for Tetra Data Apps, see Tetra Data Apps Release Notes.