Action catalog

To view details of automation that is used in Instana, click **Automation** in the navigation menu.
The Automation icon

You can create, edit, and delete actions to diagnose and remediate events. To manage actions, click Automation> Action Catalog. The defined actions are displayed. You can apply tags to each action for Instana to use these tags in its action recommendations.

Action types

You can create three types of actions:

  • Documentation link: Access relevant documentation to diagnose or remediate a known issue directly from an event context.
  • Script: Add an automation script that can run on your agent by using the script action sensor. The syntax and commands in the script can be any that are supported on your target agent system. Currently, only Linux operating systems are supported.
  • HTTP: Add HTTP calls to invoke webhooks or other REST API on your agent by using the HTTP action sensor.

Action parameters

You can configure input parameters for each action from the action definition:

  • The Static, Vault, and Dynamic parameter types are supported.
    • Static: Contain a static value that can be given a default value, and the value can be optionally updated when the action is run.
    • Vault: Derive the value from a configured Hashicorp Vault on a target agent. You must provide both the Secret Path and Secret Key to dynamically access the value at runtime.
    • Dynamic: A set of values that are derived from the monitored infrastructure that is related to the issue based on a tag. The Dynamic parameters are automatically detected, and they continuously update the relations of the monitored system by using Instana's unique Dynamic Graph.
  • Default value: Optionally define a default value for a static parameter.
  • Hidden: Optionally hide the value at runtime. If it's specified, you need to set a default value.

Using action parameters

In the action definition page, you can access the input parameters in your actions as follows:

  • Parameter substitution: Reference a defined parameter in your action by using the substitution format @@parameter_name@@. The action sensors will replace the string with the action parameter value when the action is run.
    echo "@@parameter_name@@"
    ```- **Environment variable**: The script action sensor will define an environment variable named `$parameter_name` that can be accessed directly in an action when the action is run. This is only available for script action types.
    ```bash {: codeblock}
    echo $parameter_name

Associating actions with events and Smart Alerts

You can associate actions with events and Smart Alerts. To associate actions with events and Smart Alerts, complete the following steps:

  1. Go to Automation> Action Catalog.
  2. Click an action. The Configure Action: pane is displayed.
  3. Optional: Associate the action with events:
    1. In 4. Associate Events, click **Add Events>>. The Add Events dialog is displayed.
    2. Select the events that you want to associate with the action.
    3. Click the Add Events button.
  4. Optional: Associate the action with Smart Alerts:
    1. In 5. Associate Smart Alerts, click **Add Smart Alerts. The Add Smart Alerts dialog is displayed.
    2. Select the Smart Alerst that you want to associate with the action.
    3. Click Select Events.
  5. Click Save.

Similarly, you can associate actions with application Smart Alerts by clicking Add Smart Alerts. Then, you can see a modal that provides a list of application Smart Alerts that you can associate to this action. After you select the Smart Alerts, click Select Smart Alerts within the modal to save your changes. The association is saved after the action is saved.