DockerCLI/docs/extend
Brian Goff d8e04f68d3 Add support for metrics plugins
Allows for a plugin type that can be used to scrape metrics.
This is useful because metrics are not neccessarily at a standard
location... `--metrics-addr` must be set, and must currently be a TCP
socket.
Even if metrics are done via a unix socket, there's no guarentee where
the socket may be located on the system, making bind-mounting such a
socket into a container difficult (and racey, failure-prone on daemon
restart).

Metrics plugins side-step this issue by always listening on a unix
socket and then bind-mounting that into a known path in the plugin
container.

Note there has been similar work in the past (and ultimately punted at
the time) for consistent access to the Docker API from within a
container.

Why not add metrics to the Docker API and just provide a plugin with
access to the Docker API? Certainly this can be useful, but gives a lot
of control/access to a plugin that may only need the metrics. We can
look at supporting API plugins separately for this reason.

Signed-off-by: Brian Goff <cpuguy83@gmail.com>
2017-06-02 00:11:05 +00:00
..
images Add a link to the new build instructions 2017-06-02 00:10:24 +00:00
EBS_volume.md plugins: add example docs for a rexray plugin 2017-06-02 00:10:49 +00:00
config.md Add support for metrics plugins 2017-06-02 00:11:05 +00:00
index.md modify docker plugin sshfs entrypoint 2017-06-02 00:10:58 +00:00
legacy_plugins.md Update legacy_plugins.md to include HBM authz plugin 2017-06-02 00:11:04 +00:00
plugin_api.md Fix json format of plugin 2017-06-02 00:10:51 +00:00
plugins_authorization.md Fix some redirect loops and problems 2017-06-02 00:10:42 +00:00
plugins_graphdriver.md Let graphdrivers declare diff stream fidelity 2017-06-02 00:11:02 +00:00
plugins_logging.md fix typo in plugins_logging.md 2017-06-02 00:11:04 +00:00
plugins_metrics.md Add support for metrics plugins 2017-06-02 00:11:05 +00:00
plugins_network.md modify invalid url in plugins_network.md 2017-06-02 00:10:41 +00:00
plugins_services.md Escape some double brackets 2017-06-02 00:11:01 +00:00
plugins_volume.md Update plugin_volume apidocs for v2 2017-06-02 00:10:55 +00:00