Log Files

The /var/log/clusterware/ folder contains several ICE ClusterWare ™ log files and audit files to help diagnose problems. Additionally, the ClusterWare database service may have useful information in its logs. You can find etcd logging in /var/log/clusterware/etcd.log.

On a typical head node, the /var/log/clusterware/ folder contains api_access_log and api_error_log files. These are the Apache logs for the service providing the REST API. The log level available in this file is controlled by the Pyramid logging configuration in the /opt/scyld/clusterware/conf/pyramid.ini file. The Pyramid project documentation contains details of the pertinent variables https://docs.pylonsproject.org/projects/pyramid/en/latest/narr/logging.html

The various /var/log/clusterware/* log files are periodically rotated, as directed by the /etc/logrotate.d/clusterware, /etc/logrotate.d/clusterware-dnsmasq, and /etc/logrotate.d/clusterware-iscdhcp configuration files that are distributed in the clusterware, clusterware-dnsmasq, and clusterware-iscdhcp RPMs, respectively.

Note

If you modify the /etc/logrotate.d/clusterware file, then a subsequent update of the clusterware RPM installs a new version as /etc/logrotate.d/clusterware.rpmnew. You can merge this clusterware.rpmnew into the local customized /etc/logrotate.d/clusterware. You can do the same for clusterware-dnsmasq and clusterware-iscdhcp.

The default log level of WARNING should be useful, but not overly verbose. The options from most terse to most verbose are AUDIT, ERROR, WARNING, INFO, DEBUG.