Devices Hosts Services - chuckablack/quokka GitHub Wiki

Devices

Here's an example of the Devices table:

images/devices.png

The devices table, above, shows a list of the devices that quokka is monitoring. For every device, quokka is going out to the device, establishing a connection (SSH or NETCONF), gathering information from the device, and displaying it in this screen (and elsewhere).

Note: The devices named "SDWAN-..." is the table are simulating remote devices that are using HTTP to communicate with the quokka server, rather than the 'normal' method of quokka using SSH or NETCONF to communicate with the device

The fields in this table are:

  • Actions: These are buttons that will cause quokka to collect and display other data, such as status, or to execute some diagnostic function, such as packet capture, config diff, or traceroute.
  • Status: This field displays a green check mark (device responded to most recent request), or a red X (device failed to respond to most recent request).
  • Name: A friendly name given to the device, which must be unique. (configured)
  • Hostname: This is the hostname used to communicate with the device. (configured)
  • Vendor:OS: This is the device vendor and OS. (configured)
  • IP Address: This is the IP address that was discovered for the device.
  • CPU%: This is the most recent CPU utilization retrieved or sent from the device.
  • Memory%: This is the most recent Memory utilization retrieved or sent from the device.
  • Rsp Time: This is the response time, in seconds, that it took to for communication with the device to occur.
  • Last Checked: This is a timestamp when the device was last heard from.

Hosts

Here's an example of the Hosts table:

images/hosts.png

The hosts table, above, shows a list of hosts that have been discovered, and are being monitored. For every host, quokka executes a ping, and records the availability and response time to that host.

The fields in this table are:

  • Actions: These are buttons that will cause quokka to collect and display other data, such as status, or to execute some diagnostic function, such as packet capture, TCP port scan, extended port scan, or traceroute.
  • Status: This field displays a green check mark (host responded to most recent ping), or a red X (host failed to respond to most recent ping).
  • Name: The discovered hostname associated with this host.
  • IP Address: The discovered IP address for this host. Note that since we discovered hosts by pinging IP addresses, this is the first bit of information we learn.
  • MAC Address: The discovered MAC address for this host.
  • Rsp Time: This is the response time, in seconds, that it took to execute a ping to this host, and receive a response.
  • Last Checked: This is a timestamp when the host was last heard from.

Services

Here's an example of the Services table:

images/services.png

The services table, above, shows a list of services that are being monitored. For every service, quokka executes the appropriate method of communicating with the service (e.g. HTTP, or DNS, or NTP), and records the availability and response time to that service.

The fields in this table are:

  • Actions: These are buttons that will cause quokka to collect and display other data, such as status, or to execute some diagnostic function, such as packet capture, or traceroute.
  • Status: This field displays a green check mark (service responded to the most recent communication attempt), or a red X (service failed to respond to the most recent communication attempt).
  • Name: The configured friendly name associated with this service.
  • Type: The type of the service being tested. This value will drive the type of communication attempted to the device. Currently supported types are only HTTP, DNS, and NTP.
  • Target: This is the target for where the service can be reached. Depending on the service type, this value can currently be an IP address, hostname, or a URL.
  • Data: This extra information, if necessary, is used in the communication attempt to the service. For example, for DNS, the 'data' will be the hostname to loopup.
  • Rsp Time: This is the response time, in seconds, that it took to communicate with this service.
  • Last Checked: This is a timestamp when the service was last heard from.