8.8.2. Enabling Syslog for Node Components

Procedure 8.4. To Enable Syslog for Apache:

1. Configure Apache to send log messages to Syslog by adding the following option in the /etc/sysconfig/httpd file:

   OPTIONS="-DOpenShiftFrontendSyslogEnabled"

   Important

   All options must be on the same line. For example, in Section 8.5.2, “Enabling Application and Gear Context in Node Component Logs” another option for Apache log files is explained. If both options are desired, the line must use the following syntax:

   OPTIONS="-Option1 -Option2"

2. Restart the httpd service for the Apache changes to take effect:

   # service httpd restart

Procedure 8.5. To Enable Syslog for the Node Platform:

1. Configure the node platform to send log messages to Syslog by editing the /etc/openshift/node.conf file. Add the following line and any or all of the described optional settings that follow:

   PLATFORM_LOG_CLASS=SyslogLogger

   Optional Threshold Setting:

   Add the following line to include messages with priorities up to and including the set threshold. Replace priority in the following line with one of the levels listed at http://ruby-doc.org/stdlib-1.9.3/libdoc/syslog/rdoc/Syslog.html#method-c-log:

   PLATFORM_SYSLOG_THRESHOLD=priority

   Optional Trace Log Setting:

   Add the following line to include trace logs that were previously directed to the default /var/log/openshift/node/platform-trace.log file:

   PLATFORM_SYSLOG_TRACE_ENABLED=1

2. Restart the ruby193-mcollective service for the node platform changes to take effect:

   # service ruby193-mcollective restart

3. When Syslog support is enabled for the node platform, the local0 Syslog facility is used to log messages. By default, the /etc/rsyslog.conf file does not log platform debug messages. If you are using Rsyslog as your Syslog implementation, add the following line to the /etc/rsyslog.conf file to enable platform debug message logging. If necessary, replace /var/log/messages with your chosen logging destination:

   local0.*;*.info;mail.none;authpriv.none;cron.none /var/log/messages

   Then restart the rsyslog service:

   # service rsyslog restart

   With this change, all log messages using the local0 facility are sent to the configured logging destination.