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.
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,sip,cs-method,x-errors&id=1,2,3,5
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","64.35.192.225","10.0.24.51","GET","2"
"PAGE","2,25","210.32.156.200","10.0.20.23","GET",""
"PAGE","2","200.12.180.6","10.0.24.53","GET","2,7,3001"
"PAGE","2","10.0.34.52","10.0.10.38","POST",""
.
.
.
#ping
.
.
.
"PAGE","2","64.108.146.33","10.0.20.22","GET",""
"PAGE","2","10.0.34.52","10.0.24.31","POST",""
#rate threshold exceeded (dropped 3 records)
"PAGE","2,25","143.235.81.50","10.0.24.53","GET",""
#stream terminated: requested via UI
#x-record-type,x-wp,c-ip,s-ip,cs-method,x-errors
"PAGE","2","64.35.192.225","10.0.24.51","GET","2"
"PAGE","2,25","210.32.156.200","10.0.20.23","GET",""
"PAGE","2","200.12.180.6","10.0.24.53","GET","2,7,3001"
"PAGE","2","10.0.34.52","10.0.10.38","POST",""
.
.
.
#ping
.
.
.
"PAGE","2","64.108.146.33","10.0.20.22","GET",""
"PAGE","2","10.0.34.52","10.0.24.31","POST",""
#rate threshold exceeded (dropped 3 records)
"PAGE","2,25","143.235.81.50","10.0.24.53","GET",""
#stream terminated: requested via UI
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
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*