Docker is a set of platform as a service products that deliver software in containers. This integration allows you to ship performance logs of your Docker containers to your Logz.io account.

Configuration

Pull the Docker image

Download the logzio/logzio-docker image:

docker pull logzio/logzio-perfagent
Run the Docker image

For a complete list of options, see the parameters below the code block.👇

docker run -d \
  --net="host" \
  -e LOGZ_TOKEN="<<LOG-SHIPPING-TOKEN>>" \
  -e LISTENER="<<LISTENER-HOST>>:5000" \
  -e USER_TAG="workers" \
  -e HOSTNAME=`hostname` \
  -e INSTANCE="10.1.2.3" \
  --restart=always \
  logzio/logzio-perfagent
Parameters
Parameter Description Required/Default
LOGZ_TOKEN Your Logz.io account token. Replace <<LOG-SHIPPING-TOKEN>> with the token of the account you want to ship to. Required
LISTENER Your account’s listener host and port. Replace <<LISTENER-HOST>> with the host for your region. For example, listener.logz.io if your account is hosted on AWS US East, or listener-nl.logz.io if hosted on Azure West Europe. The required port depends whether HTTP or HTTPS is used: HTTP = 8070, HTTPS = 8071. listener.logz.io:5000
USER_TAG Assigned to the user_tag field of each log entry. You can use this field to group various hosts into meaningful visualisations. One recommended use case for this variable is to denote the host role. --
HOSTNAME Name of the host this container is monitoring. Assigned to the syslog5424_host field of each log entry. --
INSTANCE The IP address that will be assigned to the instance field of each entry. --
Check Logz.io for your logs

Give your logs some time to get from your system to ours, and then open Open Search Dashboards.

If you still don’t see your logs, see log shipping troubleshooting.