Data stream capture

The probe can log the raw data stream sent from a device to a data stream capture file. The raw data can be used for debugging purposes, to develop new features for the probe, or to pass to other management systems that require the same data.

To enable data stream capture, use the StreamCaptureFile property to specify a file in which to store the data.

For each connection to a Tekelec Eagle STP device, the full data stream is stored in a log file. The file is named according to the following naming convention:

streamcapturefile_host_port

where streamcapturefile is the file name specified by the StreamCaptureFile property and host and port are the host name and port of the device to which the probe is connected.

The data stream capture function can generate large log files. To conserve disk space, disable this function when you no longer require the data.

Rotating stream capture files

The probe can rotate stream capture files by archiving files that reach a predefined size.

To enable the rotation of stream capture files, set the DateStreamCapture property to 1. This makes the probe append a timestamp to the stream capture file name. When the data stream file reaches the maximum size specified by the MaxStreamCapFileSize property, the file is archived and a new file is opened with a new timestamp. If the data stream being read exceeds the remaining space in a file, a new file is started to ensure that the entire stream is captured in one file.

If you do not use the MaxStreamCapFileSize property to specify a maximum size for the stream capture file, the file grows indefinitely until the connection is closed.

If the MaxStreamCapFileSize property is enabled and the DateStreamCapture property is set to 0, the probe overwrites the stream capture file each time the maximum file size is reached.