Skip to content

Commit cb3bc72

Browse files
committed
docs(components): add fluentd/logger
1 parent 06f391e commit cb3bc72

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

src/understanding-deis/components.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,25 @@ The router component uses Kubernetes annotations for both Application discovery
113113
as well as router configuration. For more detailed documentation and possible
114114
configuration view the router [project documentation][router-documentation].
115115

116+
## Logger: fluentd, logger
117+
118+
The logging subystem consists of two compoents. Fluentd handles log shipping
119+
and logger maintains a ring-buffer of application logs.
120+
121+
Project Location: [deis/fluentd](https://github.com/deis/fluentd)
122+
123+
Fluentd is deployed to your Kubernetes cluster via Daemon Sets. Fluentd
124+
subscribes to all container logs, decorates the output with Kubernetes metadata
125+
and can be configured to drain logs to multiple destinations. By default,
126+
fluentd ships logs to the logger component, which powers `deis logs`.
127+
128+
Project Location: [deis/logger](https://github.com/deis/logger)
129+
130+
The `logger` compoent receives log streams from `fluentd`, collating by
131+
Application name. Logger does not persist logs to disk, instead maintaining an
132+
in-memory ring buffer. For more information on logger see the [project
133+
documentation][logger-documentation].
134+
116135
[Amazon S3]: http://aws.amazon.com/s3/
117136
[Application]: ../reference-guide/terms.md#application
118137
[Celery]: http://www.celeryproject.org/
@@ -136,3 +155,4 @@ configuration view the router [project documentation][router-documentation].
136155
[using-buildpacks]: ../using-deis/using-buildpacks.md
137156
[using-dockerfiles]: ../using-deis/using-dockerfiles.md
138157
[router-documentation]: https://github.com/deis/router
158+
[logger-documentation]: https://github.com/deis/logger

0 commit comments

Comments
 (0)