Initiating Watchpoint streams

To initiate a stream, you must submit an HTTPS GET request to the system in the following format:

https://<SystemHost>/getstream?<parameters>

Where:

  • <SystemHost>is the IP address, alias, or host name of your BMC Real End User Experience Monitoring computer
  • <parameters> is one or multiple key-value pairs.

Note

Key value pairs must be separated by ampersands (&) and linked with equal signs (=).

Once the stream is initiated, it continues indefinitely. You can terminate a single stream or all streams.

Sample request

https://10.0.0.1/getstream?usr=jdoe&pwd=pa55w0rd&pages=c-ip,s-ip,cs-method,x-errors&id=54,18

This URL makes the system stream data from Watchpoints with IDs 54 and 18. You can find out what IDs your Watchpoints are by clicking them in the system and going to the Watchpoint details page.

Determining the Watchpoint ID

ss_determining_watchpoint_id_analyzer.png

Sample response

Responses contain a series of page or object records.

#version 1.1
#x-record-type,x-wp,c-ip,s-ip,cs-method,x-errors
"PAGE","2,18,20,54,62,10001","81.159.103.192","83.58.79.195","GET",""
"PAGE","2,18,20,45,48,54,62,10001","87.189.215.192","83.58.79.191","GET",""
"PAGE","2,18,20,54,62,10001","87.189.215.192","83.58.79.191","GET",""
"PAGE","2,18,20,45,48,54,62,10001","81.159.103.192","83.58.79.195","GET",""
"PAGE","2,18,20,45,48,54,62,10001","87.189.215.192","83.58.79.191","GET",""
"PAGE","2,18,20,45,48,54,62,10001","81.159.103.192","83.58.79.195","GET",""
"PAGE","2,19,25,45,48,54,62,10001","97.237.174.141","99.107.106.57","GET",""
"PAGE","2,18,20,45,48,54,62,10001","81.159.103.192","83.58.79.195","GET",""
"PAGE","2,18,35,45,48,54,62,10001","95.190.247.64","83.58.79.195","GET",""
"PAGE","2,18,35,45,48,54,62,10001","95.190.247.64","83.58.79.195","GET",""
"PAGE","2,19,45,48,51,54,62,10001","89.25.103.64","83.58.79.193","POST",""
"PAGE","2,18,20,53,10001","87.189.215.192","83.58.79.191","GET",""
.
.
.
#ping
.
.
.
"PAGE","2,18,19,45,48,54,62,10001","89.25.103.64","83.58.79.181","GET",""
"PAGE","2,17,19,45,48,54,62,10001","89.25.103.64","83.58.79.181","POST",""
"PAGE","2,19,45,48,54,62,10001","89.25.103.64","83.58.79.195","GET",""
"PAGE","2,18,19,45,48,54,62,10001","89.25.103.64","83.58.79.181","POST",""
"PAGE","2,18,35,45,48,54,62,10001","95.190.247.64","83.58.79.195","POST",""

The system sends a ping to keep the stream active during periods when there is no data to stream. This can prevent some proxy servers from terminating the connection.

Related topics

Watchpoint-stream-format
Stopping-Watchpoint-streams

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*