Enable logging.conf & fluentd for aodh
This change introduce ability to use log_config_append parameter with
new FluentdHandler to send logs directly to Fluentd.
To save per binary log streams as it is in the default logging states generates
separate logging.conf files per service and use /etc/default/<service name>
to pass dedicated logging.conf to every service.
New prometheus metrics now available:
* log_messages - total number of log lines per severity
* openstack_http_response_times - set of HTTP-stats metrics per HTTP method and status:
- three quantiles, 50%, 90% and 99% for response time
- sum of response time
- count of responses
Change-Id: I87a3ada5d954ef916dfb38b09cac916e96e9b356
Related-Prod: PROD-16324
diff --git a/README.rst b/README.rst
index 2633fbf..fe6ac21 100644
--- a/README.rst
+++ b/README.rst
@@ -5,7 +5,7 @@
Aodh is an alarming service for OpenStack. It used to be a part of Ceilometer, but starting from Mitaka it
is a separate project. Aodh supports several types of alarms like threshold, event, composite and gnocchi-specific.
-In cluster mode, coordination is enabled via tooz with Redis backend.
+In cluster mode, coordination is enabled via tooz with Redis backend.
MySQL is used as a data backend for alarms and alarm history.
Sample pillars
@@ -20,7 +20,7 @@
enabled: true
version: mitaka
ttl: 86400
- cluster: true
+ cluster: true
database:
engine: "mysql+pymysql"
host: 10.0.106.20
@@ -33,11 +33,11 @@
port: 8042
identity:
engine: keystone
- host: 10.0.106.20
+ host: 10.0.106.20
port: 35357
tenant: service
user: aodh
- password: password
+ password: password
message_queue:
engine: rabbitmq
port: 5672
@@ -54,6 +54,31 @@
port: 11211
+Enhanced logging with logging.conf
+----------------------------------
+
+By default logging.conf is disabled.
+
+That is possible to enable per-binary logging.conf with new variables:
+ * openstack_log_appender - set it to true to enable log_config_append for all OpenStack services;
+ * openstack_fluentd_handler_enabled - set to true to enable FluentHandler for all Openstack services.
+
+Only WatchedFileHandler and FluentHandler are available.
+
+Also it is possible to configure this with pillar:
+
+.. code-block:: yaml
+
+ aodh:
+ server:
+ logging:
+ log_appender: true
+ log_handlers:
+ watchedfile:
+ enabled: true
+ fluentd:
+ enabled: true
+
Development and testing
=======================