diff options
Diffstat (limited to 'plugin.md')
| -rw-r--r-- | plugin.md | 12 |
1 files changed, 8 insertions, 4 deletions
@@ -35,11 +35,15 @@ See a couple of blog posts on how to write and add plugin to CoreDNS: ## Logging -If your plugin needs to output a log line you should use the `log` package. CoreDNS does not -implement log levels. The standard way of outputing is: `log.Printf("[LEVEL] ...")`, and LEVEL -can be: `INFO`, `WARNING` or `ERROR`. +If your plugin needs to output a log line you should use the `plugin/pkg/log` package. This package +implements log levels. The standard way of outputting is: `log.Info` for info level messages. The +levels available are `log.Info`, `log.Warning`, `log.Error`, `log.Debug`. Each of these also has +a `f` variant. + In general, logging should be left to the higher layers by returning an error. However, if there is -a reason to consume the error but notify the user, then logging in the plugin can be acceptable. +a reason to consume the error and notify the user, then logging in the plugin itself can be +acceptable. The `Debug*` functions only output something when the *debug* plugin is loaded in the +server. ## Metrics |