Skip to main content

getMergeGroups

A Graze API GET request that returns details of all the custom merge groups in Moogsoft Enterprise.

Back to Graze API EndPoint Reference.

Request arguments

Endpoint getMergeGroups takes the following argument:

Endpoint getMergeGroups takes no other arguments because this endpoint returns details of all the custom merge group in Moogsoft Enterprise.

Response

Endpoint getMergeGroups returns the following response:

Successful requests return an array of JSON objects containing the following:

Name

Type

Description

name

String

The merge group's name.

moolets

Array of Strings

List of clustering algorithm Moolets to include in the custom merge group.

alert_threshold

Integer

Minimum number of alerts that must be present in a cluster before it can become a Situation. Must be greater than or equal to 1. Enter null if you want the custom merge group to use the default merge group value. Default merge group value is 2.

situation_similarity_limit

Floating Point

Percentage of alerts two Situations must share before they are merged for this group. Enter a value between 0 and 1. Entering null causes the merge group to use the same value as the default merge group.

Examples

The following examples demonstrate typical use of endpoint getMergeGroups:

Request example

Example cURL request to return all the custom merge groups in Moogsoft Enterprise:

curl -G -u graze:graze -k "https://example.com/graze/v1/getMergeGroups"

Response example

Example response returning details of all the custom merge groups in Moogsoft Enterprise:

[
{
    "name":"Default Cookbook",
    "moolets":
    [
        "Default Cookbook"
    ],
    "alert_threshold":2,
    "situation_similarity_limit":0.6
},
{
    "name":"Merge Group 1",
    "moolets":
    [
        "Recipe 1"
        "Recipe 2"
    ],
    "alert_threshold":null,
    "situation_similarity_limit":0.5
},
{
    "name":"Merge Group 2",
    "moolets":
    [
        "Recipe 2"
        "Time Based (Tempus)"
    ],
    "alert_threshold":2,
    "situation_similarity_limit":null
}
]