Moogsoft Docs

Create Services Labeler

You can add Situation Manager Labeler macros to the Situation description in a Sigaliser. When Moogsoft AIOps creates a Situation based upon the Sigaliser configuration, it automatically creates services based on the function and the alert data.

Before You Begin

Before you start to create services with Situation Manager Labeler, ensure you have met the following requirements:

  • You have the Situation Manager Labeler installed on your Moogsoft AIOps system. The utility is installed by default with Moogsoft AIOps v7.3 and higher. For previous releases, contact Moogsoft Customer Support to obtain installers and instructions.

  • You have identified the service data in your alerts or set up an Enrichment method to import the data into custom_info. See Enrichment for further information.

For example, an alert contains the following custom_info data:

{"services":["WinTel","Lync"]}
Configure a Recipe to Automatically Create Services

The following example demonstrates how to use labeler utility macros in a Cookbook Recipe to create services.

  1. In the Moogsoft AIOps UI, go to Settings > Cookbook Recipes.

  2. Create a new Recipe, completing the mandatory fields such as name, type and clustering information. See Configure a Cookbook Recipe for more information.

  3. Add a Situation Description that utilizes labeler macros. See the example below.

  4. Activate the Recipe. See Configure a Cookbook Recipe for further information.

An example Situation description is as follows:

Issue affecting the service:$$UNIQUE(custom_info.services). $$SERVICES(custom_info.services)

This instructs to perform the following actions as it ingests data:

  • Parse the data in the custom_info.services field of incoming events.

  • Obtain unique service names for the alerts the system adds to a Situation.

  • Preface the Situation's "Description" field with the text "Issue affecting the service: ".

  • Create a service in the Moogsoft AIOps database.

  • Assign the service to the Situation.

  • Append the Situation's Description field with the names of the impacted services.

When you are parsing a list of values stored as a JavaScript array, use $$ to prefix the macro. If the data is a string use the prefix $.

Once configured, Moogsoft AIOpst processes alerts using the Situation Description and the resulting Situation appears in the Moogsoft AIOps UI.

For example:

29960143.png