diff --git a/docs/index.md b/docs/index.md index 0b2dd82d3..d037e60c3 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,6 +18,7 @@ Docker powered mini-Heroku. The smallest PaaS implementation you've ever seen. - [Nginx Configuration](http://progrium.viewdocs.io/dokku/nginx) - [Running Remote commands](http://progrium.viewdocs.io/dokku/remote-commands) - [Container Options](http://progrium.viewdocs.io/dokku/docker-options) +- [Dokku Events logs] (http://progrium.viewdocs.io/dokku/logging) ### Community Contributions diff --git a/docs/logging.md b/docs/logging.md new file mode 100644 index 000000000..f5e509f7a --- /dev/null +++ b/docs/logging.md @@ -0,0 +1,75 @@ +# Events + +Docker provides an _events_ command to show system's real time events. Likewise, Dokku can record events as syslog entries and also provides a plugin to display the last ones. + +``` +events [-t] Show the last events (-t follows) +events:list List logged events +events:on Enable events logger +events:off Disable events logger +``` + +## Usage + +Enable the plugin: + +``` +$ dokku events:on +Enabling dokku events logger +``` + +It writes log entries to ``/var/log/syslog`` as well as a Dokku-specific logs sub-directory ``/var/log/dokku/events.log``, which can be easily displayed: + +``` +$ dokku events +Jul 3 16:09:48 dokku.me dokku[127630]: INVOKED: pre-release-buildstep( pythonapp ) +Jul 3 16:10:02 dokku.me dokku[128095]: INVOKED: docker-args-run( rubyapp ) +Jul 3 16:10:02 dokku.me dokku[128114]: INVOKED: docker-args-run( nhl ) +Jul 3 16:10:03 dokku.me dokku[128136]: INVOKED: post-release-buildstep( pythonapp ) +Jul 3 16:10:03 dokku.me dokku[128195]: INVOKED: pre-deploy( pythonapp ) +Jul 3 16:10:23 dokku.me dokku[129253]: INVOKED: docker-args-deploy( pythonapp ) +Jul 3 16:10:24 dokku.me dokku[129337]: INVOKED: bind-external-ip( pythonapp ) +Jul 3 16:10:24 dokku.me dokku[129451]: INVOKED: check-deploy( pythonapp 6274ced0d4be11af4490cd18abaf77cdd593f025133f403d984e80d86a39acec web 5000 10.0.16.80 ) +Jul 3 16:10:35 dokku.me dokku[129561]: INVOKED: docker-args-deploy( pythonapp ) +Jul 3 16:10:35 dokku.me dokku[129649]: INVOKED: bind-external-ip( pythonapp ) +Jul 3 16:10:36 dokku.me dokku[129760]: INVOKED: check-deploy( pythonapp ac88a56ee4161ff37e4b92d1498c3eadc91f0aa7c8b81b44fc077e2a51d54cc0 worker ) +Jul 3 16:10:46 dokku.me dokku[129851]: INVOKED: post-deploy( pythonapp ) +Jul 3 16:10:46 dokku.me dokku[129945]: INVOKED: nginx-pre-reload( pythonapp ) +Jul 3 16:15:02 dokku.me dokku[130397]: INVOKED: docker-args-run( goapp ) +Jul 3 16:21:02 dokku.me dokku[130796]: INVOKED: docker-args-run( rubyapp ) +Jul 3 16:30:02 dokku.me dokku[131384]: INVOKED: docker-args-run( rubyapp ) +``` + +List all events that are currently being recored: +``` +& dokku events:list +=====> Events currently logged +backup-check +docker-args-build +pre-delete +post-deploy +receive-app +pre-release-buildstep +nginx-pre-reload +docker-args-deploy +post-build-buildstep +post-domains-update +post-release-dockerfile +check-deploy +backup-import +backup-export +git-pre-pull +git-post-pull +nginx-hostname +bind-external-ip +pre-deploy +post-delete +dependencies +pre-build-buildstep +docker-args-run +pre-build-dockerfile +post-release-buildstep +post-build-dockerfile +pre-release-dockerfile +update +``` diff --git a/docs/plugins.md b/docs/plugins.md index 93e4dfd91..9421a7214 100644 --- a/docs/plugins.md +++ b/docs/plugins.md @@ -156,7 +156,6 @@ Note: The following plugins have been supplied by our community and may not have | [Docker Direct](https://github.com/heichblatt/dokku-docker-direct) | [heichblatt][] | | | [Dokku Name](https://github.com/alex-sherwin/dokku-name) | [alex-sherwin][] | dokku >= [c77cbf1][] | | [Dokku Registry](https://github.com/agco-adm/dokku-registry)1 | [agco-adm][] | | -| [Events Logger](https://github.com/alessio/dokku-events) | [alessio][] | dokku >= v0.3.13 | | [git rev-parse HEAD in env](https://github.com/cjblomqvist/dokku-git-rev) | [cjblomqvist][] | Compatible with 0.3.0 | | [Graduate (Environment Management)](https://github.com/glassechidna/dokku-graduate) | [Benjamin-Dobell][] | dokku >= v0.3.14 | | [HTTP Auth Secure Apps](https://github.com/matto1990/dokku-secure-apps) | [matto1990][] | Works with v0.2.3 | @@ -225,6 +224,8 @@ The following plugins have been removed as their functionality is now in Dokku C | [Supply env vars to buildpacks](https://github.com/cameron-martin/dokku-build-env)2 | [cameron-martin][] | v0.3.9 (build-env plugin) | | [user-env-compile](https://github.com/musicglue/dokku-user-env-compile)2 | [musicglue][] | v0.3.9 (build-env plugin) | | [user-env-compile](https://github.com/motin/dokku-user-env-compile)2 | [motin][] | v0.3.9 (build-env plugin) | +| [Events Logger](https://github.com/alessio/dokku-events) | [alessio][] | v0.3.21 (events plugin) | + 1 Conflicts with [VHOSTS Custom Configuration](https://github.com/neam/dokku-nginx-vhosts-custom-configuration) 2 Similar to the heroku-labs feature (see https://devcenter.heroku.com/articles/labs-user-env-compile)