Agent Web Interface

The agent can be configured to offer its own web (HTTP)-based interface. The interface allows users to retrieve measurements and other information from the agent, and it also lets users change agent configurations, queue application ping requests, etc.

Enable Agent Web Server

The agent web server can be enabled either through the configuration distributed by PerformanceGuard or by adding registry values on individual computers that run the agent.

In the default configuration, the agent web server is enabled on port 4007 for access from the same computer, eveen if the agent GuiMode parameter is set to NoWindow. You should make sure to change the web server setup in the agent configuration (as explained in the following) if you want to change this.

Access Agent Web Interface

The agent web interface can be reached on the '/' resource on the configured port, which will redirect you to the '/cmd/cmd ' resource.

By default you'll see the View > Status page.

The agent web interface's yellow menu bar provides access to a wide range of configuration information as well as data collected by the agent.

Example: Select View > IP Data to view IP-traffic data measured by the agent. This is the same as typing view ip data in the agent's Telnet interface.

Example: Select View > DNS to view all entries in the agent's reverse DNS cache. This is the same as typing view dns in the agent's Telnet interface.

Agent 'Get' Interface

There is an additional web-based interface URL, which is normally used to relay information to the system tray icon. This interface is reached on, for example, http://localhost:4007/get/get?version=0.
One or more parameters may be queried in a single request:

Parameter

Value

version

Build label

isservice

true if the agent runs as a windows service

build_time

Date and time of compilation

window_title

Window title to use for Agent

agent_name

Name of agent distinguishes OEM agents

agent_dir

Catalog where agent is installed

agent_id

ID assigned by PerformanceGuard backend server for the agent

configuration_id

ID of the configuration currently used by the agent

protocolversion

Version of the protocol used to communicate with the PerformanceGuard backend

GUImode

Configuration values that control how the agent should be presented

configuration

Agent configuration string


The following command will query all variables:

http://localhost:4007/get/get?version=0&isservice=0&build_time=0&window_title=0&agent_name


Result:

version=Internal Jun 27 2007 09:44:48
isservice=no
build_time=-
window_title=PremiTech PerformanceGuard Agent
agent_name=GuardAgentD
agent_dir=C:\Dev\bugfix-pg-5-1\premitech\bin\win32
agent_id=5
configuration_id=1
protocolversion=510
GUImode=Icon Window NoExit AutoHide SendReport
configuration="Promiscuous=false
FrameType=Ethernet
DiscoverServerPorts=true
TCPReport=true
UDPReport=true
UDPLocalPortBlackList=1-1024
CitrixReport=true
CitrixStatInterval=10
ProcessStatInterval=10
DiskIOReport=true
CPUUsageLimit=1
CPUTop=0
MemTop=0
GUIMode=Icon Window NoExit AutoHide SendReport
SocketReadTimeOut=6000
keepalivefilter=Server=0.0.0.0/0 Port=0-65535 Type=TCPKeepAlive\tServer=0.0.0.0/0 Port=139
Type=NetBiosKeepAlive
TelnetClientList=127.0.0.1/8
ReportInterval=60
HistogramIntervals=10,20,50,100,200,500,1000,2000,5000"

Search this documentation

On this page

In this section