2862f038e2
This introduces an initial helm chart for fluent logging. It provides a functional fluent-bit and fluentd deployment to use in conjunction with elasticsearch and kibana to consume and aggregate logs from all resource types in a cluster. It can deliver logs to kafka for external tools to consume. This PS moves fluent-logging chart from osh-addons, osh to osh-infra repo. previous ps(addon): https://review.openstack.org/#/c/507023/ previous ps(osh): https://review.openstack.org/#/c/514622/ Specification: https://review.openstack.org/#/c/505491/ Partially implements: blueprint osh-logging-framework Change-Id: I72e580aa3a197550060fc07af8396a7c8368d40b
31 lines
1.6 KiB
ReStructuredText
31 lines
1.6 KiB
ReStructuredText
Fluentd-logging
|
|
===============
|
|
|
|
OpenStack-Helm defines a centralized logging mechanism to provide insight into
|
|
the the state of the OpenStack services and infrastructure components as
|
|
well as underlying kubernetes platform. Among the requirements for a logging
|
|
platform, where log data can come from and where log data need to be delivered
|
|
are very variable. To support various logging scenarios, OpenStack-Helm should
|
|
provide a flexible mechanism to meet with certain operation needs. This chart
|
|
proposes fast and lightweight log forwarder and full featured log aggregator
|
|
complementing each other providing a flexible and reliable solution. Especially,
|
|
Fluent-bit is proposed as a log forwarder and Fluentd is proposed as a main log
|
|
aggregator and processor.
|
|
|
|
|
|
Mechanism
|
|
---------
|
|
|
|
Fluent-bit, Fluentd meet OpenStack-Helm's logging requirements for gathering,
|
|
aggregating, and delivering of logged events. Flunt-bit runs as a daemonset on
|
|
each node and mounts the /var/lib/docker/containers directory. The Docker
|
|
container runtime engine directs events posted to stdout and stderr to this
|
|
directory on the host. Fluent-bit then forward the contents of that directory to
|
|
Fluentd. Fluentd runs as deployment at the designated nodes and expose service
|
|
for Fluent-bit to foward logs. Fluentd should then apply the Logstash format to
|
|
the logs. Fluentd can also write kubernetes and OpenStack metadata to the logs.
|
|
Fluentd will then forward the results to Elasticsearch and to optionally kafka.
|
|
Elasticsearch indexes the logs in a logstash-* index by default. kafka stores
|
|
the logs in a 'logs' topic by default. Any external tool can then consume the
|
|
'logs' topic.
|