Monitor your cluster

Estimated reading time: 2 minutes

These are the docs for UCP version 1.1

To select a different version, use the selector below.

This article gives you an overview of how to monitor your Docker UCP cluster. Here you’ll also find the information you need to troubleshoot if something goes wrong.

Check the cluster status from the UI

To monitor your UCP cluster, the first thing to check is the Nodes screen on the UCP web app.

UCP dashboard

In the nodes screen you can see if all the nodes in the cluster are healthy, or if there is any problem.

You can also check the state of individual UCP containers by navigating to the Containers page. By default the Containers screen doesn’t display system containers. On the filter dropdown choose Show all containers to see all the UCP components.

UCP dashboard

You can click on a container to see more details like configurations and logs.

Check the cluster status from the CLI

You can also monitor the status of a UCP cluster, using the Docker CLI client.

  1. Get a client certificate bundle.

    When using the Docker CLI client you need to authenticate using client certificates. Learn how to use client certificates.

    If your client certificate bundle is for a non-admin user, you won’t have permissions to execute all docker commands, or see all information about the cluster.

  2. Use the docker info command to check the cluster status.

    $ docker info
    Containers: 11
    Nodes: 2
      └ Status: Healthy
      └ Status: Healthy
    Cluster Managers: 1 Healthy
      └ Orca Controller:
      └ Swarm Manager: tcp://
      └ KV: etcd://
  3. Check the container logs

    With an admin user certificate bundle, you can run docker commands directly on the Docker Engine or Swarm Manager of a node. In this example, we are connecting directly to the Docker Engine running on the UCP controller, and requesting the logs of the ucp-kv container.

    $ docker -H tcp:// logs ucp-kv
    2016-04-18 22:40:51.553912 I | etcdserver: start to snapshot (applied: 40004, lastsnap: 30003)
    2016-04-18 22:40:51.561682 I | etcdserver: saved snapshot at index 40004
    2016-04-18 22:40:51.561927 I | etcdserver: compacted raft log at 35004

Where to go next

Docker, UCP, troubleshoot