2
0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-29 13:07:50 +00:00

[5622] Updated list of loggers.

This commit is contained in:
Marcin Siodelski 2018-06-06 20:05:12 +02:00
parent 765bd66b23
commit 5193c342e5

View File

@ -169,341 +169,71 @@
</para>
<para>
Currently defined loggers are:
Currently defined loggers are defined in the following table. The
"Software Package" column of this table specifies whether the particular
loggers belong to the core Kea code (open source Kea binaries and
libraries), or hook libraries (open source or premium).
</para>
<itemizedlist>
<listitem>
<simpara>
<command>kea-ctrl-agent</command> - the root logger for the
Control Agent exposing RESTful control API. All components used
by the Control Agent inherit the settings from this logger.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-ctrl-agent.http</command> - a logger which outputs
log messages related to receiving, parsing and sending HTTP
messages.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4</command> - the root logger for the DHCPv4
server. All components used by the DHCPv4 server inherit the
settings from this logger.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.alloc-engine</command> - used by the lease
allocation engine, which is responsible for managing leases in the
lease database, i.e. create, modify and remove DHCPv4 leases as a
result of processing messages from the clients.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.bad-packets</command> - used by the DHCPv4
server daemon for logging inbound client packets that were dropped
or to which the server responded with a DHCPNAK. It allows
administrators to configure a separate log output that contains
only packet drop and reject entries.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.callouts</command> - used to log messages
pertaining to the callouts registration and execution for the
particular hook point.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.commands</command> - used to log messages
relating to the handling of commands received by the the DHCPv4
server over the command channel.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.ddns</command> - used by the DHCPv4 server to
log messages related to the Client FQDN and Hostname option
processing. It also includes log messages related to the relevant
DNS updates.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.dhcp4</command> - used by the DHCPv4 server
daemon to log basic operations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.dhcpsrv</command> - the base logger for the
libdhcpsrv library.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.eval</command> - used to log messages relating
to the client classification expression evaluation code.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.hooks</command> - used to log messages related
to management of hooks libraries, e.g. registration and
deregistration of the libraries, and to the initialization of the
callouts execution for various hook points within the DHCPv4
server.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.hosts</command> - used within the libdhcpsrv
and it logs messages related to the management of the DHCPv4 host
reservations, i.e. retrieval of the reservations and adding new
reservations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.leases</command> - used by the DHCPv4 server to
log messages related to the lease allocation. The messages
include detailed information about the allocated or offered
leases, errors during the lease allocation etc.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.options</command> - used by the DHCPv4 server
to log messages related to processing of the options in the DHCPv4
messages, i.e. parsing options, encoding options into on-wire
format and packet classification using options contained in the
received packets.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.packets</command> - this logger is mostly used
to log messages related to transmission of the DHCPv4 packets,
i.e. packet reception and sending a response. Such messages
include information about the source and destination IP addresses
and interfaces used to transmit packets. The logger is also used
to log messages related to subnet selection, as this selection is
usually based on the IP addresses and/or interface names, which
can be retrieved from the received packet, even before the DHCPv4
message carried in the packet is parsed.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp4.stat-cmds-hooks</command> - this logger is
used to log messages related to operation of the Stats Cmds hooks
library. In general these will pertain to loading and unloading
the library and the execution of commands by the library.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6</command> - the root logger for the DHCPv6
server. All components used by the DHCPv6 server inherit the
settings from this logger if there is no specialized logger
provided.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.alloc-engine</command> - used used by the lease
allocation engine, which is responsible for managing leases in the
lease database, i.e. create, modify and remove DHCPv6 leases as a
result of processing messages from the clients.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.bad-packets</command> - used used by the DHCPv6
server daemon for logging inbound client packets that were
dropped.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.callouts</command> - used to log messages
pertaining to the callouts registration and execution for the
particular hook point.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.commands</command> - used to log messages
relating to the handling of commands received by the the DHCPv6
server over the command channel.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.ddns</command> - this logger is used by the
DHCPv6 server to log messages related to the Client FQDN option
processing. It also includes log messages related to the relevant
DNS updates.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.dhcp6</command> - used DHCPv6 server daemon to
log basic operations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.dhcpsrv</command> - the base logger for the
libdhcpsrv library.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.eval</command> - used to log messages relating
to the client classification expression evaluation code.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.hooks</command> - this logger is used to log
messages related to management of hooks libraries, e.g.
registration and deregistration of the libraries, and to the
initialization of the callouts execution for various hook points
within the DHCPv6 server.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.hosts</command> - used within the libdhcpsrv
and it logs messages related to the management of the DHCPv6 host
reservations, i.e. retrieval of the reservations and adding new
reservations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.leases</command> - used by the DHCPv6 server to
log messages related to the lease allocation. The messages
include detailed information about the allocated or offered
leases, errors during the lease allocation etc.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.options</command> - used by the DHCPv6 server
to log messages related to processing of the options in the DHCPv6
messages, i.e. parsing options, encoding options into on-wire
format and packet classification using options contained in the
received packets.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.packets</command> - this logger is mostly used
to log messages related to transmission of the DHCPv6 packets,
i.e. packet reception and sending a response. Such messages
include the information about the source and destination IP
addresses and interfaces used to transmit packets. This logger is
also used to log messages related to subnet selection, as this
selection is usually based on the IP addresses and/or interface
names, which can be retrieved from the received packet, even
before the DHCPv6 message carried in the packet is parsed.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp6.stat-cmds-hooks</command> - this logger is
used to log messages related to operation of the Stats Cmds hooks
library. In general these will pertain to loading and unloading
the library and the execution of commands by the library.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp-ddns</command> - the root logger for the
kea-dhcp-ddns daemon. All components used by this daemon inherit
the settings from this logger if there is no specialized logger
provided.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp-ddns.dctl</command> - the logger used by the
kea-dhcp-ddns daemon for logging basic information about the
process, received signals and triggered reconfigurations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp-ddns.dhcpddns</command> - the logger used by the
kea-dhcp-ddns daemon for logging events related to DDNS operations.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp-ddns.dhcp-to-d2</command> - used by the
kea-dhcp-ddns daemon for logging information about events dealing
with receiving messages from the DHCP servers and adding them to
the queue for processing.
</simpara>
</listitem>
<listitem>
<simpara>
<command>kea-dhcp-ddns.d2-to-dns</command> - used by the
kea-dhcp-ddns daemon for logging information about events dealing
with sending and receiving messages with the DNS servers.
</simpara>
</listitem>
</itemizedlist>
<para>
<table frame="all" xml:id="supported-loggers-list">
<title>List of loggers supported by Kea servers and hooks libraries
shipped with Kea and premium packages</title>
<tgroup cols='3'>
<colspec colname="logger-name" align="left"/>
<colspec colname="software-package" align="center"/>
<colspec colname="description" align="left"/>
<thead>
<row>
<entry>Logger Name</entry>
<entry>Software Package</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row><entry><command>kea-&#xFEFF;ctrl-&#xFEFF;agent</command></entry><entry>core</entry><entry>The root logger for the Control Agent exposing RESTful control API. All components used by the Control Agent inherit the settings from this logger.</entry></row>
<row><entry><command>kea-&#xFEFF;ctrl-&#xFEFF;agent.http</command></entry><entry>core</entry><entry>A logger which outputs log messages related to receiving, parsing and sending HTTP messages.</entry></row>
<row><entry><command>kea-&#xFEFF;dhcp4</command></entry><entry>core</entry><entry>The root logger for the DHCPv4 server. All components used by the DHCPv4 server inherit the settings from this logger.</entry></row>
<row><entry><command>kea-&#xFEFF;dhcp6</command></entry><entry>core</entry><entry>The root logger for the DHCPv6 server. All components used by the DHCPv6 server inherit the settings from this logger.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.alloc-&#xFEFF;engine</command></member><member><command>kea-&#xFEFF;dhcp6.alloc-&#xFEFF;engine</command></member></simplelist></entry><entry>core</entry><entry>Used by the lease allocation engine, which is responsible for managing leases in the lease database, i.e. create, modify and remove DHCP leases as a result of processing messages from the clients.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.bad-&#xFEFF;packets</command></member><member><command>kea-&#xFEFF;dhcp6.bad-&#xFEFF;packets</command></member></simplelist></entry><entry>core</entry><entry>Used by the DHCP servers for logging inbound client packets that were dropped or to which the server responded with a DHCPNAK. It allows administrators to configure a separate log output that contains only packet drop and reject entries.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.callouts</command></member><member><command>kea-&#xFEFF;dhcp6.callouts</command></member></simplelist></entry><entry>core</entry><entry>Used to log messages pertaining to the callouts registration and execution for the particular hook point.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.commands</command></member><member><command>kea-&#xFEFF;dhcp6.commands</command></member></simplelist></entry><entry>core</entry><entry>Used to log messages relating to the handling of commands received by the the DHCP server over the command channel.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.ddns</command></member><member><command>kea-&#xFEFF;dhcp6.ddns</command></member></simplelist></entry><entry>core</entry><entry>Used by the DHCP server to log messages related to the Client FQDN and Hostname option processing. It also includes log messages related to the relevant DNS updates.</entry></row>
<row><entry><command>kea-&#xFEFF;dhcp4.dhcp4</command></entry><entry>core</entry><entry>Used by the DHCPv4 server daemon to log basic operations.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.dhcpsrv</command></member><member><command>kea-&#xFEFF;dhcp6.dhcpsrv</command></member></simplelist></entry><entry>core</entry><entry>The base loggers for the libkea-dhcpsrv library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.eval</command></member><member><command>kea-&#xFEFF;dhcp6.eval</command></member></simplelist></entry><entry>core</entry><entry>Used to log messages relating to the client classification expression evaluation code.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.host-cache-hooks</command></member><member><command>kea-&#xFEFF;dhcp6.host-cache-hooks</command></member></simplelist></entry><entry>libdhcp_host_cache premium hook library</entry><entry>This logger is used to log messages related to operation of the Host Cache Hook Library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.flex-id-hooks</command></member><member><command>kea-&#xFEFF;dhcp6.flex-id-hooks</command></member></simplelist></entry><entry>libdhcp_flex_id premium hook library</entry><entry>This logger is used to log messages related to operation of the Flexible Identifiers Hook Library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.ha-hooks</command></member><member><command>kea-&#xFEFF;dhcp6.ha-hooks</command></member></simplelist></entry><entry>libdhcp_ha premium hook library</entry><entry>This logger is used to log messages related to operation of the High Availability Hook Library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.hooks</command></member><member><command>kea-&#xFEFF;dhcp6.hooks</command></member></simplelist></entry><entry>core</entry><entry>Used to log messages related to management of hooks libraries, e.g. registration and deregistration of the libraries, and to the initialization of the callouts execution for various hook points within the DHCP server.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.host-&#xFEFF;cmds-&#xFEFF;hooks</command></member><member><command>kea-&#xFEFF;dhcp6.host-&#xFEFF;cmds-&#xFEFF;hooks</command></member></simplelist></entry><entry>libdhcp_host_cmds premium hook library</entry><entry>This logger is used to log messages related to operation of the Host Cmds hooks library. In general these will pertain to loading and unloading the library and the execution of commands by the library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.hosts</command></member><member><command>kea-&#xFEFF;dhcp6.hosts</command></member></simplelist></entry><entry>core</entry><entry>Used within the libdhcpsrv and it logs messages related to the management of the DHCP host reservations, i.e. retrieval of the reservations and adding new reservations.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.lease-&#xFEFF;cmds-&#xFEFF;hooks</command></member><member><command>kea-&#xFEFF;dhcp6.lease-&#xFEFF;cmds-&#xFEFF;hooks</command></member></simplelist></entry><entry>libdhcp_lease_cmds hook library</entry><entry>This logger is used to log messages related to operation of the Lease Cmds hooks library. In general these will pertain to loading and unloading the library and the execution of commands by the library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.leases</command></member><member><command>kea-&#xFEFF;dhcp6.leases</command></member></simplelist></entry><entry>core</entry><entry>Used by the DHCP server to log messages related to the lease allocation. The messages include detailed information about the allocated or offered leases, errors during the lease allocation etc.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.legal-log-hooks</command></member><member><command>kea-&#xFEFF;dhcp6.legal-log-hooks</command></member></simplelist></entry><entry>libdhcp_legal_log premium hook library</entry><entry>This logger is used to log messages related to operation of the Forensic Logging Hooks Library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.options</command></member><member><command>kea-&#xFEFF;dhcp4.options</command></member></simplelist></entry><entry>core</entry><entry>Used by the DHCP server to log messages related to processing of the options in the DHCP messages, i.e. parsing options, encoding options into on-&#xFEFF;wire format and packet classification using options contained in the received packets.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.packets</command></member><member><command>kea-&#xFEFF;dhcp6.packets</command></member></simplelist></entry><entry>core</entry><entry>This logger is mostly used to log messages related to transmission of the DHCP packets, i.e. packet reception and sending a response. Such messages include information about the source and destination IP addresses and interfaces used to transmit packets. The logger is also used to log messages related to subnet selection, as this selection is usually based on the IP addresses, relay addresses and/or interface names, which can be retrieved from the received packet, even before the DHCP message carried in the packet is parsed.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.radius-hooks</command></member><member><command>kea-&#xFEFF;dhcp6.radius-hooks</command></member></simplelist></entry><entry>libdhcp_radius premium hook library</entry><entry>This logger is used to log messages related to operation of the Radius Hook Library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.stat-&#xFEFF;cmds-&#xFEFF;hooks</command></member><member><command>kea-&#xFEFF;dhcp6.stat-&#xFEFF;cmds-&#xFEFF;hooks</command></member></simplelist></entry><entry>libdhcp_stat_cmds hook library</entry><entry>This logger is used to log messages related to operation of the Stats Cmds hooks library. In general these will pertain to loading and unloading the library and the execution of commands by the library.</entry></row>
<row><entry><simplelist type="horiz"><member><command>kea-&#xFEFF;dhcp4.subnet-&#xFEFF;cmds-&#xFEFF;hooks</command></member><member><command>kea-&#xFEFF;dhcp6.subnet-&#xFEFF;cmds-&#xFEFF;hooks</command></member></simplelist></entry><entry>libdhcp_subnet_cmds hook library</entry><entry>This logger is used to log messages related to operation of the Subnet Cmds hooks library. In general these will pertain to loading and unloading the library and the execution of commands by the library.</entry></row>
<row><entry><command>kea-dhcp-ddns</command></entry><entry>core</entry><entry>The root logger for the kea-dhcp-ddns daemon. All components used by this daemon inherit the settings from this logger if there is no specialized logger provided.</entry></row>
<row><entry><command>kea-dhcp-ddns.dctl</command></entry><entry>core</entry><entry>The logger used by the kea-dhcp-ddns daemon for logging basic information about the process, received signals and triggered reconfigurations.</entry></row>
<row><entry><command>kea-dhcp-ddns.dhcpddns</command></entry><entry>core</entry><entry>The logger used by the kea-dhcp-ddns daemon for logging events related to DDNS operations.</entry></row>
<row><entry><command>kea-dhcp-ddns.dhcp-to-d2</command></entry><entry>core</entry><entry>Used by the kea-dhcp-ddns daemon for logging information about events dealing with receiving messages from the DHCP servers and adding them to the queue for processing.</entry></row>
<row><entry><command>kea-dhcp-ddns.d2-to-dns</command></entry><entry>core</entry><entry>Used by the kea-dhcp-ddns daemon for logging information about events dealing with sending and receiving messages with the DNS servers.</entry></row>
</tbody>
</tgroup>
</table>
</para>
<para>
Note that user-defined hook libraries should not use any of those
loggers but should define new loggers with names that correspond to
the libraries using them. Suppose that the user created the library
called <quote>libpacket-capture</quote> to dump packets received and
called <quote>libdhcp-packet-capture</quote> to dump packets received and
transmitted by the server to the file. The appropriate name for the
logger could be <command>kea-dhcp4.packet-capture</command>. (Note
logger could be <command>kea-dhcp4.packet-capture-hooks</command>. (Note
that the hook library implementor only specifies the second part of
this name, i.e. <quote>packet-capture</quote>. The first part is a
root logger name and is prepended by the Kea logging system.) It is
@ -512,12 +242,6 @@
that can be overridden by an entry in the configuration file.
</para>
<para>
The list of loggers above excludes any loggers implemented in hooks
libraries. Please consult the documentation for the libraries for the
names of the loggers they define.
</para>
<para>
Additional loggers may be defined in future versions of Kea. The
easiest way to find out the logger name is to configure all logging to