Mutators Page#

Mutators are used to modify event data to be used by other mutators or alerts that send ClusterWareAI ™ event information to notification systems, such as email or Slack. The Mutators page lists the mutators available within the ClusterWareAI software. The page is available via Auto Remediation > ARS Policy > Mutators in the left navigation panel.

Mutators

Create Mutator#

To create a mutator:

  1. Click Add Mutator.

  2. Add details about the mutator.

    • Name: Required. Names must start with an alphabetic character, not a number.

    • Description: Optional.

    • Sources: Required. Add one or more sources to the mutator. Sources can be MQTT topics or other mutators.

    • Template: Required. Format template must produce valid JSON after {field} placeholders are replaced. Click Preview Output to see an example output and verify your message output.

    • Mute: Optional. Prevent the mutator from sending output. Set a mute time period using the Mute for field. If a time period is not set, the mutator is muted indefinitely.

    • Frozen: Optional. When enabled, the mutator cannot be modified via the GUI or command line.

  3. Click Save.

The new mutator appears in the list at the top of the panel.

Edit Mutator#

To update a mutator:

  1. Click the mutator name to open the mutator details, then click Edit Mutator. Alternatively, click the More menu More Icon on the far right of the row and select the Edit action.

  2. Make updates to the mutator.

  3. Click Save to modify the mutator.

Clone Mutator#

Cloning a mutator creates a copy of an existing mutator with a new name and the same configuration. To clone a mutator:

  1. Click the More menu More Icon on the far right of the row and select the Clone action. The Clone Mutator from window opens with the existing mutator's name pre-populated in the From Mutator field.

  2. Enter a name for the new mutator in the To Mutator field.

  3. Click Clone to create the new mutator.

  4. (Optional) Edit the new mutator to change attributes, such as the source.

Delete Mutator#

To delete a mutator, click the More menu More Icon on the far right of the row and select the Delete action.