Chapter 7. Troubleshooting
This chapter contains logging and support information to assist with troubleshooting your RHEL OpenStack Platform deployment.
7.1. Logging
RHEL OpenStack Platform writes informational messages to specific log files; you can use these messages for troubleshooting and monitoring system events.
7.1.1. Log Files for OpenStack Services
Each OpenStack component has a separate logging directory containing files specific to a running service.
Table 7.1. Block Storage (cinder) log files
| Service | Service Name | Log Path |
|---|---|---|
|
Block Storage API
|
openstack-cinder-api.service
|
/var/log/cinder/api.log
|
|
Block Storage Backup
|
openstack-cinder-backup.service
|
/var/log/cinder/backup.log
|
|
Informational messages
|
The cinder-manage command
|
/var/log/cinder/cinder-manage.log
|
|
Block Storage Scheduler
|
openstack-cinder-scheduler.service
|
/var/log/cinder/scheduler.log
|
|
Block Storage Volume
|
openstack-cinder-volume.service
|
/var/log/cinder/volume.log
|
Table 7.2. Compute (nova) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack Compute API service
|
openstack-nova-api.service
|
/var/log/nova/nova-api.log
|
|
OpenStack Compute certificate server
|
openstack-nova-cert.service
|
/var/log/nova/nova-cert.log
|
|
OpenStack Compute service
|
openstack-nova-compute.service
|
/var/log/nova/nova-compute.log
|
|
OpenStack Compute Conductor service
|
openstack-nova-conductor.service
|
/var/log/nova/nova-conductor.log
|
|
OpenStack Compute VNC console authentication server
|
openstack-nova-consoleauth.service
|
/var/log/nova/nova-consoleauth.log
|
|
Informational messages
| nova-manage command
|
/var/log/nova/nova-manage.log
|
|
OpenStack Compute NoVNC Proxy service
|
openstack-nova-novncproxy.service
|
/var/log/nova/nova-novncproxy.log
|
|
OpenStack Compute Scheduler service
|
openstack-nova-scheduler.service
|
/var/log/nova/nova-scheduler.log
|
Table 7.3. Dashboard (horizon) log files
| Service | Service Name | Log Path |
|---|---|---|
|
Log of certain user interactions
|
Dashboard interface
|
/var/log/horizon/horizon.log
|
Table 7.4. Identity Service (keystone) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack Identity Service
|
openstack-keystone.service
|
/var/log/keystone/keystone.log
|
Table 7.5. Image Service (glance) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack Image Service API server
|
openstack-glance-api.service
|
/var/log/glance/api.log
|
|
OpenStack Image Service Registry server
|
openstack-glance-registry.service
|
/var/log/glance/registry.log
|
Table 7.6. OpenStack Networking (neutron) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack Networking Layer 3 Agent
|
neutron-l3-agent.service
|
/var/log/neutron/l3-agent.log
|
|
Open vSwitch agent
|
neutron-openvswitch-agent.service
|
/var/log/neutron/openvswitch-agent.log
|
|
Metadata agent service
|
neutron-metadata-agent.service
|
/var/log/neutron/metadata-agent.log
|
|
OpenStack Networking service
|
neutron-server.service
|
/var/log/neutron/server.log
|
Table 7.7. Telemetry (ceilometer) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack ceilometer notification agent
|
openstack-ceilometer-notification.service
|
/var/log/ceilometer/agent-notification.log
|
|
OpenStack ceilometer alarm evaluation
|
openstack-ceilometer-alarm-evaluator.service
|
/var/log/ceilometer/alarm-evaluator.log
|
|
OpenStack ceilometer alarm notification
|
openstack-ceilometer-alarm-notifier.service
|
/var/log/ceilometer/alarm-notifier.log
|
|
OpenStack ceilometer API
|
openstack-ceilometer-api.service
|
/var/log/ceilometer/api.log
|
|
Informational messages
|
MongoDB integration
|
/var/log/ceilometer/ceilometer-dbsync.log
|
|
OpenStack ceilometer central agent
|
openstack-ceilometer-central.service
|
/var/log/ceilometer/central.log
|
|
OpenStack ceilometer collection
|
openstack-ceilometer-collector.service
|
/var/log/ceilometer/collector.log
|
|
OpenStack ceilometer compute agent
|
openstack-ceilometer-compute.service
|
/var/log/ceilometer/compute.log
|
Table 7.8. Orchestration (heat) log files
| Service | Service Name | Log Path |
|---|---|---|
|
OpenStack Heat API Service
|
openstack-heat-api.service
|
/var/log/heat/heat-api.log
|
|
Openstack Heat Engine Service
|
openstack-heat-engine.service
|
/var/log/heat/heat-engine.log
|
|
Orchestration service events
|
n/a
|
/var/log/heat/heat-manage.log
|
7.1.2. Configure logging options
Each component maintains its own separate logging configuration in its respective configuration file. For example, in Compute, these options are set in
/etc/nova/nova.conf:
- Increase the level of informational logging by enabling debugging. This option greatly increases the amount of information captured, so you may want to consider using it only temporarily, or first reviewing your log rotation settings.
debug=True
- Enable verbose logging:
verbose=True
- Change the log file path:
log_dir=/var/log/nova
- Send your logs to a central syslog server:
use_syslog=True syslog_log_facility=LOG_USER
Note
Options are also available for timestamp configuration and log formatting, among others. Review the component's configuration file for additional logging options.