Error Injector
The Error Injector tool in StanagProcessor is designed to simulate various network issues such as packet corruption, loss, delay, reordering, and duplication. These simulations are essential for system integration, debugging, and performance testing, as they allow developers and engineers to understand how their applications behave under adverse network conditions. By introducing controlled errors into network streams, the tool helps ensure that systems can handle real-world scenarios, such as poor network connectivity, with grace and resilience.
Each error type comes with adjustable parameters, allowing users to fine-tune the severity and frequency of the simulated errors, making it easier to assess the robustness of their network protocols, error-handling mechanisms, and overall system performance. This feature is especially valuable for stress-testing encoding algorithms, stream synchronization, and adaptive bitrate technologies.
Errors can be added independently to each output. You can adjust the parameters for each error type on-the-fly without stopping the stream, by applying the changes.
Note: To apply errors on-the-fly, the channel must be started with the Error Injector enabled.
Here are the available error types:
Packet corruption
- Probability. The chance that a packet will be corrupted. A value between 0 and 1.
- CorruptionType. The method of corruption (bitFlip, byteReplace).
- CorruptionAmount. The number of bytes to corrupt within the packet.
- Interval. The time (ms) between corruption events.
Packet loss
- Probability The likelihood that a packet will be lost. Typically a value between 0 and 1 (e.g., 0.1 for 10% packet loss).
- ConsecutivePackets. The number of consecutive packets that might be lost when a loss event occurs.
- Interval. The time (ms) between loss events.
Packet delay
- Probability. The chance that a packet will be delayed.
- DelayDuration. The amount of time to delay the packet.
- DelayJitter. Random variability in delay duration to simulate jitter.
- Interval. The time or packet count between corruption events.
Packet reorder
- Probability. The chance that packets will be reordered.
- ReorderWindow. The maximum number of packets over which reordering
- Interval. The time (ms) or packet count between reorder events.
Packet duplication
- Probability. The likelihood that a packet will be duplicated.
- DuplicationCount. The number of times a packet should be duplicated.
- DuplicationDelay. The time delay between the original packet and its duplicate.
- Interval. The time (ms) between duplication events.
Error Graph
The Stream Error Graph is a tool that provides a visual representation of the bitrate and the errors injected into a stream by the user.