Aptible cAdvisor

Aptible's own fork of cAdvisor with patches to add additional tags and metrics.

Development

1. Install go. cAdvisor is built using v1.6 but this version is no longer supported so you may need to install a newer version, e.g. 1.17.

   brew install go@1.17

2. Install dependencies

   GO111MODULE=off go get github.com/tools/godep
   GO111MODULE=off godep get

3. Add the project's workspace, Godeps/_workspace, to your GOPATH.

At this point you should be ready to contribute to the project.

Test & Build

A Dockerfile is included to make testing and building cAdvisor easier. The Dockerfile is used by CI to build the image as well.

The following commands will build the image and test and build cAdvisor in the container the same way CI does.

docker build . -t cadvisor:build
docker run --rm -it cadvisor:build ./.docker/build.sh

---

cAdvisor

cAdvisor (Container Advisor) provides container users an understanding of the resource usage and performance characteristics of their running containers. It is a running daemon that collects, aggregates, processes, and exports information about running containers. Specifically, for each container it keeps resource isolation parameters, historical resource usage, histograms of complete historical resource usage and network statistics. This data is exported by container and machine-wide.

cAdvisor has native support for Docker containers and should support just about any other container type out of the box. We strive for support across the board so feel free to open an issue if that is not the case. cAdvisor's container abstraction is based on lmctfy's so containers are inherently nested hierarchically.

Quick Start: Running cAdvisor in a Docker Container

To quickly tryout cAdvisor on your machine with Docker, we have a Docker image that includes everything you need to get started. You can run a single cAdvisor to monitor the whole machine. Simply run:

sudo docker run \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:rw \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --publish=8080:8080 \
  --detach=true \
  --name=cadvisor \
  google/cadvisor:latest

cAdvisor is now running (in the background) on http://localhost:8080. The setup includes directories with Docker state cAdvisor needs to observe.

Note: If you're running on CentOS, Fedora, RHEL, or are using LXC take a look at our running instructions.

We have detailed instructions on running cAdvisor standalone outside of Docker. cAdvisor running options may also be interesting for advanced usecases. If you want to build your own cAdvisor Docker image see our deployment page.

Building and Testing

See the more detailed instructions in the build page. This includes instructions for building and deploying the cAdvisor Docker image.

InfluxDB and Cluster Monitoring

cAdvisor supports exporting stats to InfluxDB. See the documentation for more information and examples.

cAdvisor also exposes container stats as Prometheus metrics. See the documentation for more information.

Heapster enables cluster wide monitoring of containers using cAdvisor.

Web UI

cAdvisor exposes a web UI at its port:

http://<hostname>:<port>/

See the documentation for more details.

Remote REST API & Clients

cAdvisor exposes its raw and processed stats via a versioned remote REST API. See the API's documentation for more information.

There is also an official Go client implementation in the client directory. See the documentation for more information.

Roadmap

cAdvisor aims to improve the resource usage and performance characteristics of running containers. Today, we gather and expose this information to users. In our roadmap:

• Advise on the performance of a container (e.g.: when it is being negatively affected by another, when it is not receiving the resources it requires, etc)
• Auto-tune the performance of the container based on previous advise.
• Provide usage prediction to cluster schedulers and orchestration layers.

Community

Contributions, questions, and comments are all welcomed and encouraged! cAdvisor developers hang out on Freenode IRC in the #google-containers room & Slack (get an invitation here). We also have the google-containers Google Groups mailing list.