mirror of
https://gitlab.isc.org/isc-projects/kea
synced 2025-09-05 08:25:16 +00:00
[#2883] added documentation for pool stats
This commit is contained in:
Razvan Becheriu
@@ -6719,454 +6719,541 @@ The DHCPv4 server supports the following statistics:
|
||||
:widths: 20 10 70
|
||||
|
||||
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| Statistic | Data Type | Description |
|
||||
+==============================================+================+====================================+
|
||||
| pkt4-received | integer | Number of DHCPv4 packets received. |
|
||||
| | | This includes all packets: valid, |
|
||||
| | | bogus, corrupted, rejected, etc. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | rapidly. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-discover-received | integer | Number of DHCPDISCOVER packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow; its increase |
|
||||
| | | means that clients that just |
|
||||
| | | booted started their configuration |
|
||||
| | | process and their initial packets |
|
||||
| | | reached the Kea server. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-offer-received | integer | Number of DHCPOFFER packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPOFFER packets are |
|
||||
| | | sent by the server and the server |
|
||||
| | | is never expected to receive them. |
|
||||
| | | A non-zero value indicates an |
|
||||
| | | error. One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPOFFER |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-request-received | integer | Number of DHCPREQUEST packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that clients that just |
|
||||
| | | booted received the server's |
|
||||
| | | response (DHCPOFFER) and accepted |
|
||||
| | | it, and are now requesting an |
|
||||
| | | address (DHCPREQUEST). |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-ack-received | integer | Number of DHCPACK packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPACK packets are sent |
|
||||
| | | by the server and the server is |
|
||||
| | | never expected to receive them. A |
|
||||
| | | non-zero value indicates an error. |
|
||||
| | | One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPACK |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-nak-received | integer | Number of DHCPNAK packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPNAK packets are sent |
|
||||
| | | by the server and the server is |
|
||||
| | | never expected to receive them. A |
|
||||
| | | non-zero value indicates an error. |
|
||||
| | | One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPNAK |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-release-received | integer | Number of DHCPRELEASE packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that clients that had an |
|
||||
| | | address are shutting down or |
|
||||
| | | ceasing to use their addresses. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-decline-received | integer | Number of DHCPDECLINE packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain close to zero. |
|
||||
| | | Its increase means that a client |
|
||||
| | | leased an address, but discovered |
|
||||
| | | that the address is currently |
|
||||
| | | used by an unknown device |
|
||||
| | | elsewhere in the network. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-inform-received | integer | Number of DHCPINFORM packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that there are clients |
|
||||
| | | that either do not need an address |
|
||||
| | | or already have an address and are |
|
||||
| | | interested only in getting |
|
||||
| | | additional configuration |
|
||||
| | | parameters. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-unknown-received | integer | Number of packets received of an |
|
||||
| | | unknown type. A non-zero value of |
|
||||
| | | this statistic indicates that the |
|
||||
| | | server received a packet that it |
|
||||
| | | was not able to recognize, either |
|
||||
| | | with an unsupported type or |
|
||||
| | | possibly malformed (without a |
|
||||
| | | message-type option). |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-sent | integer | Number of DHCPv4 packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | every time the server transmits a |
|
||||
| | | packet. In general, it should |
|
||||
| | | roughly match pkt4-received, as |
|
||||
| | | most incoming packets cause the |
|
||||
| | | server to respond. There are |
|
||||
| | | exceptions (e.g. DHCPRELEASE), so |
|
||||
| | | do not worry if it is less than |
|
||||
| | | pkt4-received. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-offer-sent | integer | Number of DHCPOFFER packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | in most cases after a DHCPDISCOVER |
|
||||
| | | is processed. There are certain |
|
||||
| | | uncommon, but valid, cases where |
|
||||
| | | incoming DHCPDISCOVER packets are |
|
||||
| | | dropped, but in general this |
|
||||
| | | statistic is expected to be close |
|
||||
| | | to pkt4-discover-received. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-ack-sent | integer | Number of DHCPACK packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | in most cases after a DHCPREQUEST |
|
||||
| | | is processed. There are certain |
|
||||
| | | cases where DHCPNAK is sent |
|
||||
| | | instead. In general, the sum of |
|
||||
| | | pkt4-ack-sent and pkt4-nak-sent |
|
||||
| | | should be close to |
|
||||
| | | pkt4-request-received. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-nak-sent | integer | Number of DHCPNAK packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | when the server chooses not to |
|
||||
| | | honor the address requested by a |
|
||||
| | | client. In general, the sum of |
|
||||
| | | pkt4-ack-sent and pkt4-nak-sent |
|
||||
| | | should be close to |
|
||||
| | | pkt4-request-received. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-parse-failed | integer | Number of incoming packets that |
|
||||
| | | could not be parsed. A non-zero |
|
||||
| | | value of this statistic indicates |
|
||||
| | | that the server received a |
|
||||
| | | malformed or truncated packet. |
|
||||
| | | This may indicate problems in the |
|
||||
| | | network, faulty clients, or a bug |
|
||||
| | | in the server. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-receive-drop | integer | Number of incoming packets that |
|
||||
| | | were dropped. The exact reason for |
|
||||
| | | dropping packets is logged, but |
|
||||
| | | the most common reasons may be: an |
|
||||
| | | unacceptable packet type was |
|
||||
| | | received, direct responses are |
|
||||
| | | forbidden, or the server-id sent |
|
||||
| | | by the client does not match the |
|
||||
| | | server's server-id. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].total-addresses | integer | Total number of addresses |
|
||||
| | | available for DHCPv4 management; |
|
||||
| | | in other words, this is the sum of |
|
||||
| | | all addresses in all configured |
|
||||
| | | pools. This statistic changes only |
|
||||
| | | during configuration updates. It |
|
||||
| | | does not take into account any |
|
||||
| | | addresses that may be reserved due |
|
||||
| | | to host reservation. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | This statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| cumulative-assigned-addresses | integer | Cumulative number of addresses |
|
||||
| | | that have been assigned since |
|
||||
| | | server startup. It is incremented |
|
||||
| | | each time an address is assigned |
|
||||
| | | and is not reset when the server |
|
||||
| | | is reconfigured. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].cumulative-assigned-addresses | integer | Cumulative number of assigned |
|
||||
| | | addresses in a given subnet. It |
|
||||
| | | increases every time a new lease |
|
||||
| | | is allocated (as a result of |
|
||||
| | | receiving a DHCPREQUEST message) |
|
||||
| | | and never decreases. The *id* is |
|
||||
| | | the subnet-id of the subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].assigned-addresses | integer | Number of assigned addresses in a |
|
||||
| | | given subnet. It increases every |
|
||||
| | | time a new lease is allocated (as |
|
||||
| | | a result of receiving a |
|
||||
| | | DHCPREQUEST message) and decreases |
|
||||
| | | every time a lease is released (a |
|
||||
| | | DHCPRELEASE message is received) |
|
||||
| | | or expires. The *id* is the |
|
||||
| | | subnet-id of the subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| reclaimed-leases | integer | Number of expired leases that have |
|
||||
| | | been reclaimed since server |
|
||||
| | | startup. It is incremented each |
|
||||
| | | time an expired lease is reclaimed |
|
||||
| | | and never decreases. It can be |
|
||||
| | | used as a long-term indicator of |
|
||||
| | | how many actual leases have been |
|
||||
| | | reclaimed. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].reclaimed-leases | integer | Number of expired leases |
|
||||
| | | associated with a given subnet |
|
||||
| | | (*id* is the subnet-id) that have |
|
||||
| | | been reclaimed since server |
|
||||
| | | startup. It is incremented each |
|
||||
| | | time an expired lease is |
|
||||
| | | reclaimed. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| declined-addresses | integer | Number of IPv4 addresses that are |
|
||||
| | | currently declined; a count of the |
|
||||
| | | number of leases currently |
|
||||
| | | unavailable. Once a lease is |
|
||||
| | | recovered, this statistic is |
|
||||
| | | decreased; ideally, this statistic |
|
||||
| | | should be zero. If this statistic |
|
||||
| | | is non-zero or increasing, a |
|
||||
| | | network administrator should |
|
||||
| | | investigate whether there is a |
|
||||
| | | misbehaving device in the network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].declined-addresses | integer | Number of IPv4 addresses that are |
|
||||
| | | currently declined in a given |
|
||||
| | | subnet; a count of the number of |
|
||||
| | | leases currently unavailable. Once |
|
||||
| | | a lease is recovered, this |
|
||||
| | | statistic is decreased; ideally, |
|
||||
| | | this statistic should be zero. If |
|
||||
| | | this statistic is non-zero or |
|
||||
| | | increasing, a network |
|
||||
| | | administrator should investigate |
|
||||
| | | whether there is a misbehaving |
|
||||
| | | device in the network. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | This statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
|
||||
| | | declined, but have now been |
|
||||
| | | recovered. Unlike |
|
||||
| | | declined-addresses, this statistic |
|
||||
| | | never decreases. It can be used as |
|
||||
| | | a long-term indicator of how many |
|
||||
| | | actual valid declines were |
|
||||
| | | processed and recovered from. This |
|
||||
| | | is a global statistic that covers |
|
||||
| | | all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
|
||||
| | | declined, but have now been |
|
||||
| | | recovered. Unlike |
|
||||
| | | declined-addresses, this statistic |
|
||||
| | | never decreases. It can be used as |
|
||||
| | | a long-term indicator of how many |
|
||||
| | | actual valid declines were |
|
||||
| | | processed and recovered from. The |
|
||||
| | | *id* is the subnet-id of a given |
|
||||
| | | subnet. This statistic is exposed |
|
||||
| | | for each subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-received | integer | Number of IPv4 DHCPLEASEQUERY |
|
||||
| | | packets received. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-unknown-sent | integer | Number of IPv4 DHCPLEASEUNKNOWN |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-unassigned-sent | integer | Number of IPv4 DHCPLEASEUNASSIGNED |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-active-sent | integer | Number of IPv4 DHCPLEASEACTIVE |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail | integer | Number of total address allocation |
|
||||
| | | failures for a particular client. |
|
||||
| | | This consists in the number of |
|
||||
| | | lease allocation attempts that the |
|
||||
| | | server made before giving up and |
|
||||
| | | was unable to use any of the |
|
||||
| | | address pools. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail | integer | Number of total address allocation |
|
||||
| | | failures for a particular client. |
|
||||
| | | This consists in the number of |
|
||||
| | | lease allocation attempts that the |
|
||||
| | | server made before giving up and |
|
||||
| | | was unable to use any of the |
|
||||
| | | address pools. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-shared-network | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a shared network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-shared-network | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a shared network. |
|
||||
| | | The *id* is the subnet-id of a |
|
||||
| | | given subnet. This statistic is |
|
||||
| | | exposed for each subnet |
|
||||
| | | separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-subnet | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a subnet that does |
|
||||
| | | not belong to a shared network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-subnet | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a subnet that does |
|
||||
| | | not belong to a shared network. |
|
||||
| | | The *id* is the subnet-id of a |
|
||||
| | | given subnet. This statistic is |
|
||||
| | | exposed for each subnet |
|
||||
| | | separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-no-pools | integer | Number of address allocation |
|
||||
| | | failures because the server could |
|
||||
| | | not use any configured pools for |
|
||||
| | | a particular client. It is also |
|
||||
| | | possible that all of the subnets |
|
||||
| | | from which the server attempted to |
|
||||
| | | assign an address lack address |
|
||||
| | | pools. In this case, it should be |
|
||||
| | | considered misconfiguration if an |
|
||||
| | | operator expects that some clients |
|
||||
| | | should be assigned dynamic |
|
||||
| | | addresses. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-no-pools | integer | Number of address allocation |
|
||||
| | | failures because the server could |
|
||||
| | | not use any configured pools for |
|
||||
| | | a particular client. It is also |
|
||||
| | | possible that all of the subnets |
|
||||
| | | from which the server attempted to |
|
||||
| | | assign an address lack address |
|
||||
| | | pools. In this case, it should be |
|
||||
| | | considered misconfiguration if an |
|
||||
| | | operator expects that some clients |
|
||||
| | | should be assigned dynamic |
|
||||
| | | addresses. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-classes | integer | Number of address allocation |
|
||||
| | | failures when the client's packet |
|
||||
| | | belongs to one or more classes. |
|
||||
| | | There may be several reasons why a |
|
||||
| | | lease was not assigned. One of |
|
||||
| | | them may be a case when all pools |
|
||||
| | | require packet to belong to |
|
||||
| | | certain classes and the incoming |
|
||||
| | | packet didn't belong to any of |
|
||||
| | | them. Another case where this |
|
||||
| | | information may be useful is to |
|
||||
| | | point out that the pool reserved |
|
||||
| | | to a given class has ran out of |
|
||||
| | | addresses. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-classes | integer | Number of address allocation |
|
||||
| | | failures when the client's packet |
|
||||
| | | belongs to one or more classes. |
|
||||
| | | There may be several reasons why a |
|
||||
| | | lease was not assigned. One of |
|
||||
| | | them may be a case when all pools |
|
||||
| | | require packet to belong to |
|
||||
| | | certain classes and the incoming |
|
||||
| | | packet didn't belong to any of |
|
||||
| | | them. Another case where this |
|
||||
| | | information may be useful is to |
|
||||
| | | point out that the pool reserved |
|
||||
| | | to a given class has ran out of |
|
||||
| | | addresses. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-lease-reuses | integer | Number of times an IPv4 lease had |
|
||||
| | | its CLTT increased in memory and |
|
||||
| | | its expiration time left unchanged |
|
||||
| | | in persistent storage as part of |
|
||||
| | | the lease caching feature. This is |
|
||||
| | | referred to as a lease reuse. |
|
||||
| | | This statistic is global. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-lease-reuses | integer | Number of times an IPv4 lease had |
|
||||
| | | its CLTT increased in memory and |
|
||||
| | | its expiration time left unchanged |
|
||||
| | | in persistent storage as part of |
|
||||
| | | the lease caching feature. This is |
|
||||
| | | referred to as a lease reuse. |
|
||||
| | | This statistic is on a per-subnet |
|
||||
| | | basis. The *id* is the subnet-id |
|
||||
| | | of a given subnet. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| v4-reservation-conflicts | integer | Number of host reservation |
|
||||
| | | allocation conflicts which have |
|
||||
| | | occurred across every subnet. When |
|
||||
| | | a client sends a DHCP Discover and |
|
||||
| | | is matched to a host reservation |
|
||||
| | | which is already leased to another |
|
||||
| | | client, this counter is increased |
|
||||
| | | by 1. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-reservation-conflicts | integer | Number of host reservation |
|
||||
| | | allocation conflicts which have |
|
||||
| | | occurred in a specific subnet. |
|
||||
| | | When a client sends a DHCP |
|
||||
| | | Discover and is matched to a host |
|
||||
| | | reservation which is already |
|
||||
| | | leased to another client, this |
|
||||
| | | counter is increased by 1. |
|
||||
+----------------------------------------------+----------------+------------------------------------+
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| Statistic | Data Type | Description |
|
||||
+====================================================+================+====================================+
|
||||
| pkt4-received | integer | Number of DHCPv4 packets received. |
|
||||
| | | This includes all packets: valid, |
|
||||
| | | bogus, corrupted, rejected, etc. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | rapidly. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-discover-received | integer | Number of DHCPDISCOVER packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow; its increase |
|
||||
| | | means that clients that just |
|
||||
| | | booted started their configuration |
|
||||
| | | process and their initial packets |
|
||||
| | | reached the Kea server. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-offer-received | integer | Number of DHCPOFFER packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPOFFER packets are |
|
||||
| | | sent by the server and the server |
|
||||
| | | is never expected to receive them. |
|
||||
| | | A non-zero value indicates an |
|
||||
| | | error. One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPOFFER |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-request-received | integer | Number of DHCPREQUEST packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that clients that just |
|
||||
| | | booted received the server's |
|
||||
| | | response (DHCPOFFER) and accepted |
|
||||
| | | it, and are now requesting an |
|
||||
| | | address (DHCPREQUEST). |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-ack-received | integer | Number of DHCPACK packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPACK packets are sent |
|
||||
| | | by the server and the server is |
|
||||
| | | never expected to receive them. A |
|
||||
| | | non-zero value indicates an error. |
|
||||
| | | One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPACK |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-nak-received | integer | Number of DHCPNAK packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain zero at all |
|
||||
| | | times, as DHCPNAK packets are sent |
|
||||
| | | by the server and the server is |
|
||||
| | | never expected to receive them. A |
|
||||
| | | non-zero value indicates an error. |
|
||||
| | | One likely cause would be a |
|
||||
| | | misbehaving relay agent that |
|
||||
| | | incorrectly forwards DHCPNAK |
|
||||
| | | messages towards the server, |
|
||||
| | | rather than back to the clients. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-release-received | integer | Number of DHCPRELEASE packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that clients that had an |
|
||||
| | | address are shutting down or |
|
||||
| | | ceasing to use their addresses. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-decline-received | integer | Number of DHCPDECLINE packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to remain close to zero. |
|
||||
| | | Its increase means that a client |
|
||||
| | | leased an address, but discovered |
|
||||
| | | that the address is currently |
|
||||
| | | used by an unknown device |
|
||||
| | | elsewhere in the network. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-inform-received | integer | Number of DHCPINFORM packets |
|
||||
| | | received. This statistic is |
|
||||
| | | expected to grow. Its increase |
|
||||
| | | means that there are clients |
|
||||
| | | that either do not need an address |
|
||||
| | | or already have an address and are |
|
||||
| | | interested only in getting |
|
||||
| | | additional configuration |
|
||||
| | | parameters. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-unknown-received | integer | Number of packets received of an |
|
||||
| | | unknown type. A non-zero value of |
|
||||
| | | this statistic indicates that the |
|
||||
| | | server received a packet that it |
|
||||
| | | was not able to recognize, either |
|
||||
| | | with an unsupported type or |
|
||||
| | | possibly malformed (without a |
|
||||
| | | message-type option). |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-sent | integer | Number of DHCPv4 packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | every time the server transmits a |
|
||||
| | | packet. In general, it should |
|
||||
| | | roughly match pkt4-received, as |
|
||||
| | | most incoming packets cause the |
|
||||
| | | server to respond. There are |
|
||||
| | | exceptions (e.g. DHCPRELEASE), so |
|
||||
| | | do not worry if it is less than |
|
||||
| | | pkt4-received. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-offer-sent | integer | Number of DHCPOFFER packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | in most cases after a DHCPDISCOVER |
|
||||
| | | is processed. There are certain |
|
||||
| | | uncommon, but valid, cases where |
|
||||
| | | incoming DHCPDISCOVER packets are |
|
||||
| | | dropped, but in general this |
|
||||
| | | statistic is expected to be close |
|
||||
| | | to pkt4-discover-received. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-ack-sent | integer | Number of DHCPACK packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | in most cases after a DHCPREQUEST |
|
||||
| | | is processed. There are certain |
|
||||
| | | cases where DHCPNAK is sent |
|
||||
| | | instead. In general, the sum of |
|
||||
| | | pkt4-ack-sent and pkt4-nak-sent |
|
||||
| | | should be close to |
|
||||
| | | pkt4-request-received. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-nak-sent | integer | Number of DHCPNAK packets sent. |
|
||||
| | | This statistic is expected to grow |
|
||||
| | | when the server chooses not to |
|
||||
| | | honor the address requested by a |
|
||||
| | | client. In general, the sum of |
|
||||
| | | pkt4-ack-sent and pkt4-nak-sent |
|
||||
| | | should be close to |
|
||||
| | | pkt4-request-received. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-parse-failed | integer | Number of incoming packets that |
|
||||
| | | could not be parsed. A non-zero |
|
||||
| | | value of this statistic indicates |
|
||||
| | | that the server received a |
|
||||
| | | malformed or truncated packet. |
|
||||
| | | This may indicate problems in the |
|
||||
| | | network, faulty clients, or a bug |
|
||||
| | | in the server. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-receive-drop | integer | Number of incoming packets that |
|
||||
| | | were dropped. The exact reason for |
|
||||
| | | dropping packets is logged, but |
|
||||
| | | the most common reasons may be: an |
|
||||
| | | unacceptable packet type was |
|
||||
| | | received, direct responses are |
|
||||
| | | forbidden, or the server-id sent |
|
||||
| | | by the client does not match the |
|
||||
| | | server's server-id. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].total-addresses | integer | Total number of addresses |
|
||||
| | | available for DHCPv4 management |
|
||||
| | | for a given subnet; in other |
|
||||
| | | words, this is the sum of all |
|
||||
| | | addresses in all configured pools. |
|
||||
| | | This statistic changes only during |
|
||||
| | | configuration updates. It does not |
|
||||
| | | take into account any addresses |
|
||||
| | | that may be reserved due to host |
|
||||
| | | reservation. The *id* is the |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | This statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].total-addresses | integer | Total number of addresses |
|
||||
| | | available for DHCPv4 management |
|
||||
| | | for a given subnet pool; in other |
|
||||
| | | words, this is the sum of all |
|
||||
| | | addresses in configured subnet |
|
||||
| | | pool. This statistic changes only |
|
||||
| | | during configuration updates. It |
|
||||
| | | does not take into account any |
|
||||
| | | addresses that may be reserved due |
|
||||
| | | to host reservation. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | The *pid* is the pool-id of a |
|
||||
| | | given pool. This statistic is |
|
||||
| | | exposed for each subnet pool |
|
||||
| | | separately, and is reset during a |
|
||||
| | | reconfiguration event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| cumulative-assigned-addresses | integer | Cumulative number of addresses |
|
||||
| | | that have been assigned since |
|
||||
| | | server startup. It is incremented |
|
||||
| | | each time an address is assigned |
|
||||
| | | and is not reset when the server |
|
||||
| | | is reconfigured. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].cumulative-assigned-addresses | integer | Cumulative number of assigned |
|
||||
| | | addresses in a given subnet. It |
|
||||
| | | increases every time a new lease |
|
||||
| | | is allocated (as a result of |
|
||||
| | | receiving a DHCPREQUEST message) |
|
||||
| | | and never decreases. The *id* is |
|
||||
| | | the subnet-id of the subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].cumulative-assigned-addresses | integer | Cumulative number of assigned |
|
||||
| | | addresses in a given subnet pool. |
|
||||
| | | It increases every time a new |
|
||||
| | | lease is allocated (as a result of |
|
||||
| | | receiving a DHCPREQUEST message) |
|
||||
| | | and never decreases. The *id* is |
|
||||
| | | the subnet-id of the subnet. The |
|
||||
| | | *pid* is the pool-id of the pool. |
|
||||
| | | This statistic is exposed for each |
|
||||
| | | subnet pool separately, and is |
|
||||
| | | reset during a reconfiguration |
|
||||
| | | event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].assigned-addresses | integer | Number of assigned addresses in a |
|
||||
| | | given subnet. It increases every |
|
||||
| | | time a new lease is allocated (as |
|
||||
| | | a result of receiving a |
|
||||
| | | DHCPREQUEST message) and decreases |
|
||||
| | | every time a lease is released (a |
|
||||
| | | DHCPRELEASE message is received) |
|
||||
| | | or expires. The *id* is the |
|
||||
| | | subnet-id of the subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately, and is reset |
|
||||
| | | during a reconfiguration event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].assigned-addresses | integer | Number of assigned addresses in a |
|
||||
| | | given subnet pool. It increases |
|
||||
| | | every time a new lease is |
|
||||
| | | allocated (as a result of |
|
||||
| | | receiving a DHCPREQUEST message) |
|
||||
| | | and decreases every time a lease |
|
||||
| | | is released (a DHCPRELEASE message |
|
||||
| | | is received) or expires. The *id* |
|
||||
| | | is the subnet-id of the subnet. |
|
||||
| | | The *pid* is the pool-id of the |
|
||||
| | | pool. This statistic is exposed |
|
||||
| | | for each subnet pool separately, |
|
||||
| | | and is reset during a |
|
||||
| | | reconfiguration event. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| reclaimed-leases | integer | Number of expired leases that have |
|
||||
| | | been reclaimed since server |
|
||||
| | | startup. It is incremented each |
|
||||
| | | time an expired lease is reclaimed |
|
||||
| | | and never decreases. It can be |
|
||||
| | | used as a long-term indicator of |
|
||||
| | | how many actual leases have been |
|
||||
| | | reclaimed. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].reclaimed-leases | integer | Number of expired leases |
|
||||
| | | associated with a given subnet |
|
||||
| | | that have been reclaimed since |
|
||||
| | | server startup. It is incremented |
|
||||
| | | each time an expired lease is |
|
||||
| | | reclaimed. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].reclaimed-leases | integer | Number of expired leases |
|
||||
| | | associated with a given subnet |
|
||||
| | | pool that have been reclaimed |
|
||||
| | | since server startup. It is |
|
||||
| | | incremented each time an expired |
|
||||
| | | lease is reclaimed. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | The *pid* is the pool-id of the |
|
||||
| | | pool. This statistic is exposed |
|
||||
| | | for each subnet pool separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| declined-addresses | integer | Number of IPv4 addresses that are |
|
||||
| | | currently declined; a count of the |
|
||||
| | | number of leases currently |
|
||||
| | | unavailable. Once a lease is |
|
||||
| | | recovered, this statistic is |
|
||||
| | | decreased; ideally, this statistic |
|
||||
| | | should be zero. If this statistic |
|
||||
| | | is non-zero or increasing, a |
|
||||
| | | network administrator should |
|
||||
| | | investigate whether there is a |
|
||||
| | | misbehaving device in the network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].declined-addresses | integer | Number of IPv4 addresses that are |
|
||||
| | | currently declined in a given |
|
||||
| | | subnet; a count of the number of |
|
||||
| | | leases currently unavailable. Once |
|
||||
| | | a lease is recovered, this |
|
||||
| | | statistic is decreased; ideally, |
|
||||
| | | this statistic should be zero. If |
|
||||
| | | this statistic is non-zero or |
|
||||
| | | increasing, a network |
|
||||
| | | administrator should investigate |
|
||||
| | | whether there is a misbehaving |
|
||||
| | | device in the network. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | This statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].declined-addresses | integer | Number of IPv4 addresses that are |
|
||||
| | | currently declined in a given |
|
||||
| | | subnet pool; a count of the number |
|
||||
| | | of leases currently unavailable. |
|
||||
| | | Once a lease is recovered, this |
|
||||
| | | statistic is decreased; ideally, |
|
||||
| | | this statistic should be zero. If |
|
||||
| | | this statistic is non-zero or |
|
||||
| | | increasing, a network |
|
||||
| | | administrator should investigate |
|
||||
| | | whether there is a misbehaving |
|
||||
| | | device in the network. The *id* is |
|
||||
| | | the subnet-id of a given subnet. |
|
||||
| | | The *pid* is the pool-id of the |
|
||||
| | | pool. This statistic is exposed |
|
||||
| | | for each subnet pool separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
|
||||
| | | declined, but have now been |
|
||||
| | | recovered. Unlike |
|
||||
| | | declined-addresses, this statistic |
|
||||
| | | never decreases. It can be used as |
|
||||
| | | a long-term indicator of how many |
|
||||
| | | actual valid declines were |
|
||||
| | | processed and recovered from. This |
|
||||
| | | is a global statistic that covers |
|
||||
| | | all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
|
||||
| | | declined, but have now been |
|
||||
| | | recovered. Unlike |
|
||||
| | | declined-addresses, this statistic |
|
||||
| | | never decreases. It can be used as |
|
||||
| | | a long-term indicator of how many |
|
||||
| | | actual valid declines were |
|
||||
| | | processed and recovered from. The |
|
||||
| | | *id* is the subnet-id of a given |
|
||||
| | | subnet. This statistic is exposed |
|
||||
| | | for each subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].pool[pid].reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
|
||||
| | | declined, but have now been |
|
||||
| | | recovered. Unlike |
|
||||
| | | declined-addresses, this statistic |
|
||||
| | | never decreases. It can be used as |
|
||||
| | | a long-term indicator of how many |
|
||||
| | | actual valid declines were |
|
||||
| | | processed and recovered from. The |
|
||||
| | | *id* is the subnet-id of a given |
|
||||
| | | subnet. The *pid* is the pool-id |
|
||||
| | | of the pool. This statistic is |
|
||||
| | | exposed for each subnet pool |
|
||||
| | | separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-received | integer | Number of IPv4 DHCPLEASEQUERY |
|
||||
| | | packets received. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-unknown-sent | integer | Number of IPv4 DHCPLEASEUNKNOWN |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-unassigned-sent | integer | Number of IPv4 DHCPLEASEUNASSIGNED |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| pkt4-lease-query-response-active-sent | integer | Number of IPv4 DHCPLEASEACTIVE |
|
||||
| | | responses sent. (Only exists if |
|
||||
| | | Leasequery hook library is |
|
||||
| | | loaded.) |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail | integer | Number of total address allocation |
|
||||
| | | failures for a particular client. |
|
||||
| | | This consists in the number of |
|
||||
| | | lease allocation attempts that the |
|
||||
| | | server made before giving up and |
|
||||
| | | was unable to use any of the |
|
||||
| | | address pools. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail | integer | Number of total address allocation |
|
||||
| | | failures for a particular client. |
|
||||
| | | This consists in the number of |
|
||||
| | | lease allocation attempts that the |
|
||||
| | | server made before giving up and |
|
||||
| | | was unable to use any of the |
|
||||
| | | address pools. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-shared-network | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a shared network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-shared-network | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a shared network. |
|
||||
| | | The *id* is the subnet-id of a |
|
||||
| | | given subnet. This statistic is |
|
||||
| | | exposed for each subnet |
|
||||
| | | separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-subnet | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a subnet that does |
|
||||
| | | not belong to a shared network. |
|
||||
| | | This is a global statistic that |
|
||||
| | | covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-subnet | integer | Number of address allocation |
|
||||
| | | failures for a particular client |
|
||||
| | | connected to a subnet that does |
|
||||
| | | not belong to a shared network. |
|
||||
| | | The *id* is the subnet-id of a |
|
||||
| | | given subnet. This statistic is |
|
||||
| | | exposed for each subnet |
|
||||
| | | separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-no-pools | integer | Number of address allocation |
|
||||
| | | failures because the server could |
|
||||
| | | not use any configured pools for |
|
||||
| | | a particular client. It is also |
|
||||
| | | possible that all of the subnets |
|
||||
| | | from which the server attempted to |
|
||||
| | | assign an address lack address |
|
||||
| | | pools. In this case, it should be |
|
||||
| | | considered misconfiguration if an |
|
||||
| | | operator expects that some clients |
|
||||
| | | should be assigned dynamic |
|
||||
| | | addresses. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-no-pools | integer | Number of address allocation |
|
||||
| | | failures because the server could |
|
||||
| | | not use any configured pools for |
|
||||
| | | a particular client. It is also |
|
||||
| | | possible that all of the subnets |
|
||||
| | | from which the server attempted to |
|
||||
| | | assign an address lack address |
|
||||
| | | pools. In this case, it should be |
|
||||
| | | considered misconfiguration if an |
|
||||
| | | operator expects that some clients |
|
||||
| | | should be assigned dynamic |
|
||||
| | | addresses. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-allocation-fail-classes | integer | Number of address allocation |
|
||||
| | | failures when the client's packet |
|
||||
| | | belongs to one or more classes. |
|
||||
| | | There may be several reasons why a |
|
||||
| | | lease was not assigned. One of |
|
||||
| | | them may be a case when all pools |
|
||||
| | | require packet to belong to |
|
||||
| | | certain classes and the incoming |
|
||||
| | | packet didn't belong to any of |
|
||||
| | | them. Another case where this |
|
||||
| | | information may be useful is to |
|
||||
| | | point out that the pool reserved |
|
||||
| | | to a given class has ran out of |
|
||||
| | | addresses. This is a global |
|
||||
| | | statistic that covers all subnets. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-allocation-fail-classes | integer | Number of address allocation |
|
||||
| | | failures when the client's packet |
|
||||
| | | belongs to one or more classes. |
|
||||
| | | There may be several reasons why a |
|
||||
| | | lease was not assigned. One of |
|
||||
| | | them may be a case when all pools |
|
||||
| | | require packet to belong to |
|
||||
| | | certain classes and the incoming |
|
||||
| | | packet didn't belong to any of |
|
||||
| | | them. Another case where this |
|
||||
| | | information may be useful is to |
|
||||
| | | point out that the pool reserved |
|
||||
| | | to a given class has ran out of |
|
||||
| | | addresses. The *id* is the |
|
||||
| | | subnet-id of a given subnet. This |
|
||||
| | | statistic is exposed for each |
|
||||
| | | subnet separately. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-lease-reuses | integer | Number of times an IPv4 lease had |
|
||||
| | | its CLTT increased in memory and |
|
||||
| | | its expiration time left unchanged |
|
||||
| | | in persistent storage as part of |
|
||||
| | | the lease caching feature. This is |
|
||||
| | | referred to as a lease reuse. |
|
||||
| | | This statistic is global. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-lease-reuses | integer | Number of times an IPv4 lease had |
|
||||
| | | its CLTT increased in memory and |
|
||||
| | | its expiration time left unchanged |
|
||||
| | | in persistent storage as part of |
|
||||
| | | the lease caching feature. This is |
|
||||
| | | referred to as a lease reuse. |
|
||||
| | | This statistic is on a per-subnet |
|
||||
| | | basis. The *id* is the subnet-id |
|
||||
| | | of a given subnet. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| v4-reservation-conflicts | integer | Number of host reservation |
|
||||
| | | allocation conflicts which have |
|
||||
| | | occurred across every subnet. When |
|
||||
| | | a client sends a DHCP Discover and |
|
||||
| | | is matched to a host reservation |
|
||||
| | | which is already leased to another |
|
||||
| | | client, this counter is increased |
|
||||
| | | by 1. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
| subnet[id].v4-reservation-conflicts | integer | Number of host reservation |
|
||||
| | | allocation conflicts which have |
|
||||
| | | occurred in a specific subnet. |
|
||||
| | | When a client sends a DHCP |
|
||||
| | | Discover and is matched to a host |
|
||||
| | | reservation which is already |
|
||||
| | | leased to another client, this |
|
||||
| | | counter is increased by 1. |
|
||||
+----------------------------------------------------+----------------+------------------------------------+
|
||||
|
||||
.. note::
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -233,211 +233,635 @@ Here is an example response returning all collected statistics:
|
||||
"cumulative-assigned-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487569"
|
||||
"2023-06-13 20:42:46.836166"
|
||||
]
|
||||
],
|
||||
"declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487555"
|
||||
"2023-06-13 20:42:46.836156"
|
||||
]
|
||||
],
|
||||
"pkt4-ack-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455233"
|
||||
"2023-06-13 20:42:46.616247"
|
||||
]
|
||||
],
|
||||
"pkt4-ack-sent": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455256"
|
||||
"2023-06-13 20:42:46.616290"
|
||||
]
|
||||
],
|
||||
"pkt4-decline-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455259"
|
||||
"2023-06-13 20:42:46.616296"
|
||||
]
|
||||
],
|
||||
"pkt4-discover-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455263"
|
||||
"2023-06-13 20:42:46.616303"
|
||||
]
|
||||
],
|
||||
"pkt4-inform-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455265"
|
||||
"2023-06-13 20:42:46.616308"
|
||||
]
|
||||
],
|
||||
"pkt4-nak-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455269"
|
||||
"2023-06-13 20:42:46.616312"
|
||||
]
|
||||
],
|
||||
"pkt4-nak-sent": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455271"
|
||||
"2023-06-13 20:42:46.616314"
|
||||
]
|
||||
],
|
||||
"pkt4-offer-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455274"
|
||||
"2023-06-13 20:42:46.616318"
|
||||
]
|
||||
],
|
||||
"pkt4-offer-sent": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455277"
|
||||
"2023-06-13 20:42:46.616323"
|
||||
]
|
||||
],
|
||||
"pkt4-parse-failed": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455280"
|
||||
"2023-06-13 20:42:46.616326"
|
||||
]
|
||||
],
|
||||
"pkt4-receive-drop": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455284"
|
||||
"2023-06-13 20:42:46.616330"
|
||||
]
|
||||
],
|
||||
"pkt4-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455287"
|
||||
"2023-06-13 20:42:46.616335"
|
||||
]
|
||||
],
|
||||
"pkt4-release-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455290"
|
||||
"2023-06-13 20:42:46.616339"
|
||||
]
|
||||
],
|
||||
"pkt4-request-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455293"
|
||||
"2023-06-13 20:42:46.616343"
|
||||
]
|
||||
],
|
||||
"pkt4-sent": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455296"
|
||||
"2023-06-13 20:42:46.616348"
|
||||
]
|
||||
],
|
||||
"pkt4-unknown-received": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455299"
|
||||
"2023-06-13 20:42:46.616354"
|
||||
]
|
||||
],
|
||||
"reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487559"
|
||||
"2023-06-13 20:42:46.836159"
|
||||
]
|
||||
],
|
||||
"reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487564"
|
||||
"2023-06-13 20:42:46.836163"
|
||||
]
|
||||
],
|
||||
"subnet[1].assigned-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487579"
|
||||
"2023-06-13 20:42:46.836173"
|
||||
]
|
||||
],
|
||||
"subnet[1].cumulative-assigned-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487528"
|
||||
"2023-06-13 20:42:46.836098"
|
||||
]
|
||||
],
|
||||
"subnet[1].declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487585"
|
||||
"2023-06-13 20:42:46.836178"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].assigned-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 20:42:46.836205"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].cumulative-assigned-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 20:42:46.836137"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 20:42:46.836213"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 20:42:46.836225"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 20:42:46.836236"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].total-addresses": [
|
||||
[
|
||||
11010049,
|
||||
"2023-06-13 20:42:46.836128"
|
||||
]
|
||||
],
|
||||
"subnet[1].reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487595"
|
||||
"2023-06-13 20:42:46.836186"
|
||||
]
|
||||
],
|
||||
"subnet[1].reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487604"
|
||||
"2023-06-13 20:42:46.836194"
|
||||
]
|
||||
],
|
||||
"subnet[1].total-addresses": [
|
||||
[
|
||||
200,
|
||||
"2022-02-11 17:54:17.487512"
|
||||
11010049,
|
||||
"2023-06-13 20:42:46.836083"
|
||||
]
|
||||
],
|
||||
"subnet[1].v4-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487516"
|
||||
"2023-06-13 20:42:46.836105"
|
||||
]
|
||||
],
|
||||
"subnet[1].v4-reservation-conflicts": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.487520"
|
||||
"2023-06-13 20:42:46.836111"
|
||||
]
|
||||
],
|
||||
"v4-allocation-fail": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455302"
|
||||
"2023-06-13 20:42:46.616358"
|
||||
]
|
||||
],
|
||||
"v4-allocation-fail-classes": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455306"
|
||||
"2023-06-13 20:42:46.616363"
|
||||
]
|
||||
],
|
||||
"v4-allocation-fail-no-pools": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455310"
|
||||
"2023-06-13 20:42:46.616368"
|
||||
]
|
||||
],
|
||||
"v4-allocation-fail-shared-network": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455319"
|
||||
"2023-06-13 20:42:46.616372"
|
||||
]
|
||||
],
|
||||
"v4-allocation-fail-subnet": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455323"
|
||||
"2023-06-13 20:42:46.616376"
|
||||
]
|
||||
],
|
||||
"v4-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455328"
|
||||
"2023-06-13 20:42:46.616410"
|
||||
]
|
||||
],
|
||||
"v4-reservation-conflicts": [
|
||||
[
|
||||
0,
|
||||
"2022-02-11 17:54:17.455332"
|
||||
"2023-06-13 20:42:46.616412"
|
||||
]
|
||||
]
|
||||
},
|
||||
"result": 0
|
||||
}
|
||||
|
||||
or
|
||||
|
||||
::
|
||||
|
||||
{
|
||||
"command": "statistic-get-all",
|
||||
"arguments": {
|
||||
"cumulative-assigned-nas": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196757"
|
||||
]
|
||||
],
|
||||
"cumulative-assigned-pds": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196758"
|
||||
]
|
||||
],
|
||||
"declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196754"
|
||||
]
|
||||
],
|
||||
"pkt6-advertise-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177731"
|
||||
]
|
||||
],
|
||||
"pkt6-advertise-sent": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177739"
|
||||
]
|
||||
],
|
||||
"pkt6-decline-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177739"
|
||||
]
|
||||
],
|
||||
"pkt6-dhcpv4-query-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177740"
|
||||
]
|
||||
],
|
||||
"pkt6-dhcpv4-response-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177740"
|
||||
]
|
||||
],
|
||||
"pkt6-dhcpv4-response-sent": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177741"
|
||||
]
|
||||
],
|
||||
"pkt6-infrequest-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177742"
|
||||
]
|
||||
],
|
||||
"pkt6-parse-failed": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177742"
|
||||
]
|
||||
],
|
||||
"pkt6-rebind-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177743"
|
||||
]
|
||||
],
|
||||
"pkt6-receive-drop": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177743"
|
||||
]
|
||||
],
|
||||
"pkt6-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177744"
|
||||
]
|
||||
],
|
||||
"pkt6-release-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177744"
|
||||
]
|
||||
],
|
||||
"pkt6-renew-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177745"
|
||||
]
|
||||
],
|
||||
"pkt6-reply-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177745"
|
||||
]
|
||||
],
|
||||
"pkt6-reply-sent": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177746"
|
||||
]
|
||||
],
|
||||
"pkt6-request-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177747"
|
||||
]
|
||||
],
|
||||
"pkt6-sent": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177747"
|
||||
]
|
||||
],
|
||||
"pkt6-solicit-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177748"
|
||||
]
|
||||
],
|
||||
"pkt6-unknown-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177748"
|
||||
]
|
||||
],
|
||||
"reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196755"
|
||||
]
|
||||
],
|
||||
"reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196756"
|
||||
]
|
||||
],
|
||||
"subnet[1].assigned-nas": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196760"
|
||||
]
|
||||
],
|
||||
"subnet[1].assigned-pds": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196761"
|
||||
]
|
||||
],
|
||||
"subnet[1].cumulative-assigned-nas": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196727"
|
||||
]
|
||||
],
|
||||
"subnet[1].cumulative-assigned-pds": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196729"
|
||||
]
|
||||
],
|
||||
"subnet[1].declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196763"
|
||||
]
|
||||
],
|
||||
"subnet[1].pd-pool[0].assigned-pds": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196785"
|
||||
]
|
||||
],
|
||||
"subnet[1].pd-pool[0].cumulative-assigned-pds": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196744"
|
||||
]
|
||||
],
|
||||
"subnet[1].pd-pool[0].reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196789"
|
||||
]
|
||||
],
|
||||
"subnet[1].pd-pool[0].total-pds": [
|
||||
[
|
||||
256,
|
||||
"2023-06-13 21:28:57.196741"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].assigned-nas": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196773"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].cumulative-assigned-nas": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196739"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196775"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196779"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196783"
|
||||
]
|
||||
],
|
||||
"subnet[1].pool[0].total-nas": [
|
||||
[
|
||||
281474976710656,
|
||||
"2023-06-13 21:28:57.196736"
|
||||
]
|
||||
],
|
||||
"subnet[1].reclaimed-declined-addresses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196766"
|
||||
]
|
||||
],
|
||||
"subnet[1].reclaimed-leases": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196770"
|
||||
]
|
||||
],
|
||||
"subnet[1].total-nas": [
|
||||
[
|
||||
281474976710656,
|
||||
"2023-06-13 21:28:57.196720"
|
||||
]
|
||||
],
|
||||
"subnet[1].total-pds": [
|
||||
[
|
||||
256,
|
||||
"2023-06-13 21:28:57.196724"
|
||||
]
|
||||
],
|
||||
"subnet[1].v6-ia-na-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196731"
|
||||
]
|
||||
],
|
||||
"subnet[1].v6-ia-pd-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.196733"
|
||||
]
|
||||
],
|
||||
"v6-allocation-fail": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177749"
|
||||
]
|
||||
],
|
||||
"v6-allocation-fail-classes": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177755"
|
||||
]
|
||||
],
|
||||
"v6-allocation-fail-no-pools": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177756"
|
||||
]
|
||||
],
|
||||
"v6-allocation-fail-shared-network": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177756"
|
||||
]
|
||||
],
|
||||
"v6-allocation-fail-subnet": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177757"
|
||||
]
|
||||
],
|
||||
"v6-ia-na-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177757"
|
||||
]
|
||||
],
|
||||
"v6-ia-pd-lease-reuses": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:28:57.177758"
|
||||
]
|
||||
]
|
||||
},
|
||||
"result": 0
|
||||
}
|
||||
|
||||
or
|
||||
|
||||
::
|
||||
|
||||
{
|
||||
"command": "statistic-get-all",
|
||||
"arguments": {
|
||||
"ncr-error": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627751"
|
||||
]
|
||||
],
|
||||
"ncr-invalid": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627749"
|
||||
]
|
||||
],
|
||||
"ncr-received": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627737"
|
||||
]
|
||||
],
|
||||
"update-error": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627759"
|
||||
]
|
||||
],
|
||||
"update-sent": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627752"
|
||||
]
|
||||
],
|
||||
"update-signed": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627753"
|
||||
]
|
||||
],
|
||||
"update-success": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627755"
|
||||
]
|
||||
],
|
||||
"update-timeout": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627757"
|
||||
]
|
||||
],
|
||||
"update-unsigned": [
|
||||
[
|
||||
0,
|
||||
"2023-06-13 21:42:54.627754"
|
||||
]
|
||||
]
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user