openstack/openstack-ansible
Code Issues Proposed changes
Files
97a3e965a84db4bd1992d1f753a79ff076bba47d
openstack-ansible/doc/source/install-guide/ops-logging.rst
Major Hayden 743f910faf Docs: Centralized logging 
This patch explains where to find the logs in the rsyslog server container
as well as in each service container. It also tells deployers about the
log_hosts block in openstack_user_config.yml to add a rsyslog server or
servers.

Closes-bug: 1507388

Change-Id: I3e3a5251f302609c3b98eac790b4572107a294ff
2016-02-09 07:35:13 -06:00

907 B
Raw Blame History

Home OpenStack-Ansible Installation Guide

Centralized Logging

OpenStack-Ansible will configure all instances to send syslog data to a container (or group of containers) running rsyslog. The rsyslog server containers are specified in the log_hosts section of the openstack_user_config.yml file.

The rsyslog server container(s) have logrotate installed and configured with a 14 day retention. All rotated logs are compressed by default.

Finding logs

Logs are accessible in multiple locations within an OpenStack-Ansible deployment:

  • The rsyslog server container collects logs in /var/log/log-storage within directories named after the container or physical host
  • Each physical host has the logs from its service containers mounted at /openstack/log/
  • Each service container has its own logs stored at /var/log/<service_name>