Getting Started

3. Adding Collectors

Installation Settings

Before downloading and installing your Collector, complete the installation settings (e.g. Collector type, version, etc.) found in the first two areas of the Add a Collector dialog. This dialog can be accessed in one of two ways:

  • If you're starting from the new account wizard, then you've just created your first user and are now being presented with the Add a Collector dialog.
  • If you've already exited or completed the wizard, you can open the Add a Collector dialog by navigating to Settings | Collectors | Add | Collector, as shown next.

As discussed in the following sections, there are several installation settings that must be configured before a Collector can be installed.

Choose Where to Install a Collector

Prior to configuring your new Collector, you will need to decide to which resource it will be added. It is common for companies to place the Collector on machines such as syslog servers, DNS servers, or other relatively unconstrained servers.  

Requirements for Collector Servers

For each location of your infrastructure, we recommend that you install a Collector on a server that is physically close to the resources it will monitor. For the sake of reliability, you do not want a Collector to have to communicate across the internet to poll resources in another data center, or through firewalls, or network address translation (NAT) gateways.

You should additionally ensure that the server you choose for Collector installation meets the requirements outlined next:

  • Windows or Linux server. The server must be a Windows or Linux (physical or virtual) server. If you want to collect data from Windows systems, the Collector must be installed on a Windows server.

    Note: LogicMonitor follows the Microsoft Lifecycle Policy (specifically the "Extended Support End Date") and the Red Hat Enterprise Linux Life Cycle (specifically the "End of Maintenance Support 2 (Product retirement)" date) when determining which Windows and Linux server operating systems are supported for Collector installation.

  • Comprehensive port access. The server must be able to able to make an outgoing HTTPS connection (TLS on port 443) to the LogicMonitor servers (proxies are supported). In addition, the ports for the monitoring protocols you intend to use (e.g. SNMP, WMI, JDBC, etc.) must be unrestricted between your Collector machine and the resources you want to monitor. For a detailed listing of the ports that the Collector host needs to be able to access, see About the LogicMonitor Collector.
  • 1GB of RAM. A minimum of 1GB of RAM (preferably 2GB if you plan to collect data from more than 100 resources). Visit the Collector Capacity page for more information.
  • Reliable time. The Collector should have reliable time, thus the server should have NTP setup or Windows Time Services to synchronize via NTP. If running on a VMware virtual machine, install VMware tools with VMware tools periodic Time Sync disabled.

Monitor the Device on Which the Collector Is Installed

Check the Monitor the Device on which the Collector is installed option if you'd like to enter the device on which the Collector is installed into monitoring. For more information on the importance of monitoring the device on which the Collector is hosted, see Monitoring Your Collectors.

If this option is checked, the Device Group field displays, allowing you to assign the Collector's host (i.e. the device onto which you are installing the Collector) into a device group. Even if you leave the device "Ungrouped," LogicMonitor will automatically add the Collector's host to the dynamic group titled "Collectors." For more information on device groups, see Device Groups Overview.

Select a Collector

In the Select a Collector area of the Add a Collector dialog box (shown next), select the download file you will install, its version, and size (which correlates to monitoring capacity). You also have the option of assigning the new Collector to a Collector Group.

Select Collector Download File

Select the appropriate Collector download file for your server:

  • 32 bit or 64 bit Windows
  • 32 bit or 64 bit Linux

Select Collector Version

Select among the available General Release and Early Release Collectors:

  • General Release Collectors. General Release Collectors are our most stable Collector versions available. We recommend this Collector version for the majority of your infrastructure.
  • Early Release Collectors. Early Release Collectors offer new features and functionality, but we cannot guarantee that they are perfectly stable and bug-free. For this reason, we recommend that you use an Early Release Collector version only when it has features from which you would benefit. If you have a large deployment, we don't recommend this Collector version for your entire infrastructure.

Note: You can always change your Collector version by uninstalling and re-installing a Collector.

Select Collector Size

If you are downloading Collector version 23.000 or higher, you will be given the option to select the Collector's size. There are four Collector sizes available:

  • Nano. This Collector does not have a memory requirement as it will consume less than 1GB of system memory and will monitor a limited number of Resources.
  • Small. This Collector will consume approximately 2GB of system memory and is capable of monitoring roughly 200 (Linux Collector) or 100 (Windows Collector) Resources.
  • Medium. This Collector will consume approximately 4GB of system memory and is capable of monitoring roughly 1000 (Linux Collector) or 500 (Windows Collector) Resources.
  • Large. This Collector will consume approximately 8GB of system memory and is capable of monitoring roughly 2000 (Linux Collector) or 750 (Windows Collector) Resources.

Note: The number of Resources a Collector can monitor varies depending upon the data collection method it employs (e.g. SNMP, JDBC, WMI, etc). Please visit this page for a breakdown of Collector capacity by data collection method as well as the config settings for each Collector size.

Assign the Collector to a Collector Group

From the Collector Group field, you may assign your new Collector to an existing Collector Group or use the + icon to the right of the field to create a new group on the fly. Collector Groups pool your Collectors based on factors such as their physical locations, their environments (e.g. QA, development, or production), or- if you are an MSP- customer. This streamlines the process of configuring permission settings and managing your Collectors. For more information on Collector Groups, see Collector Groups.

Downloading and Installing Collectors

This section overviews the steps and strategies for:

Installing a Windows Collector

To install a Windows Collector:

  1. You can either install your Collector using the new account setup wizard or from the Settings tab of your account if you've already exited or completed the wizard.
    • If you're starting from the new account wizard, then you've just created your first user and are being prompted to select installation settings (e.g. Collector type, version, etc.) for your first Collector.
    • If you're starting from the Settings tab, click Add in the Collectors section, establish the installation settings and click Next.
  2. Once you've downloaded the installer, open it. This will start the Install Shield Wizard on Windows. The Install Shield Wizard will extract the binary and prompt you for credentials.

    These credentials will correspond to the account that the Collector will run under. If other Windows systems will not be monitored by this Collector, you can run the services as Local System. Otherwise, consider specifying a domain account that is a local administrator for all the Windows computers to be monitored with a password set not to expire. Running the Collector in this context greatly reduces the likelihood of authentication issues, as the account should be able to access and query all monitored computers. If the computer hosting the Collector is not part of a domain, it is recommended that you run the Collector service as a local administrator account.

    The supported Windows credentials are:

    • Collector and monitored resources in domain, Collector running as domain account with local administrator privileges.
    • Collector and monitored resources not in domain, Collector running as local administrator account, and connecting to each host with local administrator credentials. For more information, see Credentials for accessing remote Windows computers.

    Note: As discussed in the Troubleshooting Windows Collectors area of this support article, the LogicMonitor Collector service must be granted "Log on as a service" under "Local Policy/User Rights Assignment" in the host OS local security policy settings.

  3. After you've successfully installed the Collector on your Windows server, return to your browser and verify that the Collector can communicate with LogicMonitor's datacenters.
  4. If the Windows OS where your Collector is installed is protected by an antivirus application, you will need to put in place a recursive exclusion for the LogicMonitor Collector application directory, as discussed in About the LogicMonitor Collector.

Installing a Linux Collector

Note: You may need to install PERL before installing the Collector. A typical PERL installation command on RedHat/CentOS is yum install perl.

To install a Linux Collector:

  1. You can either install your Collector using the new account setup wizard or from the Settings tab of your account if you've already exited or completed the wizard.
    • If you're starting from the new account wizard, then you've just created your first user and are being prompted to select installation settings (e.g. Collector type, version, etc.) for your first Collector.
    • If you're starting from the Settings tab, click Add in the Collectors section, establish the installation settings and click Next.
  2. If your server supports web browsing, you can download the installer directly to your server. Otherwise, you can either use cURL or Wget to download the installer to your server, or you can download the installer on another computer and use scp to copy it over to your server. If you intend to use cURL or Wget, use the 'get cURL cmd' or 'get Wget cmd' buttons to copy the download command directly to your clipboard.

    Note: In Linux environments with Collectors running in containers, the Collector must run as root. SUID root is /bing/ping.

  3. You can SSH into your Linux server, and paste the copied command to download the installer to your server:

  4. Next change the permissions and make the binary executable, and then run the executable:

  5. After you've successfully installed the Collector on your Linux server, return to your browser and verify that the Collector can communicate with LogicMonitor's datacenters.

Installing Using the Bootstrap 

You will notice "bootstrap" and "full package" options under the "Download a Collector" stage. The bootstrap is a smaller installation package (~500kB) that enables you to download and install Collectors much faster via the LogicMonitor CDN, whereas the "full package" option is approximately 200MB.

Troubleshooting Collectors

Next we've compiled some helpful troubleshooting tips for Windows and Linux Collectors.

Troubleshooting Windows Collectors

Error 1069

A common error encountered for Windows Collectors is error 1069:

Error 1069: The service did not start due to a logon failure.

The account used to run the LogicMonitor collector Windows services must have "Logon as a service" rights in the host's local security policy.

Here are the steps to adjust "Log on as a service" in local security policy:

  1. Log on to the host under an account with local Administrators group membership.
  2. From CMD, PowerShell, or Run, launch secpol.msc.
  3. Expand "Local Policy" and click on "User Rights Assignment."
  4. In the right pane, right-click "Log on as a service" and select "properties."
  5. Click on the "Add User or Group" button to add the account which is to run the LogicMonitor collector services.
  6. In the "Select Users or Groups" dialogue, find the user you wish to enter and click "OK."
  7. Click "OK" in the "Log on as a service" properties window to commit the changes.

If you are unable to make these changes due to options being greyed out or, if after a period of time, the settings are reverted, you may need to look into either local or domain Group Policy settings enforcing local security policy settings on this host. It is also possible there are other configuration management tools managing local security policy.

Troubleshooting Other Common Windows Monitoring Scenarios

The most commonly used monitoring scenarios on Windows are based on WMI and Perfmon. Below are the typically referenced help pages to get going with monitoring Windows resources:

Troubleshooting Linux Collectors

NSCD

The LogicMonitor Collector makes a lot of DNS queries (to resolve the hosts it is monitoring, and to determine which LogicMonitor servers to report data to.)  While running nscd is a good idea, you should make sure that the nscd you run respects positive DNS TTLs.  For example, on Redhat ES/CentOS, glibc-2.5-24 and earlier does not respect DNS TTLs correctly, so ensure you are running a later version, or disable nscd.  This is important both for updates to your own hostnames that are monitored, but also in the event of a failover from one LogicMonitor datacenter to another - if nscd returns a stale record for an hour, this would impact your monitoring.
 

Please note that with GD.2300 onward
, we will be phasing out Collector installation support for RHEL and Centos version 5 releases (this includes 5.11 release). 

SE Linux

For certain Linux distributions (Redhat, CentOS, Fedora) Security-Enhanced Linux may be enabled, which poses additional permissions hurdles for the Collector to achieve reliable monitoring. You may use the following command to query SE Linux for  its current mode (enabled + enforcing or passive/disabled/permissive):

sestatus

If you are having monitoring problems on your Linux box and SE Linux "current mode" is set to "active", "enabled", or "enforcing" status, please use the following command to see if it alleviates your monitoring problems:

setenforce Permissive

In permissive mode, more denials are logged because actions that would otherwise be denied in enforcing mode are allowed.  As such, you may be able to run the Collector services in permissive mode and use the SELinux logs to identify the permissions that need to be enabled.  Once you've done so, you should enable the necessary permissions and then use "setenforce 1" to put SE Linux back into enforcing mode. 

Collector Hostname

How is the Collector's hostname set?

The Collector's name is established as soon as a Collector is downloaded and registered with a LogicMonitor server. The hostname is discovered by resolving the hostname of the Collector host.

For Linux, the Collector will run either a "hostname -f" or "hostname"  command to identify the hostname. If both commands fail, "localhost.localdomain" will be used.

For Windows, the hostname is a combination of the domain and COMPUTERNAME.

Is there anyway to change the Collector hostname?

The Collector hostname can not be changed via the LogicMonitor UI. If you wish to change it, you can rename the Collector's host and restart your Collector. This document details the process of resetting hostnames for Linux resources.

Next Steps

After you've installed a Collector, you can start adding Resources to be monitored.