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 <telemetry-server-ip-address:port>; for example,
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 container's
systemd services or alter anything else in the container. The filesystem exposed in the console window is actually the container's filesystem.
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 warnings.
netq show agents
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.