NetQ Service Console
The NetQ Telemetry Server provides access to the NetQ Service Console, a graphical user interface (GUI) for NetQ. The Service Console provides a command line interface for running NetQ commands.
The Cumulus NetQ Service Console utilizes elements of Portainer. You can read the Portainer license file here.
Connect to the Service Console
To connect to the Service Console:
Open an Internet browser.
In the Address Bar, type https://<telemetry-server-ip-address:port>; for example, 172.28.128.20:9000. Use http or https as appropriate. If you don’t know or remember the IP address of your Telemetry Server, refer to the Install NetQ chapter for details. The default port is 9000.
Enter your username and password to open the Service Console.
You can use the same credentials that you use to access the Telemetry Server VM. The Service Console user accounts are managed in the Telemetry Server itself, just like any Linux user account.
View Service Console Information
The lower lefthand corner of the Service Console window displays information about the Telemetry Server:
IP: The IP address of the Telemetry Server VM. In the default configuration, the IP field is empty. To have this field display the IP address, edit
/etc/cts/redis/host.confand set the
HOST_IPvariable to the Telemetry Server’s IP address, then restart the
sudo systemctl restart netq-gui.service.
Hostname: The hostname of the Telemetry Server VM. The hostname is based on the %H environment value in the
systemdservice configuration. If you change the hostname, you should restart the
netq-guiservice so the new hostname displays in the Service Console.
Role: The role that the NetQ database is in, which currently can be master or replica, if high availability (HA) mode is enabled. If it’s not enabled, master appears here. If the role is set to replica, this indicates that the node is part of an HA cluster, since there is no replica in a non-HA environment.
High Availability: A check mark appears if HA mode is enabled and the current node is the master node. This also determines that the master referred to in the role above is also the master for the Redis cluster in HA mode.
Redis availability: Indicates whether or not the Redis database on the Telemetry Server VM is reachable.
Version: Indicates the Service Console version installed. This should match your NetQ version.
Access the NetQ Command Line
The Service Console runs within the NetQ CLI container. You can use it
to connect to the NetQ command line locally within the container. You
can also use it to access the container’s
/etc/cts/netq directory to
edit or add configuration files under /
config.d. You cannot use it to
connect to the NetQ CLI on a remote system; nor can you access the
systemd services or alter anything else in the container.
The filesystem exposed in the console window is actually the container’s
In the Services window of the console, verify the NetQ CLI State is running, then click Launch console.
You are logged in to the Telemetry Server with root user privileges.
Run NetQ Commands
You can run all NetQ
show commands, agent configuration
commands, and the
resolve commands from within the
console, just as you would if you were logged directly into the network
switch or server . Check commands color the output text green to
indicate successful results, and red or yellow to indicate errors or
netq show agents
If the output from a given command it too wide for the current console window causing the data rows to wrap over lines, widen the console window by clicking and dragging the right edge of the window and then rerun the command for a cleaner view.
netq check bgp,
netq check agents and
netq check ntp
Note that in this example, BGP is not configured, so no information was found, NetQ Agents status is all good, and that multiple nodes are not time synchronized (which you would want to fix!).
Exit the Service Console
When you’re finished with the session, click Back to Services to close the console window, then click log out to close the Service Console.