Table of Contents

Displaying alarm statistics in the Surveyor

In the Surveyor, statistical alarm data can be displayed next to elements, services and views.

The settings that control the data being displayed have to be configured in MaintenanceSettings.xml and are synchronized across all DMAs in the DMS.

Tip

See also: Surveyor – Displaying alarm statistics on DataMiner Dojo Video

Configuration in MaintenanceSettings.xml

  1. Stop the DataMiner software.

  2. Open the file C:\Skyline DataMiner\MaintenanceSettings.xml.

  3. In the Surveyor tag, configure the ViewStatistics, ServiceStatistics and ElementStatistics subtags.

    To do so, enter strings consisting of fixed text, placeholders and section separators. These strings will determine which information will be displayed and how it will be displayed.

    • The following placeholders can be used:

      Elements Services Alarms
      [#CriticalElements] [#CriticalServices] [#CriticalAlarms]
      [#MajorElements] [#MajorServices] [#MajorAlarms]
      [#MinorElements] [#MinorServices] [#MinorAlarms]
      [#WarningElements] [#WarningServices] [#WarningAlarms]
      [#NormalElements] [#NormalServices] [#NormalAlarms]
      [#TimeoutElements] [#TimeoutServices] [#TimeoutAlarms]
      [#NoticeElements] [#NoticeAlarms]
      [#ErrorElements] [#ErrorAlarms]
      [#MaskedElements] [#MaskedAlarms]
      [#TotalElements] [#TotalServices] [#TotalAlarms]

    • Use three hash signs (“###”) to separate sections in the ViewStatistics, ServiceStatistics and ElementStatistics string.

      A section is only displayed if the current value of the placeholder it contains is different from 0.

      Examples:

      ###[#TotalAlarms] Active alarms ###(Including [#CriticalAlarms] Critical)###
###[#TotalAlarms] Active Alarms: ###[#CriticalAlarms] Cr ###[#MajorAlarms] Ma ###[#MinorAlarms] Mi ###[#WarningAlarms] Wa ###[#NormalAlarms]
Clearable ###[#NoticeAlarms] Notice ###[#ErrorAlarms] Error ###[#MaskedAlarms] Masked ###[#TimeoutAlarms] Timeout ###
      Note

      On a DMA with a ticketing gateway, it is also possible to display ticket statistics, or to combine ticket statistics with alarm statistics in the Surveyor. For more information, see Displaying ticket statistics in the Surveyor.

  4. Save your changes and restart DataMiner.

Note

If the DMA is part of a DMS, the setting will be applied across the DMS during the midnight synchronization. Alternatively, you can also force an immediate synchronization. See Synchronizing data between DataMiner Agents.

Example of a Surveyor configuration in MaintenanceSettings.xml

<MaintenanceSettings>
  ...
  <Surveyor>
    <ViewStatistics>[#TotalAlarms] Active Alarms</ViewStatistics>
    <ServiceStatistics>[#TotalAlarms] Active Alarms</ServiceStatistics>
    <ElementStatistics>[#TotalAlarms] Active Alarms</ElementStatistics>
  </Surveyor>
  ...
</MaintenanceSettings>
Tip

See also: MaintenanceSettings.xml

View statistics in Visio drawings

Using the same syntax as in MaintenanceSettings.xml, view statistics can also be displayed in Visio drawings.

Tip

See also: Making a shape display information about the item it is linked to

Propose changes