Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-11-02 02:03:13 -05:00
Code Issues Packages Projects Releases Wiki Activity

fix readme.md of log plugin (#1668)

Browse Source
This commit is contained in:
Maksim Paramonau
2018-04-11 21:07:10 +03:00
committed by Miek Gieben
parent a0f294e550
commit 9ae9ee4b6b
1 changed files with 37 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
plugin/log/README.md
View File

@@ -28,22 +28,23 @@ log [NAME] [FORMAT]
* `NAME` is the name to match in order to be logged * `NAME` is the name to match in order to be logged
* `FORMAT` is the log format to use (default is Common Log Format) * `FORMAT` is the log format to use (default is Common Log Format)
You can further specify the class of responses that get logged: You can further specify the classes of responses that get logged:
~~~ txt ~~~ txt
log [NAME] [FORMAT] { log [NAME] [FORMAT] {
class [success|denial|error|all] class CLASSES...
} }
~~~ ~~~
Here `success` `denial` and `error` denotes the class of responses that should be logged. The * `CLASSES` is a space-separated list of classes of responses that should be logged
classes have the following meaning:
The classes of responses have the following meaning:
* `success`: successful response * `success`: successful response
* `denial`: either NXDOMAIN or NODATA (name exists, type does not) * `denial`: either NXDOMAIN or NODATA (name exists, type does not)
* `error`: SERVFAIL, NOTIMP, REFUSED, etc. Anything that indicates the remote server is not willing to * `error`: SERVFAIL, NOTIMP, REFUSED, etc. Anything that indicates the remote server is not willing to
resolve the request. resolve the request.
* `all`: the default - nothing is specified. * `all`: the default - nothing is specified. Using of this class means that all messages will be logged whatever we mix together with "all".
If no class is specified, it defaults to *all*. If no class is specified, it defaults to *all*.
@@ -106,3 +107,34 @@ Only log denials for example.org (and below to a file)
} }
} }
~~~ ~~~
Log all queries which were not resolved successfully
~~~ corefile
. {
log . {
class denial error
}
}
~~~
Log all queries on which we did not get errors
~~~ corefile
. {
log . {
class denial success
}
}
~~~
Also the multiple statements can be OR-ed, for example, we can rewrite the above case as following:
~~~ corefile
. {
log . {
class denial
class success
}
}
~~~