Faults

SourceMaster tracks a wide range of potential faults with NDI signals and infrastructure.

All faults ar stored in a SQLite database, and can be viewed directly in the UI. Faults be filtered by type, severity and keywords.

When a fault is cleared, it's moved frm the Active list to the Cleared list. Cleared faults are automatically purged when they reach a certain age, which can be configured in the settings. You can also restrict the number of cleared faults that are stored, to prevent the database from growing indefinitely.

Every fault is timestamped, and includes a brief description of the issue and the entity related to the fault. Faults are categorised by severity.

For some faults, the fault description may change over time. For example, if a source generates a fault due to excessive bandwidth being detected, the fault message will include the bandwidth value that triggered the fault. If the bandwidth value changes, the fault message will be updated to reflect the new value.

Manually clearing faults

Active faults can be manually cleared by clicking the "Clear" button next to each fault in the UI. This will move the fault to the Cleared list, where it will be retained until it is automatically purged based on the settings.

Note that if the fault is detected again after being cleared, it will be raised as a new active fault with a new timestamp.

Manually removing cleared faults

Cleared faults can be manually removed from the database by clicking the "Clear Cleared Faults" button in the UI. This will permanently delete all cleared faults from the database.

Cleared faults are automatically purged to prevent the database from growing indefinitely. The Settings page allows you to configure how long cleared faults are kept, or to set a maximum number of cleared faults to keep.