Chaos Agent Known Issues

This document provides a list of known issues encountered with the Chaos Agent in Azure Chaos Studio, along with recommended workarounds or solutions. This list is updated regularly as new issues are identified.

Limited Impact of Linux Network Faults

Issue:
When you run Linux network faults on certain distributions (for example, RHEL), the expected fault effect—such as injected network latency or packet loss-may not occur.

Cause:
The required sch_netem kernel module isn't installed on the Virtual Machine (VM), preventing the Traffic Control (tc) based faults from functioning properly.

Potential Workarounds:

Verification: Run the following command on your Linux VM:

modinfo sch_netem

If you receive an error indicating that the module isn't found, proceed to install it.

Resolution: On RHEL-based systems, install the extra kernel modules package:

sudo yum install kernel-modules-extra

Reboot the VM after installation to load the sch_netem module.

DNS Fault on Windows with LKG Plugin Conflict

Issue: The DNS failure fault on Windows may not execute as expected if there's a conflicting LKG plugin installed on the target machine.

Cause: A conflict with the LKG plugin may prevent the DNS interceptor from installing or functioning correctly, leading to the fault not being executed.

Potential Workarounds:

• Ensure that the required DNS interceptor is installed and configured using the default settings.

• Avoid overriding the DNS interceptor with any custom or conflicting plugins.

• If a conflict is detected, restore the default configuration or reinstall the DNS interceptor as per the documented instructions.

Dynamic Targeting Issues

Issue: When you use dynamic targeting in experiments, the query may sometimes yield an empty list of targets—even when the query is valid.

Cause: Not all VMs returned by the dynamic query have the Chaos Agent installed and enabled.

Potential Workarounds:

• Verify that all VMs in the dynamic query result have the Chaos Agent installed and properly configured.

• Manually confirm target enablement in the Azure portal if dynamic queries continue to return an empty list.

Agent Selection on Untested OS

Issue: Enabling the Chaos Agent on VMs running untested or outdated operating systems can lead to unexpected behavior or failure of certain fault types. If you install the right dependencies, it's likely to work, but may require manual debugging.

Cause: The Chaos Agent is officially tested on a specific set of operating systems. Running it on an unsupported OS may result in partial functionality or errors during fault execution.

Potential Workarounds:

• Verify that your target OS supports autoinstallation on the OS Support and Compatibility page.

• If the OS isn't supported, consider using a tested version or manually installing the dependencies.