--- title: "Understand System Health Report" canonical: "https://help.vicon.com/space/ShogunLive121/1253212273/Understand%20System%20Health%20Report" format: markdown --- System Health Report is displayed by default on the right in Shogun Live. It consolidates existing key metrics into a single, easy-to-understand format to help you monitor and evaluate overall system performance. The default view of the System Health Report features multiple section headers which provide an insight into the current system performance. Each section is expandable so that you can access more detailed information about the metrics presented in its header. The metrics in each section are presented either as a discrete value at the current frame or as a thumbnail displaying a trend of recent data in a specified time window. ## Examples of using System Health Reports System Health Reports can help you to monitor and use your Vicon motion capture system in a number of ways, including the following examples: - During shoots, System Health Report enables you to monitor system performance to easily spot when issues arise. - It helps you monitor and understand how your system warms up, enabling you to optimize shoot days. - It lets you quickly validate your calibration by viewing **Centroid Connectivity** and **Image Error**. ## Descriptions of System Health metrics The following descriptions outline each section, and underlying metrics, in the System Health Report. This can help you decide which metrics to display while tracking. > Macro (toc) > Macro (scroll-pagebreak) ### Latency section This refers to the time elapsed (in ms) measured from the mid-point of the camera shutter interval to the moment data is ready to be sent to a client. The section header displays the current system latency. > ![Latency header in System Health Report of Vicon Shogun Live.](media://c9893f21-70e6-4b9c-9220-e7b751ca41e2) When this section is expanded, it displays: - A thumbnail graph showing the latency of the datastream output for the most recent 60 seconds. It is split into the Standard Latency (yellow), ObjectTracker Latency (Blue), and Delivery Latency (Pink). - A table that displays the latency for Standard and ObjectTracker outputs, expressed as milliseconds (ms), over the last 60 seconds. > ![Expanded Latency section in System Health Report of Vicon Shogun Live.](media://3ff8ff52-efd4-4b4f-a42c-cdd1900110f4) To display the latency presented in the Latency section in Graph Plots, select the **Datastream Output Latency** channel type. If you want to tweak the performance to affect latency, consider changing the settings in the Processing panel. For more information, see [Change processing parameters](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212396). ### Dropped Frames section This is the number of unprocessed frames expressed as a percentage of the total frames. Dropped frames occur when the processing of the frame is longer than the frame interval itself. This may happen, for example, when tracking high object counts or when the frame rate is sufficiently high. The section header indicates whether the system is currently processing with or without dropped frames. If the percentage displays a non-zero value(s), processing includes dropped frames. > ![Dropped Frames header in System Health Report of Vicon Shogun Live.](media://01368ac9-418f-4921-9996-9866e3a4d545) When this section is expanded, it displays: - A thumbnail graph displaying the dropped frames of the datastream output for the most recent 60 seconds. It is split into the Standard Dropped Frames (yellow), ObjectTracker Dropped Frames (Blue). - A table that displays the dropped frames for Standard and ObjectTracker outputs, expressed as a percentage, over the last 60 seconds. > ![Expanded Dropped Frames section in System Health Report of Vicon Shogun Live.](media://185c76f5-92a5-4a25-a96a-8d8fe3c0531c) If you want to tweak the performance to affect dropped frames, consider changing the settings in the Processing panel. For more information, see [Change processing parameters](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212396). > Macro (scroll-pagebreak) ### Calibration Details section In the System Health Report, the Calibration Details section provides details about the state of the system's calibration. The section header indicates whether all enabled cameras are calibrated. > ![Calibration Details header in System Health Report of Vicon Shogun Live.](media://3bb5158e-ee47-4f98-a5f2-300c885dbc05) When this section is expanded, it displays: - The time elapsed since last calibration - The number of enabled Vicon cameras that are uncalibrated. > ![Expanded Calibration Details section in System Health Report of Vicon Shogun Live.](media://3769a2cc-7ca7-46aa-918b-041b8c3ad8f2) If uncalibrated cameras are displayed and you want them to contribute to tracking, be sure to perform a calibration. > ⚠️ **Note** > ⚠️ An old calibration does not necessarily indicate an issue with calibration or tracking fidelity. > Macro (scroll-pagebreak) ### Centroid Connectivity section In the System Health Report, the Centroid Connectivity section helps you to evaluate tracking fidelity using a metric called Centroid Connectivity (also referred to as 'Centroid connectivity score' or just 'score'). The score is the total fraction of moving 2D centroids (from each individual camera) that can be labeled as object marker centroids as a percentage of total moving centroids (see also [Centroid connectivity score](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212306/Understand+system+health+metrics#CentroidConnectionDefinition)). A low score indicates poor object tracking. The section header displays the number of cameras whose centroid connectivity is below 50%. The icon also displays a gradient from red (poor score) to green (perfect score). > ![Centroid Connectivity header in System Health Report of Vicon Shogun Live.](media://5c975a36-d1c8-4b8c-b713-222b3fa283ee) When this section is expanded, it displays: - A thumbnail graph that shows the Centroid Connectivity for the most recent 60 seconds to help assess any potential volatility in tracking. - A table showing average centroid connection score > ![Expanded Centroid Connectivity section in System Health Report of Vicon Shogun Live.](media://c84b7749-af3c-4864-953a-92c60d9a18a6) > Macro (scroll-pagebreak) If your centroid connectivity is low, your capture environment or the geometry of your tracked object may have changed. To troubleshoot, consider the following solutions: - Ensure there aren't any moving reflections in your volume. - Re-calibrate the system (particularly if there is a large deviation in camera temperatures). - Re-evaluate the tracked object. You can also see Centroid Connectivity in each camera's individual view. For more information, see [Understand system health metrics](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212306). > Macro (scroll-pagebreak) ### Image Error section In the System Health Report, the Image Error section helps you to assess the accuracy and precision of the current state of tracking. Image Error is a metric that calculates the difference between 2D centroids and their expected location in the image (based on 3D re-projection) expressed in pixels (see also [Image error score](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212306/Understand+system+health+metrics#ImageErrorDefinition)). This metric helps you to evaluate the quality of the connected centroids and is the same metric used to assess the quality of the dynamic calibration. As such, if the image error is increasing, a poor calibration or a change in object geometry may be indicated. The header displays the number of cameras with an Image Error above the threshold (1.0 pixels). > ![Image Error header in System Health Report of Vicon Shogun Live.](media://8f15bb15-089f-4e17-9cc7-85a6dcacaad2) When this section is expanded, it displays: - A thumbnail graph with the average Image Error across all cameras for the most recent 60 seconds - A table with the current Image Error > ![Expanded Image Error section in System Health Report of Vicon Shogun Live.](media://b5fa50e0-59b6-4c00-a138-154f07a99891) You can also see Image Error in each camera's individual view. For more information, see [Understand system health metrics](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212306). > Macro (scroll-pagebreak) > Macro (anchor) ### Camera Temperatures section In the System Health Report, the Camera Temperatures section helps to monitor the body temperatures of each camera connected in the system. This section provides details about potential changes in your capture environment since the system was calibrated. If the system is displaying poor Centroid Connectivity and/or high Image Errors and there is a large deviation in temperature between the current state and when the system was last calibrated, this can indicate that you must perform a new calibration. The section header can display two different metrics: - If the system is calibrated, it shows the average temperature change of all cameras since calibration. - If the system is uncalibrated, it shows the current average temperature of all cameras. When this section is expanded, it displays: - A thumbnail graph that displays two temperatures for the most recent 30 minutes: the average camera temperature at calibration (white) and the current camera temperature (red). All values are expressed in degrees Celsius. - A table that shows the minimum, maximum and average value for three temperatures: - **Change during calibration**: This is the change in camera body temperature from the start of calibration. You may not see a difference in this row unless you have a large volume or high camera counts to calibrate or an unstable environment. - **Change since calibration**: This is the change in camera body temperature since the system was last calibrated. - **Current temperature**: This is the current camera body temperature of all cameras. - A list showing a summary of temperature changes for each camera both during and since calibration. > ![Expanded Camera Temperatures section in System Health Report of Vicon Shogun Live.](media://3f4680b0-b198-43ab-957e-b30904f1f467) > ✅ **Tip** > ✅ To find individual camera temperatures, in the **System** panel, select a camera, ensure the advanced properties are displayed and scroll to the **Temperature** section. > Macro (scroll-pagebreak) ### Camera Accelerometers section In the System Health Report, the Camera Accelerometers section helps to monitor the accelerometer readings for all cameras. The accelerometers are used to indicate that the camera body has accelerated beyond its threshold (see [Fix bumped cameras](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212445)). It is a crude way to indicate that a camera may have shifted position and thus reduced tracking fidelity. The section header displays the number of active bump notifications identified in the system. > ![Camera Accelerometers header in System Health Report of Vicon Shogun Live.](media://b7cb855a-ed1c-49ba-a8d2-e175a6d2c273) When this section is expanded, it displays: - A thumbnail that displays the maximum acceleration measured on any camera within the last 10 minutes. - A table that shows the number of cameras with an active bump notification (see [Observe accelerometer feedback](https://vicon-help.atlassian.net/wiki/spaces/ShogunLive121/pages/1253212306/Understand+system+health+metrics#AccelerometerFeedback)). > ⚠️ **Note** > ⚠️ A camera that shows a bumped notification does not necessarily indicate that the camera that is tracking poorly. > ![Expanded Camera Accelerometers section in System Health Report of Vicon Shogun Live.](media://b4b9f4ba-5b48-49b8-bab2-3a3d7f099253) To change the sensitivity of the camera accelerometer, in the **System** panel, select the camera and in the advanced properties, go to the **Accelerometer** section and change the **Bump Sensitivity**.