Skip to main content

Usage examples for Actions Menu

Actions Menu allows you to launch workflows and external tools specifically for a single alert or incident.

This topic provides instructions on configuring two use case examples for URL Actions and Set Tags Actions.

URL Actions are useful for generating external links based on incident or alert attributes. For example, a URL Action could help you trigger a search in your company's knowledge base according to a relevant incident attribute.

Set Tags Actions are useful for manually changing tag values for a specific alert or incident, which can then trigger workflows and outbound webhooks. For example, a Set Tags Action can help you trigger a workflow that posts a new incident to an external system.

URL Action example

Suppose that when you view an incident in Moogsoft Cloud, you want an easy way to bring up the AWS Service health page that corresponds to the priority of the incident that you are viewing. You can accomplish this by creating a new incident action as follows:

  1. Within Moogsoft, navigate to Correlate & Automate > Actions Menu.

  2. Click Add Incident Action. If this button does not appear, add a new category first by clicking Add Category.

  3. Enter "AWS Status" as the name of the action. Optionally, enter a description.

  4. Fill out the sections on the page as follows:

    1. Under Actions, make sure that URL Action is selected.

    2. Fill out the Endpoint section:

      1. Set Request Method to "POST."

      2. Set Response Display to "Popup."

      3. Set URL to the following:

        https://health.aws.amazon.com/health/status?{priority}

      4. Skip Base URLs.

      5. Under Headers, make sure there are no headers. Delete the default header.

    3. Leave all remaining sections blank.

  5. Click Save at the top right of the page.

Now, when you right click on an incident in the Incident view, you can trigger the action you created by navigating to Incident Actions > your-category-name > AWS Status. This will open up a webpage that shows the AWS Service health information corresponding to the priority of the incident you are viewing.

For example, if you trigger the action on an incident with a priority of "Clear," then the webpage with the following URL would be opened in your browser:

https://health.aws.amazon.com/health/status?clear

Set Tags Action example

Creating a Set Tags menu action allows users to manually tag alerts or incidents using a configured item on the action menu.

The following example demonstrates how you could use a menu action to add a tag to incidents indicating the estimated effort to resolve them. Users will be able to run the action and respond to a simple prompt.

  1. Navigate to Correlate & Automate > Actions Menu.

  2. Select the Incident Actions tab, and then click Add Incident Action.

  3. Enter a name (required) and a description (optional) for the new action in the spaces provided.

  4. Click Set Tags Action.

  5. In the Set Tags section, enter a value for the tag name and a value for the tag.

    This example shows how to add a specific tag to an incident, so the tag value is set to 1.

    ActionsMenuTagNameAndValue.png

    Note that the tag name uses substitution syntax. Configuring the variable in this way makes it available as a prompt variable in the next section.

  6. In the Prompt Variables section, click the variable called "effort" to configure it.

    1. Because this action prompts users for input, the Display Name is configured as follows to provide instructions:

      Select the estimated amount of effort to resolve

    2. For the purposes of this example, Selection List is selected for the Variable Type. This option allows the action to offer multiple selection options. Three string list items are configured:

      • small

      • medium

      • large

    The configuration for the prompt resembles the following image when complete:

    ActionsMenuConfigureList.png

  7. Click Confirm to finish configuring the prompt variable.

  8. Click Save to finish configuring the menu action.

The action in use:

Because this is an incident menu action, it is accessible when a user right-clicks an incident on the Incidents page. When the incident is right-clicked and the action selected from the resulting menu, the user is presented with the following:

ActionMenuEditPromptVariables.png

If the user selects "small" from the list and then clicks Confirm, the incident is tagged in the following way:

"tags.small":1;

You can use tagging to automate many activities using workflow, such as sending notifications, assigning users, or sending announcements.

In this section: