Message Formatting

These actions are useful for creating notifications or customising the output of existing actions

Create finding

Create finding

Playbook Action: create_finding

Create a new finding.

All messages from Robusta are represented as a Finding object.

This action creates a Finding that Robusta sends, with the specified fields.

Add this to your Robusta configuration (Helm values.yaml):

actions:
- create_finding:
    aggregation_key: Job Failure
    severity: DEBUG
    title: Job $name on namespace $namespace failed
triggers:
- on_job_failure: {}

The above is an example. Try customizing the trigger and parameters.

required:
title (str)

Finding title. Title can be templated with name/namespace/kind/node of the resource, if applicable

aggregation_key (str)

Identifier of this finding

optional:
description (str)

Finding description. Description can be templated

severity (str) = HIGH

Finding severity. Allowed values: DEBUG, INFO, LOW, MEDIUM, HIGH

This action can be manually triggered using the Robusta CLI:

robusta playbooks trigger create_finding  title=TITLE aggregation_key=AGGREGATION_KEY

Finding attributes

Customise finding

Playbook Action: customise_finding

Overrides a finding attribute with the provided value.

All messages from Robusta are represented as a Finding object. This action lets you override Finding fields to change that messages Robusta sends. This lets you modify messages created by other actions without needing to rewrite those actions.

This action does not create a new Finding, it just overrides the attributes of an existing Finding. It must be placed as the last action in the playbook configuration, to override the attributes created by previous actions

Add this to your Robusta configuration (Helm values.yaml):

actions:
- customise_finding:
    severity: DEBUG
triggers:
- on_pod_crash_loop: {}

The above is an example. Try customizing the trigger and parameters.

optional:
title (str)

Overriding finding title. Title can be templated with name/namespace/kind/node of the resource, if applicable

description (str)

Overriding finding description. Description can be templated with name/namespace/kind/node of the resource, if applicable

severity (str)

Overriding finding severity. Allowed values: DEBUG, INFO, LOW, MEDIUM, HIGH

This action can be manually triggered using the Robusta CLI:

robusta playbooks trigger customise_finding