Digital Experience Monitoring (DEM) Agent Installation#
Deployment Architecture#
VOSS Insights provides for the installation and configuration of Digital Experience Monitoring (DEM) Agents.
The VOSS Insights Forwarder is an agent that collects statistics such as latency and response times on various cloud endpoints, along with system CPU statistics, which is sent by means of the API back to the Arbitrator.
The purpose of the agents are to monitor network experience, in particular for Microsoft Graph API, Teams, Web login and Exchange.
Measuring and widgets are available to:
Measure hops
Measure latency
Measure web performance
Provide alarms on for example: too many hops, latency, bad response
A number of installation deployment options are available:
One agent built into a single Collector
Multiple agents within a customer network
Agent hosted in the cloud
Hardware/OS requirements#
The agent requires the deployment of a platform for it to run on - the agent itself is installed on that platform.
No specific hardware specification in terms of RAM, CPU, and so on is available: since this is a very lightweight agent, it can run on many hardware platforms.
However, some basic considerations are:
Location - you want the device to be as close to the end user environment as possible - e.g “on the floor” with the users, not part of the data center (DC) infrastructure. For instance, part of the office wifi if that is the primary means of connectivity, or cabled into the local LAN if that is the primary.
Connectivity - think of the different user connectivity options you want to test the experience over - LAN, wifi, guest wifi, etc.
Small form factors typically work best, for example Intel NUC, Raspberry Pi, an old laptop, and so on.
OS requirements are: Debian Linux OS. The agent installs via a Debian package install process.
The DEM agent does not currently support multiple network interfaces as part of the test suite - so if multiple interfaces are present, it will use the OS default routing. It is therefore currently best to just have a single network interface per device to ensure you know the interface being used.
Connectivity#
This section outlines the connectivity required to and from the agent.
VOSS Insights platform connectivity#
The agent needs to communicate with the Arbitrator - whether that is in the same environment or in the VOSS Cloud.
Destination |
Protocol/Port/Type |
Purpose |
---|---|---|
Arbitrator |
HTTPS 443 TCP ICMP |
Registration and sending test results |
Testing Connectivity#
DNS - for resolving hostnames as part of the testing.
The recommended tests require the following connectivity if you intend to use them. Additional/alternate connectivity may be required if other tests are intended to be used.
The current schedule of test runs is every 5 minutes.
Destination |
Protocol/Port/Type |
Purpose |
---|---|---|
HTTPS 443 TCP |
Graph API connectivity |
|
ICMP |
Reachability stats for graph |
|
HTTPS 443 TCP |
Access to Teams front-end |
|
ICMP |
Reachability stats for Teams |
|
HTTPS 443 TCP |
Web Testing example - microsoft login front-end |
|
HTTPS 443 TCP |
Web Testing example - Microsoft exchange web |
|
HTTPS 443 TCP |
Web Testing example - Microsoft exchange web |
Setup and Configuration#
From release 24.1, the Arbitrator is automatically furnished with a new user account.
This username is : voss_agent_api_user
Important
By default, no password is set for this user. Therefore, this account needs to have a password set.
To set the user password, log in to the configuration area of the Arbitrator and follow the steps below:
Click on Access Control .
Click on Users .
Click on the green pencil to modify.
Set the password.
Note when entering the password, you will see the text, but once the password is saved, it will be masked.
Once the password has been set, click the blue tick mark to confirm .
Click Save at the bottom of the page.
Agent Installation#
When installing the Voss-Forwarder package to the agent host, a number of failsafe options built in to assist you with the correct installation. These are also highlighted below.
The first step is to move the installation file to the host. (Use SCP, Filezilla, etc.)
The current file is named: voss-insights-forwarder-1.0.deb
At the host prompt, run:
sudo apt install ./voss-insights-forwarder-1.0.deb
Enter the IP Address or FQDN of the Arbitrator that the agent is to report to then press Enter. The agent will now do a connectivity check via ICMP (Ping) to the Arbitrator.
If connectivity is good, move on to the next step.
If there is no connectivity after 4 attempts, the package will exit.
Enter the username (if you created a new API user) or keep the default user and press Enter.
Enter the password (set on the Arbitrator). This will then check the credentials are valid.
If credentials are valid, you move on to the next step.
If credentials are invalid after 4 attempts, the package will exit.
Enter a customer name (data is required to continue) and press Enter.
Enter the Forwarder name (this should for example be a descriptive location). Press Enter.
This completes the configuration.
The DEM Agent Stats dashboard under Diagnostics > Synthetic Transactions Dashboards then shows each agent configuration on the widgets: Forwarder System Stats and Forwarder Linux Distributions.
See also:
Synthetic Transactions Dashboards.Changes to Agent Configuration#
In the event of redeploying the agent to another site or a different Arbitrator, the commands below allow you to make these changes.
To update or change configuration, run any of the following commands:
To change the IP Address or FQDN for the Arbitrator:
sudo ./etc/voss/bin/update-forwarder-arbitrator.sh
To update / change the API credentials:
sudo ./etc/voss/bin/update-forwarder-credentials.sh
To update / change the Customer:
sudo ./etc/voss/bin/update-forwarder-customer.sh
To update / change the Forwarder Name:
sudo ./etc/voss/bin/update-forwarder-name.sh