Sentries

Overview

Sentry is an agent that connects remote hosts to Logpresso Sonar for log collection. In Settings > Sentries, you can register the target host OS and the server that the Sentry will connect to, then copy the installation command generated by the web console and run it on the target host.

After deployment, you can monitor connection status together with CPU, memory, disk, and network usage from the list. If a Sentry is connected, you can click its Sentry ID to open remote actions such as process lookup, network connection lookup, routing table lookup, ARP cache lookup, thread dumps, bundle lookup, and restart.

View the Sentry list

Open Settings > Sentries to view the Sentry list.

• Status: Shows whether the Sentry is connected. Connected Sentries are shown with an active indicator.
• Node: Shows the cluster node or node pair that the Sentry connects to.
• Sentry ID: Shows the unique identifier of the Sentry. For connected Sentries, clicking it opens the remote action menu.
• Hostname: Shows the hostname where the Sentry is installed.
• Version: Shows the installed Sentry package version.
• CPU: Shows CPU usage as a progress bar and percentage.
• Mem: Shows memory usage as a progress bar and percentage.
• Storage: Shows disk usage. If the host has multiple disks, the highest usage is displayed.
• NIC RX: Shows receive bandwidth usage. If the host has multiple network interfaces, the highest usage is displayed.
• NIC TX: Shows transmit bandwidth usage. If the host has multiple network interfaces, the highest usage is displayed.

Use the search box to narrow the list by Sentry ID or hostname.

Download the list

To save the list as a file, click on the toolbar. The downloadable fields are status, node, Sentry ID, hostname, version, CPU, memory, storage, NIC RX, and NIC TX.

Refresh the list

To reload the latest status, click on the toolbar.

Add a Sentry

Before you deploy Sentry to a new server, create a Sentry registration entry first.

1. In Settings > Sentries, click Add.

2. In the Add Sentry panel, configure the following fields and click Save.

   

   • OS: Select the operating system of the target host. Depending on the environment, only supported options are shown from Linux, Windows, AIX, Solaris, and HP-UX. In CC-compliant mode, only Linux is available.
   • Sentry ID: Enter the unique identifier for the Sentry in the cluster (required, up to 62 characters). The value must be in a valid domain name or hostname format.
   • Target: Select the cluster node that the Sentry will connect to (required). The list shows the node type together with the VIP or host address.
   • Auth Token: Enter the token to use during installation (required). A random value is generated by default, and it must follow the 1234-abcd format with four digits, a hyphen, and four lowercase letters.

3. After the Sentry is created, the installation command dialog opens.

View the installation command

After you create a Sentry, the Sentry Installation dialog displays the command that you must run on the target host.

• The dialog instructs you to open a terminal as an administrator on the target server and run the displayed command.
• Click Copy To Clipboard to copy the installation command.
• Click OK to close the dialog and return to the Sentry list.

The installation command is generated from the selected OS, Sentry ID, target server, and auth token. The installation is completed only after you run the command on the target host.

Delete a Sentry

To remove a registered Sentry entry from the list, select the Sentry and click Delete.

The delete confirmation dialog shows the selected Sentry ID and Hostname.

Remote Sentry actions

For a connected Sentry, click the arrow next to Sentry ID to open the remote action menu. The menu does not open for disconnected Sentries.

The remote action menu provides the following actions:

• Processes
• Network Connections
• Routing Table
• ARP Cache Table
• Thread Dumps
• Top Threads
• Bundles
• Restart

Processes

Click Processes to open the process list of the selected Sentry host in a new window.

Network Connections

Click Network Connections to open the network connection information of the selected Sentry host in a new window.

Routing Table

Click Routing Table to open the routing table of the selected Sentry host in a new window.

ARP Cache Table

Click ARP Cache Table to open the ARP cache information of the selected Sentry host in a new window.

Thread Dumps

Click Thread Dumps to open the full thread dump of the selected Sentry in a new window.

Top Threads

Click Top Threads to open the busiest thread information of the selected Sentry in a new window.

Bundles

Click Bundles to open the deployed bundle information of the selected Sentry in a new window.

Restart

Click Restart to send a restart request to the selected Sentry after confirmation. When the restart completes, the list is refreshed again.