Monitor Tetra Agents Health

You can use the Tetra Agents Health Monitoring Dashboard in the Tetra Data Platform (TDP) to assess the health and performance of the following Windows-based Agents:

To view the health and performance of a Tetra IoT Agent, see Viewing Existing Tetra IoT integrations.

📘
NOTE
The new Health Monitoring App displays detailed observability metrics for Tetra Integrations to help customers better track and troubleshoot data downtime (for example, data ingestion failures or high latency). You can also access the new observability metrics to build your own dashboards in a third-party analytics tool by connecting to the new dashboard’s SQL tables.

Access the Agents Health Monitoring Dashboard

📘
NOTE
It can take up to six minutes for any status changes that you make in the Agent Management Console to appear in the TDP Health Monitoring Dashboard.
The connection (heartbeat) between the TDP and an Agent is checked automatically every five minutes. If the TDP doesn't receive a heartbeat message for more than five minutes, the platform assumes that the Agent is offline.

To view the Tetra Agents Health Monitoring Dashboard, do the following:

Sign in to the TDP. Make sure that you use an Administrator account.
In the left navigation menu, choose Health Monitoring. The Health Monitoring Dashboard appears.
Select the Agents tab. The Agents Health Monitoring Dashboard appears.

Search and Filter Options

To search for a specific Agent, enter either an Agent’s name or unique identifier (UID) in the upper left search box.

To filter by status, select one of the health status types listed next to Filter by Status.

Agent Health Statuses

A Tetra Agent can be in one of three statuses: Healthy, Unhealthy, or Critical. For more information about each status type, see the following table.

State	Event
Healthy	A Tetra Agent is in a Healthy status when all of the following is true: The TDP receives a status from the Agent within the last five minutes and/or receives a file in the last 40 minutes. Files are being transmitted by the Agent because the TDP receives a status from the Agent within the last five minutes and/or receives a file in the last 40 minutes. The percentage of disk space used, percentage of memory used, and/or CPU usage is less than or equal to 80%.
Unhealthy	A Tetra Agent is in an Unhealthy status when any of the following is true: The TDP hasn't received a status from the Agent within the last five minutes, but did receive a file within the last 40 minutes. -The TDP receives an intermittent status from the Agent after three minutes, but less than five minutes, and hasn't received a file in the last 20 minutes. The percentage of disk space used, percentage of memory used, and/or CPU usage is greater than 80% but less than or equal to 90%.
Critical	A Tetra Agent is in a Critical status when any of the following is true: The TDP hasn't received a status from the Agent within the last five minutes, but did receive a file within the last 40 minutes. The file upload error rate is greater than 70% for all upload events, and the scan access rate is greater than 70% within the last hour. Note: The scan access rate is the ability of the Tetra Agent to access a particular folder or drive. The percentage of disk space used, percentage of memory used, and/or CPU usage is greater than 90%.

State

Event

Healthy

A Tetra Agent is in a Healthy status when all of the following is true:

The TDP receives a status from the Agent within the last five minutes and/or receives a file in the last 40 minutes.
Files are being transmitted by the Agent because the TDP receives a status from the Agent within the last five minutes and/or receives a file in the last 40 minutes.
The percentage of disk space used, percentage of memory used, and/or CPU usage is less than or equal to 80%.

Unhealthy

A Tetra Agent is in an Unhealthy status when any of the following is true:

The TDP hasn't received a status from the Agent within the last five minutes, but did receive a file within the last 40 minutes.
-The TDP receives an intermittent status from the Agent after three minutes, but less than five minutes, and hasn't received a file in the last 20 minutes.
The percentage of disk space used, percentage of memory used, and/or CPU usage is greater than 80% but less than or equal to 90%.

Critical

A Tetra Agent is in a Critical status when any of the following is true:

The TDP hasn't received a status from the Agent within the last five minutes, but did receive a file within the last 40 minutes.
The file upload error rate is greater than 70% for all upload events, and the scan access rate is greater than 70% within the last hour. Note: The scan access rate is the ability of the Tetra Agent to access a particular folder or drive.
The percentage of disk space used, percentage of memory used, and/or CPU usage is greater than 90%.

Agent Health Monitoring Dashboard Details

The Agent Health Monitoring Dashboard provides the following details.

Field	Description
Health	Displays the status for the Tetra Agent. By default, all status types display on this dashboard.
Name	Name (and representative icon) of the Tetra Agent that is currently in the critical state. You can hover over the Tetra Agent name to review the following details: CPU Memory Disk Usage Last Contact (in days)To sort the list of Tetra Agents by name, select the arrow next to Name at the top of the column. You can sort items alphabetically or in reverse order. To copy the unique ID for the component instance, select the copy file icon.
Latest Status	When the latest status (Date/Time format) was assigned, and whether it's currently Active or has been Disabled. To review a component's status history, select the View History link below the status.
Health Description	Explains why the component has been assigned a specific health state. By default, only one issue is shown. If there is more than one issue, then a link displays (for example, +3 More) indicating there are more issues to review.
Go To Agent	Provides a link you can select to review the configuration details for the Agent.

Documentation Feedback

Do you have questions about our documentation or suggestions for how we can improve it? Start a discussion in TetraConnect Hub. For access, see Access the TetraConnect Hub.

📘
NOTE
Feedback isn't part of the official TetraScience product documentation. TetraScience doesn't warrant or make any guarantees about the feedback provided, including its accuracy, relevance, or reliability. All feedback is subject to the terms set forth in the TetraConnect Hub Community Guidelines.

Updated 16 days ago