Running actions

You can run an action in two ways: either by using the recommended actions directly from the event, or by creating an automation policy that associates the action to the event.

To run an action from the recommended actions in an event, complete the following steps:

  1. Go to Events > Issues or Events > Incidents.
  2. Click an Issue or Incident. The dashboard for the issue is displayed.
  3. Click the Recommended Actions tab.
  4. Click Run. The dialog box "Run action " is displayed.
  5. Select the target agent for the action to run. If the host system that is associated with the event can be mapped to a target agent, the target agent is marked as the Triggering Agent. This indicates that you can run this action directly on the affected host. The available options include all agents that have an enabled action sensor that matches the action type.
  6. Optional: For Ansible actions, you can select one or more hosts from the Hosts limit list or enter the details for another host. The list displays the fully qualified hostname and IP address for each host in the list.
  7. Set the parameters.
  8. Click Run.

To run an action from an event by creating an automation policy, complete the following steps:

  1. Go to Events > Issues or Events > Incidents.
  2. Click an Issue or Incident. The dashboard for the issue is displayed.
  3. Click the Automation Policies tab.
  4. Click Run. The dialog box "Run action " is displayed.
  5. Select the target agent for the action to run. If the host system of the event can be mapped to a target agent, the target agent is marked as Triggering Agent, which indicates you can run this action directly on the affected host. The options include all the agents that have an enabled action sensor that matches the action type.
  6. Optional: For the Ansible actions, select one or more hosts of the event from the Hosts limit list or enter the details for another host. For each host in the list, the fully qualified hostname and IP address is shown.
  7. Set the parameters.
  8. Click Run.

If you started an action run, you can see a link to access one of the following items:

  • Action History if you have the View action history permission
  • Action log for the action.

To access the associated URL from the event context for an associated Documentation Link action, select Launch.

To test your action outside an event instance, run it from Action Catalog after specifying Target Agent.

Parameter specification

You can update any parameter values that are defined for the actions in the Parameters section.

  • The default value for a parameter will be filled in if the parameter is specified when you define the parameter for the action definition.
  • Any parameters that are marked as Required must be given a value.
  • Any parameters that are marked as Hidden will not be visible.
  • If a parameter is marked as Dynamic, the value of the parameter is derived from the event context if available. If no value is displayed for the dynamic parameter, the path in the dynamic parameter specification is not resolved. You can modify the value.

After you run an action, you can see a link to access the Action log page for that run of an action. For an associated Documentation Link action, you can select Launch to quickly access the associated URL from the event context.

To test your actions independent of an event, complete the following steps:

  1. Go to Automation > Action Catalog.
  2. Click the Test icon against an icon. The "You have chosen to test Ansible: < name of the action > from your Action Catalog" dialog is displayed.
  3. From the Target Agent list, select a target to run the test.
  4. Click Test Action.