Monitoring performance counters

Once you have published an performance counter in WinGate, you can then set the Data module to begin monitoring the counter data.

Note

To monitor performance counters in WinGate:

1. Open the WinGate Management console.
2. Navigate to Control Panel > Data.
3. On the Monitoring tab, select the appropriate performance counter that you wish to monitor. The data source for published performance counters is called PerfCounters.

   

   Close | Close all images

   Right click on the selected performance counter and select Enable monitoring. Alternatively double click the published performance counter data that you wish to monitor. This will open the Monitoring properties.

   

   Close | Close all images

4. On the Monitoring properties ensure the Collect data for monitoring checkbox is ticked (this is selected by default).

   Note

   When you are configuring the properties of a piece monitored data, the Threshold checking options are optional.

   Read about threshold checking

5. Click OK to confirm the performance counter data will be monitored. The piece of monitored data will now display Receiving data in its Status column on the Monitoring tab.

   Note

   You can stop WinGate from monitoring a piece of data by right clicking on it (in the Monitoring tab) and selecting Disable monitoring.

To monitor performance data using scripting or the Symbol browser:

It is also possible to begin monitoring performance counter data (that has been published for monitoring) when using a WinGate scripting system, or a configuration that has access to a Symbol browser. The Data system publishes the Data.GetMonitor(Text DataSource, Text DataItem) method for this purpose.

When you use this method, it will check to see if the specified published data provided by the specified data source is currently being monitored. If it isn't, it will automatically turn on monitoring for the selected piece of published data. This alleviates the need to switch on monitoring for the selected data from the Monitoring tab, before being able to access or refer to it in script.

e.g.

A script could contain:

This would attempt to see if a piece of performance counter data called externalPackets (DataItem) published by PerfCounters (DataSource) is currently being monitored. If it isn't, then WinGate will begin monitoring the published data named externalPackets.

Read more about using WinGate objects

Using monitored data

Once you have set a piece of data to be monitored, it is available to be read and referred to by other WinGate services and components just like global data items.

Read about accessing monitored data