mirror of https://github.com/docker/docs.git
61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
---
|
|
redirect_from:
|
|
- /ucp/configuration/configure-logs/
|
|
description: Learn how to configure Docker Universal Control Plane to store your logs
|
|
on an external log system.
|
|
keywords:
|
|
- docker, ucp, integrate, logs
|
|
title: Configure UCP logging
|
|
---
|
|
|
|
You can configure UCP for sending logs to a remote logging service:
|
|
|
|
1. Login into UCP with an administrator account
|
|
2. Navigate to the **Settings** page
|
|
3. Set the information about your logging server, and click
|
|
**Enable Remote Logging**
|
|
|
|
|
|
|
|
## Example: Setting up an ELK stack
|
|
|
|
One popular logging stack is composed of Elasticsearch, Logstash and
|
|
Kibana. The following example demonstrates how to set up an example
|
|
deployment which can be used for logging.
|
|
|
|
```none
|
|
docker volume create --name orca-elasticsearch-data
|
|
|
|
docker run -d \
|
|
--name elasticsearch \
|
|
-v orca-elasticsearch-data:/usr/share/elasticsearch/data \
|
|
elasticsearch elasticsearch -Des.network.host=0.0.0.0
|
|
|
|
docker run -d \
|
|
-p 514:514 \
|
|
--name logstash \
|
|
--link elasticsearch:es \
|
|
logstash \
|
|
sh -c "logstash -e 'input { syslog { } } output { stdout { } elasticsearch { hosts => [ \"es\" ] } } filter { json { source => \"message\" } }'"
|
|
|
|
docker run -d \
|
|
--name kibana \
|
|
--link elasticsearch:elasticsearch \
|
|
-p 5601:5601 \
|
|
kibana
|
|
```
|
|
|
|
Once you have these containers running, configure UCP to send logs to
|
|
the IP of the Logstash container. You can then browse to port 5601 on the system
|
|
running Kibana and browse log/event entries. You should specify the "time"
|
|
field for indexing.
|
|
|
|
When deployed in a production environment, you should secure your ELK
|
|
stack. UCP does not do this itself, but there are a number of 3rd party
|
|
options that can accomplish this (e.g. Shield plug-in for Kibana)
|
|
|
|
## Where to go next
|
|
|
|
* [Integrate with DTR](dtr-integration.md)
|
|
* [Set up high availability](../high-availability/set-up-high-availability.md)
|