Table of Contents

Managing parameter groups for RAD

From DataMiner 10.5.4/10.6.0 onwards, it is possible to manage relational anomaly detection (RAD) parameter groups using the SLNetClientTest tool. While you can configure and view the same things directly in RelationalAnomalyDetection.xml, with these messages you can for example configure a low-code app to visualize and manage the parameter groups.

  1. Connect to the DMA hosting the grouped parameters using the SLNetClientTest tool.

  2. Go to the Build Message tab of the main window of the SLNetCLientTest tool.

  3. In the Message Type dropdown list, choose one of the following messages. All message names start with the Skyline.DataMiner.Analytics.Rad. prefix:

    Message Function
    AddRADParameterGroupMessage Creates a new RAD parameter group. If a group with the same name already exists, the group will be updated instead.
    GetRADDataMessage Retrieves anomaly scores over a specified time range. Note that anomaly scores can only be retrieved for past time periods where 5-minute averaged trend data is available.
    GetRADParameterGroupInfoMessage Retrieves the configuration information for a specific RAD parameter group.
    GetRADParameterGroupsMessage Retrieves a list of all configured RAD parameter groups.
    RemoveRADParameterGroupMessage Deletes a RAD parameter group.
    Note

    In DataMiner 10.5.4, some of these messages may include "MAD" instead of "RAD", e.g. Skyline.DataMiner.Analytics.MAD.AddMADParameterGroupMessage. In this message, "MAD" stands for "multivariate anomaly detection", which is another name for RAD.

  4. Configure the necessary fields:

    • AddRADParameterGroupMessage:

      • GroupInfo > AnomalyThreshold: Optional. Defines the threshold for suggestion event generation. A higher value results in fewer suggestion events, a lower value results in more. If not specified, the default value 3 is used.

      • GroupInfo > MinimumAnomalyDuration: Optional. The minimum duration (in minutes) that deviating behavior must persist to be considered a significant anomaly. If not specified, the default value 5 is used.

      • GroupInfo > Name: The name of the parameter group.

      • GroupInfo > Parameters: A list of parameter instances (DataMiner ID, Element ID, Parameter ID, Primary Key) that will be monitored together by a RAD model.

      • GroupInfo > UpdateModel: Indicates whether the model should be updated continuously as new data becomes available (true), or only be trained initially based on available data at startup (false).

    • GetRADDataMessage:

      • EndTime: The end time of the period for which you want to retrieve anomaly scores.

      • GroupName: The name of the parameter group.

      • StartTime: The start time of the period for which you want to retrieve anomaly scores.

      Note

      Anomaly scores can only be retrieved for past time periods where 5-minute averaged trend data is available.

    • GetRADParameterGroupInfoMessage and RemoveRADParameterGroupMessage:

      • GroupName: The name of the parameter group.

    • GetRADParameterGroupsMessage: No additional fields need to be configured.

  5. Click Send Message.

Note
  • Keep in mind that the group names need to be unique and will be processed in a case-insensitive manner.
  • From DataMiner 10.5.4/10.6.0 onwards, you can also retrain the internal model used by RAD.
Warning

Always be extremely careful when using the SLNetClientTest tool, as it can have far-reaching consequences on the functionality of your DataMiner System.

Improve this page