The Health Monitoring App (previously known as the Superset Monitoring App) provides a comprehensive dashboard in the Tetra Data Platform (TDP) user interface to help you gain an end-to-end understanding of data downtime. The dashboard provides a set of metrics for ingestion failures and latency for on-premises Tetra File-Log Agents, Tetra Empower Agents, Tetra Chromeleon Agents and Tetra Data Pipelines.

This guide explains how to activate and use the app to monitor the health and performance of your data integrations.

Prerequisites

• TDP v4.3.0 or higher

For Customer-Hosted TDP Environments Only

• The TDP's Transport Layer Security (TLS) certificate must validate the following endpoint: *.data-apps.tdp-hostname.com
• The Domain Name Server (DNS) zone for tdp-hostname.com must have a CNAME record routing *.data-apps.tdp-hostname.com to tdp-hostname.com

Activate the Health Monitoring App

To activate the Health Monitoring App in your TDP environment, contact your customer success manager (CSM) or account executive.

Activation Considerations

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, log out of the TDP, close your 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 you open it the first time. To resolve the issue, you must rotate your organization-level SQL Credentials. Keep in mind, the new set of generated credentials will cause the previous set of credentials to stop working.

Access the Health Monitoring App Dashboard

To access the Health Monitoring App dashboard, do the following:

1. Sign in to the TDP.
2. In the left navigation menu, choose Health Monitoring. The Health Monitoring App dashboard loads, displaying an overview of your TDP integrations. If the app is activated in your account, NEW UI | WELCOME TO OUR NEW HEALTH MONITORING EXPERIENCE displays at the top of the page.

📘

NOTE

If you don't see the Health Monitoring App dashboard, verify that your TDP administrator has activated the app for your account.

The Health Monitoring App dashboard is organized into five tabs, each focusing on different aspects of your TDP integrations:

• FLA: provides metrics specific to Tetra File-Log Agents
• Empower: provides metrics specific to Tetra Empower Agents
• Chromeleon: provides metrics specific to Tetra Chromeleon Agents
• Pipelines: provides metrics specific to Tetra Data Pipelines
• Agent Connectivity: provides Agent heartbeat and connection status

Each tab provides a set of visualizations, filters, and tables to help you monitor and troubleshoot your TDP integrations.

FLA Tab

The FLA tab provides metrics specific to Tetra File-Log Agents.

FLA Tab Metrics

The FLA tab displays the following metrics:

Available FLA Tab Filters

You can filter the FLA tab data using the following options:

• Time Range: Select a predefined time range or set a custom date range
• FLA Agent Name: Filter by specific FLA name
• FLA Agent Id: Filter by specific FLA id
• Path: Filter by specific scan path
• File id: Filter by file id

Empower Tab

The Empower tab provides metrics specific to Tetra Empower Agents.

Empower Tab Metrics

The Empower tab displays the following metrics:

Available Empower Tab Filters

You can filter the Empower tab data using the following options:

• Time Range: Select a predefined time range or set a custom date range
• Empower Agent Name: Filter by specific Empower Agent name
• Empower Agent Id: Filter by specific Empower Agent id
• Project Path: Filter by specific Empower project

Chromeleon Tab

The Chromeleon tab provides metrics specific to Tetra Chromeleon Agents.

Chromeleon Tab Metrics

The Chromeleon tab displays the following metrics:

Available Chromeleon Tab Filters

You can filter the Chromeleon tab data using the following options:

• Time Range: Select a predefined time range or set a custom date range
• Chromeleon Agent Name: Filter by specific Chromeleon Agent name
• Chromeleon Agent Id: Filter by specific Chromeleon Agent id
• Data Vault Name: Filter by specific Chromeleon Data Vault name
• Data Server Name: Filter by specific Chromeleon Data Server name
• Report Type: Filter by specific Chromeleon Report Type

Pipelines Tab

The Pipelines tab provides metrics specific to Tetra Data Pipelines.

Pipeline Tab Metrics

The Pipelines tab displays the following metrics:

Available Filters

You can filter the Pipelines tab data using the following options:

• Time Range: Select a predefined time range or set a custom date range
• Pipeline Id: Filter by specific pipeline id

Agent Connectivity Tab

The Agent Connectivity tab provides information about the connection status of all or your supported Agents (Tetra File-Log Agents and Tetra Empower Agents).

Available Metrics

The Agent Connectivity tab displays the following metrics:

Available Agent Connectivity Tab Filters

You can filter the Agent Connectivity tab data using the following options:

• Agent Name: Filter by specific agent name
• Agent Id: Filter by specific agent id

Limitations

The Health Monitoring App has the following limitations:

• 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

Troubleshooting

Dashboard Not Loading

If the Health Monitoring dashboard fails to load:

1. Refresh your browser.
2. Clear your browser cache.
3. Ensure you have the necessary permissions to access the dashboard.
4. Check if your TDP version meets the minimum requirements.
5. Contact your TDP administrator if the issue persists.

Missing or Incomplete Data

If you notice missing or incomplete data in the dashboard:

1. Check if the time range selection includes periods before the app was activated.
2. Verify that your agents are online and sending heartbeats.
3. Ensure that your integrations are properly configured.
4. For customer-hosted environments, check that the required DNS and TLS configurations are in place.
5. Contact TetraScience support if the issue persists.

Slow Dashboard Performance

If the dashboard is loading slowly:

1. Try reducing the selected time range.
2. Apply filters to limit the amount of data being processed.
3. Close other browser tabs and applications.
4. For large environments with many agents, consider using more specific filters.
5. Check your network connection.

Error Messages

Common error messages and their resolutions:

• "No data available": Ensure that your integrations are running and generating data.
• "Failed to load data": Refresh the dashboard or check your network connection.
• "Access denied": Contact your TDP administrator to verify your permissions.
• "Service unavailable": The app service may be temporarily down; try again later.

For additional help or to report issues, submit a support ticket.