Data stream capture

The probe can capture the stream of SOAP messages exchanged with the OPC Unified Architecture (UA) server and store it in a file. The data can be used for problem solving, debugging purposes, to develop new features for the probe, or to pass onto other management systems that require the same data.

To capture the data stream in log files, use the following procedure:

  1. Set the value of the StreamCapture property to 1.
  2. Set the value of the StreamCaptureFilePath property to the full path of a directory to hold the files of data.
    Notes:
    • Specify the full path of the directory. For example:

      /opt/tivoli/netcool/omnibus/var

    • You cannot include variables such as $OMNIHOME in the directory path.
    • If the directory does not exist, or StreamCaptureFilePath does not have a value, the probe stores the file in the directory that the probe was run from. That is, $NCHOME/omnibus/probes on a Linux or Unix system, or %NCHOME%\omnibus\probes\win32 on a Windows system.
  3. If the probe is running, restart the probe.

The probe now writes data to a file in the specified directory. The name of that file has the following format:

probename_soapws-timestamp.data

Where:

  • probename is the name of the probe defined in the Name property.
  • timestamp is the UTC time (expressed in milliseconds) when the file was created.
Example:
  • opc_ua_soapws-1402475122604.data
Note: Capturing the data stream to a log file generates a lot of data, consuming disk space and other system resources. So use this feature with caution. As soon as you no longer require the capture of data, set the value of the StreamCapture property to 0 and restart the probe.