Server monitor configuration

After you install the New Relic server monitor, refer to this document for configuration settings.

Configuration file

The configuration file for Linux-based System Monitor daemons is at /etc/newrelic/nrsysmond.cfg. If you change any settings, you must restart the daemon before the changes will take effect.

Configuration settings

Here is a summary of Linux-based System Monitor configuration settings.

license_key

The 40-character license key provided to you by New Relic. To view your license key: From the New Relic title bar, select (account) > Account settings. For more information, see License key.

A valid license key is required in order for the server monitor to start.


loglevel

The level of detail you want to see in the log files:

  • error: Show errors only (default).
  • warning: Show errors and warnings.
  • info: Show errors, warnings and minimal additional informational messages.
  • verbose: Show more detailed information messages.
  • debug: Show debugging messages.
  • verbosedebug: show very detailed debug messages.

You can also set the loglevel from the command line.


logfile

The name of the file where the server monitor will store its log messages. The amount of detail included is controlled by the loglevel option.


proxy

Asks the server monitor to connect to the New Relic collector via a HTTP proxy. Possible formats include:

  • user:password@host:port
  • user:password@host
  • user@host:port
  • user@host
  • host:port
  • host

If you do not specify a port, it uses the default 1080.


ssl

Indicates whether or not to use SSL for communication with the New Relic collector (default: false). Certain rare cases may require you to modify the SSL certificate settings below.


ssl_ca_bundle

The name of a PEM-encoded Certificate Authority (CA) bundle to use for SSL connections. This should very rarely need to be set.

By default, the monitor will attempt to find the bundle in the most common locations. If you need to use SSL and the monitor is unable to locate a CA bundle, then either use this, or use ssl_ca_path to inform the server monitor where to find CAs.

Use a comma-separated list of path names to bundle files. Default: /etc/ssl/certs/ca-certificates.crt,/etc/pki/tls/certs/ca-bundle.crt


ssl_ca_path

If your SSL installation does not use CA bundles but has a directory containing PEM-encoded CA files, set this option to the name of the directory containing all the CA files. Default: /etc/ssl/certs.


pidfile

The file used to record where the server monitoring daemon will store its process ID (PID). This is used by the init script to determine whether the monitor is currently running and which PID to kill when shutting down. Default: /tmp/nrsysmond.pid


collector_host

The host name of the New Relic collector. Default: collector.newrelic.com. Caution: Do not change this setting unless New Relic Support advises you to do so. The format is host[:port]. A port number of 0 will imply port 80 without SSL enabled, and port 443 with SSL enabled.


timeout

The amount of time the monitor should wait to contact the collector host, in seconds (default: 30). If the connection cannot be established in this period of time, the monitor will progressively back off in 15 second increments to a maximum of 300 seconds (5 minutes). Once the initial connection has been established, the timeout value is reset back to the value specified here.


Firewall configuration

The server monitoring agent requires your firewall to allow an outgoing connection to New Relic's networks on TCP port 80 (or port 443 if you configure the agent to use SSL). To test the outgoing connection and incoming response, use curl or wget.

Using curl:

curl -v http://collector.newrelic.com/status/mongrel
[or]
curl -v https://collector.newrelic.com/status/mongrel  // if SSL

Using wget:

wget -O- http://collector.newrelic.com/status/mongrel
[or]
wget -O- https://collector.newrelic.com/status/mongrel  // if SSL

For more help

If you need additional help, get support at support.newrelic.com.