mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-29 13:07:50 +00:00
Code Issues Releases Wiki Activity

[#2883] added documentation for pool stats

Browse Source
This commit is contained in:
Razvan Becheriu 2023-06-13 20:36:20 +03:00
parent f5e92c69da
commit 3cd3de76a9
11 changed files with 2304 additions and 1072 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

201
doc/sphinx/arm/dhcp4-srv.rst
View File

@ -6719,15 +6719,15 @@ The DHCPv4 server supports the following statistics:
:widths: 20 10 70 :widths: 20 10 70
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| Statistic | Data Type | Description | | Statistic | Data Type | Description |
+==============================================+================+====================================+ +====================================================+================+====================================+
| pkt4-received | integer | Number of DHCPv4 packets received. | | pkt4-received | integer | Number of DHCPv4 packets received. |
| | | This includes all packets: valid, | | | | This includes all packets: valid, |
| | | bogus, corrupted, rejected, etc. | | | | bogus, corrupted, rejected, etc. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | rapidly. | | | | rapidly. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-discover-received | integer | Number of DHCPDISCOVER packets | | pkt4-discover-received | integer | Number of DHCPDISCOVER packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow; its increase | | | | expected to grow; its increase |
@ -6735,7 +6735,7 @@ The DHCPv4 server supports the following statistics:
| | | booted started their configuration | | | | booted started their configuration |
| | | process and their initial packets | | | | process and their initial packets |
| | | reached the Kea server. | | | | reached the Kea server. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-offer-received | integer | Number of DHCPOFFER packets | | pkt4-offer-received | integer | Number of DHCPOFFER packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain zero at all | | | | expected to remain zero at all |
@ -6748,7 +6748,7 @@ The DHCPv4 server supports the following statistics:
| | | incorrectly forwards DHCPOFFER | | | | incorrectly forwards DHCPOFFER |
| | | messages towards the server, | | | | messages towards the server, |
| | | rather than back to the clients. | | | | rather than back to the clients. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-request-received | integer | Number of DHCPREQUEST packets | | pkt4-request-received | integer | Number of DHCPREQUEST packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow. Its increase | | | | expected to grow. Its increase |
@ -6757,7 +6757,7 @@ The DHCPv4 server supports the following statistics:
| | | response (DHCPOFFER) and accepted | | | | response (DHCPOFFER) and accepted |
| | | it, and are now requesting an | | | | it, and are now requesting an |
| | | address (DHCPREQUEST). | | | | address (DHCPREQUEST). |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-ack-received | integer | Number of DHCPACK packets | | pkt4-ack-received | integer | Number of DHCPACK packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain zero at all | | | | expected to remain zero at all |
@ -6770,7 +6770,7 @@ The DHCPv4 server supports the following statistics:
| | | incorrectly forwards DHCPACK | | | | incorrectly forwards DHCPACK |
| | | messages towards the server, | | | | messages towards the server, |
| | | rather than back to the clients. | | | | rather than back to the clients. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-nak-received | integer | Number of DHCPNAK packets | | pkt4-nak-received | integer | Number of DHCPNAK packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain zero at all | | | | expected to remain zero at all |
@ -6783,14 +6783,14 @@ The DHCPv4 server supports the following statistics:
| | | incorrectly forwards DHCPNAK | | | | incorrectly forwards DHCPNAK |
| | | messages towards the server, | | | | messages towards the server, |
| | | rather than back to the clients. | | | | rather than back to the clients. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-release-received | integer | Number of DHCPRELEASE packets | | pkt4-release-received | integer | Number of DHCPRELEASE packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow. Its increase | | | | expected to grow. Its increase |
| | | means that clients that had an | | | | means that clients that had an |
| | | address are shutting down or | | | | address are shutting down or |
| | | ceasing to use their addresses. | | | | ceasing to use their addresses. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-decline-received | integer | Number of DHCPDECLINE packets | | pkt4-decline-received | integer | Number of DHCPDECLINE packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain close to zero. | | | | expected to remain close to zero. |
@ -6799,7 +6799,7 @@ The DHCPv4 server supports the following statistics:
| | | that the address is currently | | | | that the address is currently |
| | | used by an unknown device | | | | used by an unknown device |
| | | elsewhere in the network. | | | | elsewhere in the network. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-inform-received | integer | Number of DHCPINFORM packets | | pkt4-inform-received | integer | Number of DHCPINFORM packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow. Its increase | | | | expected to grow. Its increase |
@ -6809,7 +6809,7 @@ The DHCPv4 server supports the following statistics:
| | | interested only in getting | | | | interested only in getting |
| | | additional configuration | | | | additional configuration |
| | | parameters. | | | | parameters. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-unknown-received | integer | Number of packets received of an | | pkt4-unknown-received | integer | Number of packets received of an |
| | | unknown type. A non-zero value of | | | | unknown type. A non-zero value of |
| | | this statistic indicates that the | | | | this statistic indicates that the |
@ -6818,7 +6818,7 @@ The DHCPv4 server supports the following statistics:
| | | with an unsupported type or | | | | with an unsupported type or |
| | | possibly malformed (without a | | | | possibly malformed (without a |
| | | message-type option). | | | | message-type option). |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-sent | integer | Number of DHCPv4 packets sent. | | pkt4-sent | integer | Number of DHCPv4 packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | every time the server transmits a | | | | every time the server transmits a |
@ -6829,7 +6829,7 @@ The DHCPv4 server supports the following statistics:
| | | exceptions (e.g. DHCPRELEASE), so | | | | exceptions (e.g. DHCPRELEASE), so |
| | | do not worry if it is less than | | | | do not worry if it is less than |
| | | pkt4-received. | | | | pkt4-received. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-offer-sent | integer | Number of DHCPOFFER packets sent. | | pkt4-offer-sent | integer | Number of DHCPOFFER packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | in most cases after a DHCPDISCOVER | | | | in most cases after a DHCPDISCOVER |
@ -6839,7 +6839,7 @@ The DHCPv4 server supports the following statistics:
| | | dropped, but in general this | | | | dropped, but in general this |
| | | statistic is expected to be close | | | | statistic is expected to be close |
| | | to pkt4-discover-received. | | | | to pkt4-discover-received. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-ack-sent | integer | Number of DHCPACK packets sent. | | pkt4-ack-sent | integer | Number of DHCPACK packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | in most cases after a DHCPREQUEST | | | | in most cases after a DHCPREQUEST |
@ -6849,7 +6849,7 @@ The DHCPv4 server supports the following statistics:
| | | pkt4-ack-sent and pkt4-nak-sent | | | | pkt4-ack-sent and pkt4-nak-sent |
| | | should be close to | | | | should be close to |
| | | pkt4-request-received. | | | | pkt4-request-received. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-nak-sent | integer | Number of DHCPNAK packets sent. | | pkt4-nak-sent | integer | Number of DHCPNAK packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | when the server chooses not to | | | | when the server chooses not to |
@ -6858,7 +6858,7 @@ The DHCPv4 server supports the following statistics:
| | | pkt4-ack-sent and pkt4-nak-sent | | | | pkt4-ack-sent and pkt4-nak-sent |
| | | should be close to | | | | should be close to |
| | | pkt4-request-received. | | | | pkt4-request-received. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-parse-failed | integer | Number of incoming packets that | | pkt4-parse-failed | integer | Number of incoming packets that |
| | | could not be parsed. A non-zero | | | | could not be parsed. A non-zero |
| | | value of this statistic indicates | | | | value of this statistic indicates |
@ -6867,7 +6867,7 @@ The DHCPv4 server supports the following statistics:
| | | This may indicate problems in the | | | | This may indicate problems in the |
| | | network, faulty clients, or a bug | | | | network, faulty clients, or a bug |
| | | in the server. | | | | in the server. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-receive-drop | integer | Number of incoming packets that | | pkt4-receive-drop | integer | Number of incoming packets that |
| | | were dropped. The exact reason for | | | | were dropped. The exact reason for |
| | | dropping packets is logged, but | | | | dropping packets is logged, but |
@ -6877,28 +6877,46 @@ The DHCPv4 server supports the following statistics:
| | | forbidden, or the server-id sent | | | | forbidden, or the server-id sent |
| | | by the client does not match the | | | | by the client does not match the |
| | | server's server-id. | | | | server's server-id. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].total-addresses | integer | Total number of addresses | | subnet[id].total-addresses | integer | Total number of addresses |
| | | available for DHCPv4 management; | | | | available for DHCPv4 management |
| | | in other words, this is the sum of | | | | for a given subnet; in other |
| | | all addresses in all configured | | | | words, this is the sum of all |
| | | pools. This statistic changes only | | | | 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 | | | | during configuration updates. It |
| | | does not take into account any | | | | does not take into account any |
| | | addresses that may be reserved due | | | | addresses that may be reserved due |
| | | to host reservation. The *id* is | | | | to host reservation. The *id* is |
| | | the subnet-id of a given subnet. | | | | the subnet-id of a given subnet. |
| | | This statistic is exposed for each | | | | The *pid* is the pool-id of a |
| | | subnet separately, and is reset | | | | given pool. This statistic is |
| | | during a reconfiguration event. | | | | exposed for each subnet pool |
+----------------------------------------------+----------------+------------------------------------+ | | | separately, and is reset during a |
| | | reconfiguration event. |
+----------------------------------------------------+----------------+------------------------------------+
| cumulative-assigned-addresses | integer | Cumulative number of addresses | | cumulative-assigned-addresses | integer | Cumulative number of addresses |
| | | that have been assigned since | | | | that have been assigned since |
| | | server startup. It is incremented | | | | server startup. It is incremented |
| | | each time an address is assigned | | | | each time an address is assigned |
| | | and is not reset when the server | | | | and is not reset when the server |
| | | is reconfigured. | | | | is reconfigured. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].cumulative-assigned-addresses | integer | Cumulative number of assigned | | subnet[id].cumulative-assigned-addresses | integer | Cumulative number of assigned |
| | | addresses in a given subnet. It | | | | addresses in a given subnet. It |
| | | increases every time a new lease | | | | increases every time a new lease |
@ -6909,7 +6927,20 @@ The DHCPv4 server supports the following statistics:
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately, and is reset | | | | subnet separately, and is reset |
| | | during a reconfiguration event. | | | | 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 | | subnet[id].assigned-addresses | integer | Number of assigned addresses in a |
| | | given subnet. It increases every | | | | given subnet. It increases every |
| | | time a new lease is allocated (as | | | | time a new lease is allocated (as |
@ -6922,7 +6953,22 @@ The DHCPv4 server supports the following statistics:
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately, and is reset | | | | subnet separately, and is reset |
| | | during a reconfiguration event. | | | | 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 | | reclaimed-leases | integer | Number of expired leases that have |
| | | been reclaimed since server | | | | been reclaimed since server |
| | | startup. It is incremented each | | | | startup. It is incremented each |
@ -6932,18 +6978,28 @@ The DHCPv4 server supports the following statistics:
| | | how many actual leases have been | | | | how many actual leases have been |
| | | reclaimed. This is a global | | | | reclaimed. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].reclaimed-leases | integer | Number of expired leases | | subnet[id].reclaimed-leases | integer | Number of expired leases |
| | | associated with a given subnet | | | | associated with a given subnet |
| | | (*id* is the subnet-id) that have | | | | that have been reclaimed since |
| | | been reclaimed since server | | | | server startup. It is incremented |
| | | startup. It is incremented each | | | | each time an expired lease is |
| | | time an expired lease is |
| | | reclaimed. The *id* is the | | | | reclaimed. The *id* is the |
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | 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 | | declined-addresses | integer | Number of IPv4 addresses that are |
| | | currently declined; a count of the | | | | currently declined; a count of the |
| | | number of leases currently | | | | number of leases currently |
@ -6957,7 +7013,7 @@ The DHCPv4 server supports the following statistics:
| | | misbehaving device in the network. | | | | misbehaving device in the network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].declined-addresses | integer | Number of IPv4 addresses that are | | subnet[id].declined-addresses | integer | Number of IPv4 addresses that are |
| | | currently declined in a given | | | | currently declined in a given |
| | | subnet; a count of the number of | | | | subnet; a count of the number of |
@ -6973,7 +7029,24 @@ The DHCPv4 server supports the following statistics:
| | | the subnet-id of a given subnet. | | | | the subnet-id of a given subnet. |
| | | This statistic is exposed for each | | | | This statistic is exposed for each |
| | | subnet separately. | | | | 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 | | reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
| | | declined, but have now been | | | | declined, but have now been |
| | | recovered. Unlike | | | | recovered. Unlike |
@ -6984,7 +7057,7 @@ The DHCPv4 server supports the following statistics:
| | | processed and recovered from. This | | | | processed and recovered from. This |
| | | is a global statistic that covers | | | | is a global statistic that covers |
| | | all subnets. | | | | all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].reclaimed-declined-addresses | integer | Number of IPv4 addresses that were | | subnet[id].reclaimed-declined-addresses | integer | Number of IPv4 addresses that were |
| | | declined, but have now been | | | | declined, but have now been |
| | | recovered. Unlike | | | | recovered. Unlike |
@ -6996,27 +7069,41 @@ The DHCPv4 server supports the following statistics:
| | | *id* is the subnet-id of a given | | | | *id* is the subnet-id of a given |
| | | subnet. This statistic is exposed | | | | subnet. This statistic is exposed |
| | | for each subnet separately. | | | | 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 | | pkt4-lease-query-received | integer | Number of IPv4 DHCPLEASEQUERY |
| | | packets received. (Only exists if | | | | packets received. (Only exists if |
| | | Leasequery hook library is | | | | Leasequery hook library is |
| | | loaded.) | | | | loaded.) |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-lease-query-response-unknown-sent | integer | Number of IPv4 DHCPLEASEUNKNOWN | | pkt4-lease-query-response-unknown-sent | integer | Number of IPv4 DHCPLEASEUNKNOWN |
| | | responses sent. (Only exists if | | | | responses sent. (Only exists if |
| | | Leasequery hook library is | | | | Leasequery hook library is |
| | | loaded.) | | | | loaded.) |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-lease-query-response-unassigned-sent | integer | Number of IPv4 DHCPLEASEUNASSIGNED | | pkt4-lease-query-response-unassigned-sent | integer | Number of IPv4 DHCPLEASEUNASSIGNED |
| | | responses sent. (Only exists if | | | | responses sent. (Only exists if |
| | | Leasequery hook library is | | | | Leasequery hook library is |
| | | loaded.) | | | | loaded.) |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| pkt4-lease-query-response-active-sent | integer | Number of IPv4 DHCPLEASEACTIVE | | pkt4-lease-query-response-active-sent | integer | Number of IPv4 DHCPLEASEACTIVE |
| | | responses sent. (Only exists if | | | | responses sent. (Only exists if |
| | | Leasequery hook library is | | | | Leasequery hook library is |
| | | loaded.) | | | | loaded.) |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-allocation-fail | integer | Number of total address allocation | | v4-allocation-fail | integer | Number of total address allocation |
| | | failures for a particular client. | | | | failures for a particular client. |
| | | This consists in the number of | | | | This consists in the number of |
@ -7025,7 +7112,7 @@ The DHCPv4 server supports the following statistics:
| | | was unable to use any of the | | | | was unable to use any of the |
| | | address pools. This is a global | | | | address pools. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-allocation-fail | integer | Number of total address allocation | | subnet[id].v4-allocation-fail | integer | Number of total address allocation |
| | | failures for a particular client. | | | | failures for a particular client. |
| | | This consists in the number of | | | | This consists in the number of |
@ -7036,13 +7123,13 @@ The DHCPv4 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-allocation-fail-shared-network | integer | Number of address allocation | | v4-allocation-fail-shared-network | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a shared network. | | | | connected to a shared network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-allocation-fail-shared-network | integer | Number of address allocation | | subnet[id].v4-allocation-fail-shared-network | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a shared network. | | | | connected to a shared network. |
@ -7050,14 +7137,14 @@ The DHCPv4 server supports the following statistics:
| | | given subnet. This statistic is | | | | given subnet. This statistic is |
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately. | | | | separately. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-allocation-fail-subnet | integer | Number of address allocation | | v4-allocation-fail-subnet | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a subnet that does | | | | connected to a subnet that does |
| | | not belong to a shared network. | | | | not belong to a shared network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-allocation-fail-subnet | integer | Number of address allocation | | subnet[id].v4-allocation-fail-subnet | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a subnet that does | | | | connected to a subnet that does |
@ -7066,7 +7153,7 @@ The DHCPv4 server supports the following statistics:
| | | given subnet. This statistic is | | | | given subnet. This statistic is |
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately. | | | | separately. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-allocation-fail-no-pools | integer | Number of address allocation | | v4-allocation-fail-no-pools | integer | Number of address allocation |
| | | failures because the server could | | | | failures because the server could |
| | | not use any configured pools for | | | | not use any configured pools for |
@ -7080,7 +7167,7 @@ The DHCPv4 server supports the following statistics:
| | | should be assigned dynamic | | | | should be assigned dynamic |
| | | addresses. This is a global | | | | addresses. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-allocation-fail-no-pools | integer | Number of address allocation | | subnet[id].v4-allocation-fail-no-pools | integer | Number of address allocation |
| | | failures because the server could | | | | failures because the server could |
| | | not use any configured pools for | | | | not use any configured pools for |
@ -7096,7 +7183,7 @@ The DHCPv4 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-allocation-fail-classes | integer | Number of address allocation | | v4-allocation-fail-classes | integer | Number of address allocation |
| | | failures when the client's packet | | | | failures when the client's packet |
| | | belongs to one or more classes. | | | | belongs to one or more classes. |
@ -7112,7 +7199,7 @@ The DHCPv4 server supports the following statistics:
| | | to a given class has ran out of | | | | to a given class has ran out of |
| | | addresses. This is a global | | | | addresses. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-allocation-fail-classes | integer | Number of address allocation | | subnet[id].v4-allocation-fail-classes | integer | Number of address allocation |
| | | failures when the client's packet | | | | failures when the client's packet |
| | | belongs to one or more classes. | | | | belongs to one or more classes. |
@ -7130,7 +7217,7 @@ The DHCPv4 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-lease-reuses | integer | Number of times an IPv4 lease had | | v4-lease-reuses | integer | Number of times an IPv4 lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -7138,7 +7225,7 @@ The DHCPv4 server supports the following statistics:
| | | the lease caching feature. This is | | | | the lease caching feature. This is |
| | | referred to as a lease reuse. | | | | referred to as a lease reuse. |
| | | This statistic is global. | | | | This statistic is global. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-lease-reuses | integer | Number of times an IPv4 lease had | | subnet[id].v4-lease-reuses | integer | Number of times an IPv4 lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -7148,7 +7235,7 @@ The DHCPv4 server supports the following statistics:
| | | This statistic is on a per-subnet | | | | This statistic is on a per-subnet |
| | | basis. The *id* is the subnet-id | | | | basis. The *id* is the subnet-id |
| | | of a given subnet. | | | | of a given subnet. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| v4-reservation-conflicts | integer | Number of host reservation | | v4-reservation-conflicts | integer | Number of host reservation |
| | | allocation conflicts which have | | | | allocation conflicts which have |
| | | occurred across every subnet. When | | | | occurred across every subnet. When |
@ -7157,7 +7244,7 @@ The DHCPv4 server supports the following statistics:
| | | which is already leased to another | | | | which is already leased to another |
| | | client, this counter is increased | | | | client, this counter is increased |
| | | by 1. | | | | by 1. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
| subnet[id].v4-reservation-conflicts | integer | Number of host reservation | | subnet[id].v4-reservation-conflicts | integer | Number of host reservation |
| | | allocation conflicts which have | | | | allocation conflicts which have |
| | | occurred in a specific subnet. | | | | occurred in a specific subnet. |
@ -7166,7 +7253,7 @@ The DHCPv4 server supports the following statistics:
| | | reservation which is already | | | | reservation which is already |
| | | leased to another client, this | | | | leased to another client, this |
| | | counter is increased by 1. | | | | counter is increased by 1. |
+----------------------------------------------+----------------+------------------------------------+ +----------------------------------------------------+----------------+------------------------------------+
.. note:: .. note::

257
doc/sphinx/arm/dhcp6-srv.rst
View File

@ -6389,15 +6389,15 @@ The DHCPv6 server supports the following statistics:
:widths: 20 10 70 :widths: 20 10 70
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| Statistic | Data Type | Description | | Statistic | Data Type | Description |
+==============================================+================+====================================+ +===================================================+================+====================================+
| pkt6-received | integer | Number of DHCPv6 packets received. | | pkt6-received | integer | Number of DHCPv6 packets received. |
| | | This includes all packets: valid, | | | | This includes all packets: valid, |
| | | bogus, corrupted, rejected, etc. | | | | bogus, corrupted, rejected, etc. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | rapidly. | | | | rapidly. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-receive-drop | integer | Number of incoming packets that | | pkt6-receive-drop | integer | Number of incoming packets that |
| | | were dropped. The exact reason for | | | | were dropped. The exact reason for |
| | | dropping packets is logged, but | | | | dropping packets is logged, but |
@ -6408,7 +6408,7 @@ The DHCPv6 server supports the following statistics:
| | | server-id sent by the client does | | | | server-id sent by the client does |
| | | not match the server's server-id, | | | | not match the server's server-id, |
| | | or the packet is malformed. | | | | or the packet is malformed. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-parse-failed | integer | Number of incoming packets that | | pkt6-parse-failed | integer | Number of incoming packets that |
| | | could not be parsed. A non-zero | | | | could not be parsed. A non-zero |
| | | value of this statistic indicates | | | | value of this statistic indicates |
@ -6418,7 +6418,7 @@ The DHCPv6 server supports the following statistics:
| | | network, faulty clients, faulty | | | | network, faulty clients, faulty |
| | | relay agents, or a bug in the | | | | relay agents, or a bug in the |
| | | server. | | | | server. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-solicit-received | integer | Number of SOLICIT packets | | pkt6-solicit-received | integer | Number of SOLICIT packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow; its increase | | | | expected to grow; its increase |
@ -6426,7 +6426,7 @@ The DHCPv6 server supports the following statistics:
| | | booted started their configuration | | | | booted started their configuration |
| | | process and their initial packets | | | | process and their initial packets |
| | | reached the Kea server. | | | | reached the Kea server. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-advertise-received | integer | Number of ADVERTISE packets | | pkt6-advertise-received | integer | Number of ADVERTISE packets |
| | | received. ADVERTISE packets are | | | | received. ADVERTISE packets are |
| | | sent by the server and the server | | | | sent by the server and the server |
@ -6439,7 +6439,7 @@ The DHCPv6 server supports the following statistics:
| | | ADVERTISE messages towards the | | | | ADVERTISE messages towards the |
| | | server, rather than back to the | | | | server, rather than back to the |
| | | clients. | | | | clients. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-request-received | integer | Number of DHCPREQUEST packets | | pkt6-request-received | integer | Number of DHCPREQUEST packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow. Its increase | | | | expected to grow. Its increase |
@ -6449,7 +6449,7 @@ The DHCPv6 server supports the following statistics:
| | | accepted it, and are now | | | | accepted it, and are now |
| | | requesting an address | | | | requesting an address |
| | | (DHCPREQUEST). | | | | (DHCPREQUEST). |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-reply-received | integer | Number of REPLY packets received. | | pkt6-reply-received | integer | Number of REPLY packets received. |
| | | This statistic is expected to | | | | This statistic is expected to |
| | | remain zero at all times, as REPLY | | | | remain zero at all times, as REPLY |
@ -6461,14 +6461,14 @@ The DHCPv6 server supports the following statistics:
| | | agent that incorrectly forwards | | | | agent that incorrectly forwards |
| | | REPLY messages towards the server, | | | | REPLY messages towards the server, |
| | | rather than back to the clients. | | | | rather than back to the clients. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-renew-received | integer | Number of RENEW packets received. | | pkt6-renew-received | integer | Number of RENEW packets received. |
| | | This statistic is expected to | | | | This statistic is expected to |
| | | grow; its increase means that | | | | grow; its increase means that |
| | | clients received their addresses | | | | clients received their addresses |
| | | and prefixes and are trying to | | | | and prefixes and are trying to |
| | | renew them. | | | | renew them. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-rebind-received | integer | Number of REBIND packets received. | | pkt6-rebind-received | integer | Number of REBIND packets received. |
| | | A non-zero value indicates that | | | | A non-zero value indicates that |
| | | clients did not receive responses | | | | clients did not receive responses |
@ -6480,7 +6480,7 @@ The DHCPv6 server supports the following statistics:
| | | mean that some servers' REPLY | | | | mean that some servers' REPLY |
| | | messages never reached the | | | | messages never reached the |
| | | clients. | | | | clients. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-release-received | integer | Number of RELEASE packets | | pkt6-release-received | integer | Number of RELEASE packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow when a device is | | | | expected to grow when a device is |
@ -6492,7 +6492,7 @@ The DHCPv6 server supports the following statistics:
| | | not send RELEASE packets either | | | | not send RELEASE packets either |
| | | because of design choice or due to | | | | because of design choice or due to |
| | | the client moving out of range. | | | | the client moving out of range. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-decline-received | integer | Number of DECLINE packets | | pkt6-decline-received | integer | Number of DECLINE packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain close to zero. | | | | expected to remain close to zero. |
@ -6505,7 +6505,7 @@ The DHCPv6 server supports the following statistics:
| | | misconfigured server or devices | | | | misconfigured server or devices |
| | | that have statically assigned | | | | that have statically assigned |
| | | conflicting addresses. | | | | conflicting addresses. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-infrequest-received | integer | Number of INFORMATION-REQUEST | | pkt6-infrequest-received | integer | Number of INFORMATION-REQUEST |
| | | packets received. This statistic | | | | packets received. This statistic |
| | | is expected to grow if there are | | | | is expected to grow if there are |
@ -6515,7 +6515,7 @@ The DHCPv6 server supports the following statistics:
| | | request stateless configuration, | | | | request stateless configuration, |
| | | i.e. options and parameters other | | | | i.e. options and parameters other |
| | | than addresses or prefixes. | | | | than addresses or prefixes. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-dhcpv4-query-received | integer | Number of DHCPv4-QUERY packets | | pkt6-dhcpv4-query-received | integer | Number of DHCPv4-QUERY packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to grow if there are | | | | expected to grow if there are |
@ -6525,7 +6525,7 @@ The DHCPv6 server supports the following statistics:
| | | clients on an IPv6-only line which | | | | clients on an IPv6-only line which |
| | | encapsulates the requests over | | | | encapsulates the requests over |
| | | DHCPv6. | | | | DHCPv6. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-dhcpv4-response-received | integer | Number of DHCPv4-RESPONSE packets | | pkt6-dhcpv4-response-received | integer | Number of DHCPv4-RESPONSE packets |
| | | received. This statistic is | | | | received. This statistic is |
| | | expected to remain zero at all | | | | expected to remain zero at all |
@ -6539,7 +6539,7 @@ The DHCPv6 server supports the following statistics:
| | | DHCPv4-RESPONSE message towards | | | | DHCPv4-RESPONSE message towards |
| | | the server rather than back to the | | | | the server rather than back to the |
| | | clients. | | | | clients. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-unknown-received | integer | Number of packets received of an | | pkt6-unknown-received | integer | Number of packets received of an |
| | | unknown type. A non-zero value of | | | | unknown type. A non-zero value of |
| | | this statistic indicates that the | | | | this statistic indicates that the |
@ -6547,7 +6547,7 @@ The DHCPv6 server supports the following statistics:
| | | was unable to recognize; either it | | | | was unable to recognize; either it |
| | | had an unsupported type or was | | | | had an unsupported type or was |
| | | possibly malformed. | | | | possibly malformed. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-sent | integer | Number of DHCPv6 packets sent. | | pkt6-sent | integer | Number of DHCPv6 packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | every time the server transmits a | | | | every time the server transmits a |
@ -6559,7 +6559,7 @@ The DHCPv6 server supports the following statistics:
| | | a REQUEST with server-id matching | | | | a REQUEST with server-id matching |
| | | another server), so do not worry | | | | another server), so do not worry |
| | | if it is less than pkt6-received. | | | | if it is less than pkt6-received. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-advertise-sent | integer | Number of ADVERTISE packets sent. | | pkt6-advertise-sent | integer | Number of ADVERTISE packets sent. |
| | | This statistic is expected to grow | | | | This statistic is expected to grow |
| | | in most cases after a SOLICIT is | | | | in most cases after a SOLICIT is |
@ -6569,7 +6569,7 @@ The DHCPv6 server supports the following statistics:
| | | dropped, but in general this | | | | dropped, but in general this |
| | | statistic is expected to be close | | | | statistic is expected to be close |
| | | to pkt6-solicit-received. | | | | to pkt6-solicit-received. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-reply-sent | integer | Number of REPLY packets sent. This | | pkt6-reply-sent | integer | Number of REPLY packets sent. This |
| | | statistic is expected to grow in | | | | statistic is expected to grow in |
| | | most cases after a SOLICIT (with | | | | most cases after a SOLICIT (with |
@ -6578,36 +6578,53 @@ The DHCPv6 server supports the following statistics:
| | | INFORMATION-REQUEST is processed. | | | | INFORMATION-REQUEST is processed. |
| | | There are certain cases where | | | | There are certain cases where |
| | | there is no response. | | | | there is no response. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| pkt6-dhcpv4-response-sent | integer | Number of DHCPv4-RESPONSE packets | | pkt6-dhcpv4-response-sent | integer | Number of DHCPv4-RESPONSE packets |
| | | sent. This statistic is expected | | | | sent. This statistic is expected |
| | | to grow in most cases after a | | | | to grow in most cases after a |
| | | DHCPv4-QUERY is processed. There | | | | DHCPv4-QUERY is processed. There |
| | | are certain cases where there is | | | | are certain cases where there is |
| | | no response. | | | | no response. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].total-nas | big integer | Total number of NA addresses | | subnet[id].total-nas | big integer | Total number of NA addresses |
| | | available for DHCPv6 management | | | | available for DHCPv6 management |
| | | for a given subnet; in other | | | | for a given subnet; in other |
| | | words, this is the sum of all | | | | words, this is the sum of all |
| | | addresses in all configured pools. | | | | addresses in all configured pools. |
| | | This statistic changes only during | | | | This statistic changes only during |
| | | configuration changes. Note that | | | | configuration changes. It does not |
| | | it does not take into account any | | | | 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. |
+---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].total-nas | big integer | Total number of NA addresses |
| | | available for DHCPv6 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 changes. It |
| | | does not take into account any |
| | | addresses that may be reserved due | | | | addresses that may be reserved due |
| | | to host reservation. The *id* is | | | | to host reservation. The *id* is |
| | | the subnet-id of a given subnet. | | | | the subnet-id of a given subnet. |
| | | This statistic is exposed for each | | | | The *pid* is the pool-id of a |
| | | subnet separately, and is reset | | | | given pool. This statistic is |
| | | during a reconfiguration event. | | | | exposed for each subnet pool |
+----------------------------------------------+----------------+------------------------------------+ | | | separately, and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| cumulative-assigned-nas | integer | Cumulative number of NA addresses | | cumulative-assigned-nas | integer | Cumulative number of NA addresses |
| | | that have been assigned since | | | | that have been assigned since |
| | | server startup. It is incremented | | | | server startup. It is incremented |
| | | each time a NA address is assigned | | | | each time a NA address is assigned |
| | | and is not reset when the server | | | | and is not reset when the server |
| | | is reconfigured. | | | | is reconfigured. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].cumulative-assigned-nas | integer | Cumulative number of NA addresses | | subnet[id].cumulative-assigned-nas | integer | Cumulative number of NA addresses |
| | | in a given subnet that were | | | | in a given subnet that were |
| | | assigned. It increases every time | | | | assigned. It increases every time |
@ -6619,7 +6636,21 @@ The DHCPv6 server supports the following statistics:
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately, and is reset during a | | | | separately, and is reset during a |
| | | reconfiguration event. | | | | reconfiguration event. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].cumulative-assigned-nas | integer | Cumulative number of NA addresses |
| | | in a given subnet pool that were |
| | | assigned. It increases every time |
| | | a new lease is allocated (as a |
| | | result of receiving a REQUEST |
| | | message) and is never decreased. |
| | | 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. |
+---------------------------------------------------+----------------+------------------------------------+
| subnet[id].assigned-nas | integer | Number of NA addresses in a given | | subnet[id].assigned-nas | integer | Number of NA addresses in a given |
| | | subnet that are assigned. It | | | | subnet that are assigned. It |
| | | increases every time a new lease | | | | increases every time a new lease |
@ -6632,7 +6663,22 @@ The DHCPv6 server supports the following statistics:
| | | This statistic is exposed for each | | | | This statistic is exposed for each |
| | | subnet separately, and is reset | | | | subnet separately, and is reset |
| | | during a reconfiguration event. | | | | during a reconfiguration event. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].assigned-nas | integer | Number of NA addresses in a given |
| | | subnet pool that are assigned. It |
| | | increases every time a new lease |
| | | is allocated (as a result of |
| | | receiving a REQUEST message) and |
| | | is decreased every time a lease is |
| | | released (a RELEASE message is |
| | | received) or expires. 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, |
| | | and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| subnet[id].total-pds | big integer | Total number of PD prefixes | | subnet[id].total-pds | big integer | Total number of PD prefixes |
| | | available for DHCPv6 management | | | | available for DHCPv6 management |
| | | for a given subnet; in other | | | | for a given subnet; in other |
@ -6647,14 +6693,31 @@ The DHCPv6 server supports the following statistics:
| | | This statistic is exposed for each | | | | This statistic is exposed for each |
| | | subnet separately, and is reset | | | | subnet separately, and is reset |
| | | during a reconfiguration event. | | | | during a reconfiguration event. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pd-pool[pid].total-pds | big integer | Total number of PD prefixes |
| | | available for DHCPv6 management |
| | | for a given subnet pool; in other |
| | | words, this is the sum of all |
| | | prefixes in configured subnet |
| | | pd-pool. This statistic changes |
| | | only during configuration changes. |
| | | It does not take into account any |
| | | prefixes 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 pd-pool |
| | | separately, and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| cumulative-assigned-pds | integer | Cumulative number of PD prefixes | | cumulative-assigned-pds | integer | Cumulative number of PD prefixes |
| | | that have been assigned since | | | | that have been assigned since |
| | | server startup. It is incremented | | | | server startup. It is incremented |
| | | each time a PD prefix is assigned | | | | each time a PD prefix is assigned |
| | | and is not reset when the server | | | | and is not reset when the server |
| | | is reconfigured. | | | | is reconfigured. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].cumulative-assigned-pds | integer | Cumulative number of PD prefixes | | subnet[id].cumulative-assigned-pds | integer | Cumulative number of PD prefixes |
| | | in a given subnet that were | | | | in a given subnet that were |
| | | assigned. It increases every time | | | | assigned. It increases every time |
@ -6666,7 +6729,21 @@ The DHCPv6 server supports the following statistics:
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately, and is reset during a | | | | separately, and is reset during a |
| | | reconfiguration event. | | | | reconfiguration event. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pd-pool[pid].cumulative-assigned-pds | integer | Cumulative number of PD prefixes |
| | | in a given subnet pd-pool that |
| | | were assigned. It increases every |
| | | time a new lease is allocated (as |
| | | a result of receiving a REQUEST |
| | | message) and is never decreased. |
| | | The *id* is the subnet-id of a |
| | | given subnet. The *pid* is the |
| | | pool-id of a given pd-pool. This |
| | | statistic is exposed for each |
| | | subnet pd-pool separately, and is |
| | | reset during a reconfiguration |
| | | event. |
+---------------------------------------------------+----------------+------------------------------------+
| subnet[id].assigned-pds | integer | Number of PD prefixes in a given | | subnet[id].assigned-pds | integer | Number of PD prefixes in a given |
| | | subnet that are assigned. It | | | | subnet that are assigned. It |
| | | increases every time a new lease | | | | increases every time a new lease |
@ -6679,7 +6756,22 @@ The DHCPv6 server supports the following statistics:
| | | This statistic is exposed for each | | | | This statistic is exposed for each |
| | | subnet separately, and is reset | | | | subnet separately, and is reset |
| | | during a reconfiguration event. | | | | during a reconfiguration event. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pd-pool[pid].assigned-pds | integer | Number of PD prefixes in a given |
| | | subnet pd-pool that are assigned. |
| | | It increases every time a new |
| | | lease is allocated (as a result of |
| | | receiving a REQUEST message) and |
| | | is decreased every time a lease is |
| | | released (a RELEASE message is |
| | | received) or expires. The *id* is |
| | | the subnet-id of a given subnet. |
| | | The *pid* is the pool-id of the |
| | | pd-pool. This statistic is exposed |
| | | for each subnet pd-pool |
| | | separately, and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| reclaimed-leases | integer | Number of expired leases that have | | reclaimed-leases | integer | Number of expired leases that have |
| | | been reclaimed since server | | | | been reclaimed since server |
| | | startup. It is incremented each | | | | startup. It is incremented each |
@ -6691,7 +6783,7 @@ The DHCPv6 server supports the following statistics:
| | | actual leases have been reclaimed. | | | | actual leases have been reclaimed. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].reclaimed-leases | integer | Number of expired leases | | subnet[id].reclaimed-leases | integer | Number of expired leases |
| | | associated with a given subnet | | | | associated with a given subnet |
| | | that have been reclaimed since | | | | that have been reclaimed since |
@ -6702,7 +6794,33 @@ The DHCPv6 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].reclaimed-leases | integer | Number of expired NA addresses |
| | | 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, |
| | | and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pd-pool[pid].reclaimed-leases | integer | Number of expired PD prefixes |
| | | associated with a given subnet |
| | | pd-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 |
| | | pd-pool. This statistic is exposed |
| | | for each subnet pd-pool |
| | | separately, and is reset during a |
| | | reconfiguration event. |
+---------------------------------------------------+----------------+------------------------------------+
| declined-addresses | integer | Number of IPv6 addresses that are | | declined-addresses | integer | Number of IPv6 addresses that are |
| | | currently declined; a count of the | | | | currently declined; a count of the |
| | | number of leases currently | | | | number of leases currently |
@ -6716,7 +6834,7 @@ The DHCPv6 server supports the following statistics:
| | | misbehaving device in the network. | | | | misbehaving device in the network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].declined-addresses | integer | Number of IPv6 addresses that are | | subnet[id].declined-addresses | integer | Number of IPv6 addresses that are |
| | | currently declined in a given | | | | currently declined in a given |
| | | subnet; a count of the number of | | | | subnet; a count of the number of |
@ -6732,7 +6850,24 @@ The DHCPv6 server supports the following statistics:
| | | the subnet-id of a given subnet. | | | | the subnet-id of a given subnet. |
| | | This statistic is exposed for each | | | | This statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].declined-addresses | integer | Number of IPv6 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 will be 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 IPv6 addresses that were | | reclaimed-declined-addresses | integer | Number of IPv6 addresses that were |
| | | declined, but have now been | | | | declined, but have now been |
| | | recovered. Unlike | | | | recovered. Unlike |
@ -6743,7 +6878,7 @@ The DHCPv6 server supports the following statistics:
| | | processed and recovered from. This | | | | processed and recovered from. This |
| | | is a global statistic that covers | | | | is a global statistic that covers |
| | | all subnets. | | | | all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].reclaimed-declined-addresses | integer | Number of IPv6 addresses that were | | subnet[id].reclaimed-declined-addresses | integer | Number of IPv6 addresses that were |
| | | declined, but have now been | | | | declined, but have now been |
| | | recovered. Unlike | | | | recovered. Unlike |
@ -6755,7 +6890,21 @@ The DHCPv6 server supports the following statistics:
| | | *id* is the subnet-id of a given | | | | *id* is the subnet-id of a given |
| | | subnet. This statistic is exposed | | | | subnet. This statistic is exposed |
| | | for each subnet separately. | | | | for each subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].pool[pid].reclaimed-declined-addresses | integer | Number of IPv6 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. |
+---------------------------------------------------+----------------+------------------------------------+
| v6-allocation-fail | integer | Number of total address allocation | | v6-allocation-fail | integer | Number of total address allocation |
| | | failures for a particular client. | | | | failures for a particular client. |
| | | This consists in the number of | | | | This consists in the number of |
@ -6764,7 +6913,7 @@ The DHCPv6 server supports the following statistics:
| | | was unable to use any of the | | | | was unable to use any of the |
| | | address pools. This is a global | | | | address pools. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-allocation-fail | integer | Number of total address allocation | | subnet[id].v6-allocation-fail | integer | Number of total address allocation |
| | | failures for a particular client. | | | | failures for a particular client. |
| | | This consists in the number of | | | | This consists in the number of |
@ -6775,13 +6924,13 @@ The DHCPv6 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-allocation-fail-shared-network | integer | Number of address allocation | | v6-allocation-fail-shared-network | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a shared network. | | | | connected to a shared network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-allocation-fail-shared-network | integer | Number of address allocation | | subnet[id].v6-allocation-fail-shared-network | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a shared network. | | | | connected to a shared network. |
@ -6789,14 +6938,14 @@ The DHCPv6 server supports the following statistics:
| | | given subnet. This statistic is | | | | given subnet. This statistic is |
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately. | | | | separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-allocation-fail-subnet | integer | Number of address allocation | | v6-allocation-fail-subnet | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a subnet that does | | | | connected to a subnet that does |
| | | not belong to a shared network. | | | | not belong to a shared network. |
| | | This is a global statistic that | | | | This is a global statistic that |
| | | covers all subnets. | | | | covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-allocation-fail-subnet | integer | Number of address allocation | | subnet[id].v6-allocation-fail-subnet | integer | Number of address allocation |
| | | failures for a particular client | | | | failures for a particular client |
| | | connected to a subnet that does | | | | connected to a subnet that does |
@ -6805,7 +6954,7 @@ The DHCPv6 server supports the following statistics:
| | | given subnet. This statistic is | | | | given subnet. This statistic is |
| | | exposed for each subnet | | | | exposed for each subnet |
| | | separately. | | | | separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-allocation-fail-no-pools | integer | Number of address allocation | | v6-allocation-fail-no-pools | integer | Number of address allocation |
| | | failures because the server could | | | | failures because the server could |
| | | not use any configured pools for | | | | not use any configured pools for |
@ -6819,7 +6968,7 @@ The DHCPv6 server supports the following statistics:
| | | should be assigned dynamic | | | | should be assigned dynamic |
| | | addresses. This is a global | | | | addresses. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-allocation-fail-no-pools | integer | Number of address allocation | | subnet[id].v6-allocation-fail-no-pools | integer | Number of address allocation |
| | | failures because the server could | | | | failures because the server could |
| | | not use any configured pools for | | | | not use any configured pools for |
@ -6835,7 +6984,7 @@ The DHCPv6 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-allocation-fail-classes | integer | Number of address allocation | | v6-allocation-fail-classes | integer | Number of address allocation |
| | | failures when the client's packet | | | | failures when the client's packet |
| | | belongs to one or more classes. | | | | belongs to one or more classes. |
@ -6851,7 +7000,7 @@ The DHCPv6 server supports the following statistics:
| | | to a given class has ran out of | | | | to a given class has ran out of |
| | | addresses. This is a global | | | | addresses. This is a global |
| | | statistic that covers all subnets. | | | | statistic that covers all subnets. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-allocation-fail-classes | integer | Number of address allocation | | subnet[id].v6-allocation-fail-classes | integer | Number of address allocation |
| | | failures when the client's packet | | | | failures when the client's packet |
| | | belongs to one or more classes. | | | | belongs to one or more classes. |
@ -6869,7 +7018,7 @@ The DHCPv6 server supports the following statistics:
| | | subnet-id of a given subnet. This | | | | subnet-id of a given subnet. This |
| | | statistic is exposed for each | | | | statistic is exposed for each |
| | | subnet separately. | | | | subnet separately. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-ia-na-lease-reuses | integer | Number of times an IA_NA lease had | | v6-ia-na-lease-reuses | integer | Number of times an IA_NA lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -6877,7 +7026,7 @@ The DHCPv6 server supports the following statistics:
| | | the lease caching feature. This is | | | | the lease caching feature. This is |
| | | referred to as a lease reuse. | | | | referred to as a lease reuse. |
| | | This statistic is global. | | | | This statistic is global. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-ia-na-lease-reuses | integer | Number of times an IA_NA lease had | | subnet[id].v6-ia-na-lease-reuses | integer | Number of times an IA_NA lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -6887,7 +7036,7 @@ The DHCPv6 server supports the following statistics:
| | | This statistic is on a per-subnet | | | | This statistic is on a per-subnet |
| | | basis. The *id* is the subnet-id | | | | basis. The *id* is the subnet-id |
| | | of a given subnet. | | | | of a given subnet. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| v6-ia-pd-lease-reuses | integer | Number of times an IA_PD lease had | | v6-ia-pd-lease-reuses | integer | Number of times an IA_PD lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -6895,7 +7044,7 @@ The DHCPv6 server supports the following statistics:
| | | the lease caching feature. This is | | | | the lease caching feature. This is |
| | | referred to as a lease reuse. | | | | referred to as a lease reuse. |
| | | This statistic is global. | | | | This statistic is global. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
| subnet[id].v6-ia-pd-lease-reuses | integer | Number of times an IA_PD lease had | | subnet[id].v6-ia-pd-lease-reuses | integer | Number of times an IA_PD lease had |
| | | its CLTT increased in memory and | | | | its CLTT increased in memory and |
| | | its expiration time left unchanged | | | | its expiration time left unchanged |
@ -6905,7 +7054,7 @@ The DHCPv6 server supports the following statistics:
| | | This statistic is on a per-subnet | | | | This statistic is on a per-subnet |
| | | basis. The *id* is the subnet-id | | | | basis. The *id* is the subnet-id |
| | | of a given subnet. | | | | of a given subnet. |
+----------------------------------------------+----------------+------------------------------------+ +---------------------------------------------------+----------------+------------------------------------+
.. note:: .. note::

496
doc/sphinx/arm/stats.rst
View File

@ -233,211 +233,635 @@ Here is an example response returning all collected statistics:
"cumulative-assigned-addresses": [ "cumulative-assigned-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487569" "2023-06-13 20:42:46.836166"
] ]
], ],
"declined-addresses": [ "declined-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487555" "2023-06-13 20:42:46.836156"
] ]
], ],
"pkt4-ack-received": [ "pkt4-ack-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455233" "2023-06-13 20:42:46.616247"
] ]
], ],
"pkt4-ack-sent": [ "pkt4-ack-sent": [
[ [
0, 0,
"2022-02-11 17:54:17.455256" "2023-06-13 20:42:46.616290"
] ]
], ],
"pkt4-decline-received": [ "pkt4-decline-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455259" "2023-06-13 20:42:46.616296"
] ]
], ],
"pkt4-discover-received": [ "pkt4-discover-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455263" "2023-06-13 20:42:46.616303"
] ]
], ],
"pkt4-inform-received": [ "pkt4-inform-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455265" "2023-06-13 20:42:46.616308"
] ]
], ],
"pkt4-nak-received": [ "pkt4-nak-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455269" "2023-06-13 20:42:46.616312"
] ]
], ],
"pkt4-nak-sent": [ "pkt4-nak-sent": [
[ [
0, 0,
"2022-02-11 17:54:17.455271" "2023-06-13 20:42:46.616314"
] ]
], ],
"pkt4-offer-received": [ "pkt4-offer-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455274" "2023-06-13 20:42:46.616318"
] ]
], ],
"pkt4-offer-sent": [ "pkt4-offer-sent": [
[ [
0, 0,
"2022-02-11 17:54:17.455277" "2023-06-13 20:42:46.616323"
] ]
], ],
"pkt4-parse-failed": [ "pkt4-parse-failed": [
[ [
0, 0,
"2022-02-11 17:54:17.455280" "2023-06-13 20:42:46.616326"
] ]
], ],
"pkt4-receive-drop": [ "pkt4-receive-drop": [
[ [
0, 0,
"2022-02-11 17:54:17.455284" "2023-06-13 20:42:46.616330"
] ]
], ],
"pkt4-received": [ "pkt4-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455287" "2023-06-13 20:42:46.616335"
] ]
], ],
"pkt4-release-received": [ "pkt4-release-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455290" "2023-06-13 20:42:46.616339"
] ]
], ],
"pkt4-request-received": [ "pkt4-request-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455293" "2023-06-13 20:42:46.616343"
] ]
], ],
"pkt4-sent": [ "pkt4-sent": [
[ [
0, 0,
"2022-02-11 17:54:17.455296" "2023-06-13 20:42:46.616348"
] ]
], ],
"pkt4-unknown-received": [ "pkt4-unknown-received": [
[ [
0, 0,
"2022-02-11 17:54:17.455299" "2023-06-13 20:42:46.616354"
] ]
], ],
"reclaimed-declined-addresses": [ "reclaimed-declined-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487559" "2023-06-13 20:42:46.836159"
] ]
], ],
"reclaimed-leases": [ "reclaimed-leases": [
[ [
0, 0,
"2022-02-11 17:54:17.487564" "2023-06-13 20:42:46.836163"
] ]
], ],
"subnet[1].assigned-addresses": [ "subnet[1].assigned-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487579" "2023-06-13 20:42:46.836173"
] ]
], ],
"subnet[1].cumulative-assigned-addresses": [ "subnet[1].cumulative-assigned-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487528" "2023-06-13 20:42:46.836098"
] ]
], ],
"subnet[1].declined-addresses": [ "subnet[1].declined-addresses": [
[ [
0, 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": [ "subnet[1].reclaimed-declined-addresses": [
[ [
0, 0,
"2022-02-11 17:54:17.487595" "2023-06-13 20:42:46.836186"
] ]
], ],
"subnet[1].reclaimed-leases": [ "subnet[1].reclaimed-leases": [
[ [
0, 0,
"2022-02-11 17:54:17.487604" "2023-06-13 20:42:46.836194"
] ]
], ],
"subnet[1].total-addresses": [ "subnet[1].total-addresses": [
[ [
200, 11010049,
"2022-02-11 17:54:17.487512" "2023-06-13 20:42:46.836083"
] ]
], ],
"subnet[1].v4-lease-reuses": [ "subnet[1].v4-lease-reuses": [
[ [
0, 0,
"2022-02-11 17:54:17.487516" "2023-06-13 20:42:46.836105"
] ]
], ],
"subnet[1].v4-reservation-conflicts": [ "subnet[1].v4-reservation-conflicts": [
[ [
0, 0,
"2022-02-11 17:54:17.487520" "2023-06-13 20:42:46.836111"
] ]
], ],
"v4-allocation-fail": [ "v4-allocation-fail": [
[ [
0, 0,
"2022-02-11 17:54:17.455302" "2023-06-13 20:42:46.616358"
] ]
], ],
"v4-allocation-fail-classes": [ "v4-allocation-fail-classes": [
[ [
0, 0,
"2022-02-11 17:54:17.455306" "2023-06-13 20:42:46.616363"
] ]
], ],
"v4-allocation-fail-no-pools": [ "v4-allocation-fail-no-pools": [
[ [
0, 0,
"2022-02-11 17:54:17.455310" "2023-06-13 20:42:46.616368"
] ]
], ],
"v4-allocation-fail-shared-network": [ "v4-allocation-fail-shared-network": [
[ [
0, 0,
"2022-02-11 17:54:17.455319" "2023-06-13 20:42:46.616372"
] ]
], ],
"v4-allocation-fail-subnet": [ "v4-allocation-fail-subnet": [
[ [
0, 0,
"2022-02-11 17:54:17.455323" "2023-06-13 20:42:46.616376"
] ]
], ],
"v4-lease-reuses": [ "v4-lease-reuses": [
[ [
0, 0,
"2022-02-11 17:54:17.455328" "2023-06-13 20:42:46.616410"
] ]
], ],
"v4-reservation-conflicts": [ "v4-reservation-conflicts": [
[ [
0, 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"
] ]
] ]
}, },

15
src/bin/dhcp4/tests/fqdn_unittest.cc
View File

@ -569,7 +569,6 @@ public:
pkt->addOption(generateClientId()); pkt->addOption(generateClientId());
// Create Client FQDN Option with the specified flags and // Create Client FQDN Option with the specified flags and
// domain-name. // domain-name.
pkt->addOption(createHostname(hostname)); pkt->addOption(createHostname(hostname));
@ -736,7 +735,6 @@ public:
EXPECT_EQ(flag_e, fqdn->getFlag(Option4ClientFqdn::FLAG_E)); EXPECT_EQ(flag_e, fqdn->getFlag(Option4ClientFqdn::FLAG_E));
} }
/// @brief Invokes Dhcpv4Srv::processHostname on the given packet /// @brief Invokes Dhcpv4Srv::processHostname on the given packet
/// ///
/// Processes the Hostname option in the client's message and returns /// Processes the Hostname option in the client's message and returns
@ -842,7 +840,6 @@ public:
ASSERT_NO_THROW(d2_mgr_.runReadyIO()); ASSERT_NO_THROW(d2_mgr_.runReadyIO());
} }
/// @brief Tests processing a request with the given client flags /// @brief Tests processing a request with the given client flags
/// ///
/// This method creates a request with its FQDN flags set to the given /// This method creates a request with its FQDN flags set to the given
@ -903,10 +900,14 @@ public:
/// @return Number of assigned addresses for a subnet. /// @return Number of assigned addresses for a subnet.
void checkSubnetStat(const SubnetID& subnet_id, const std::string& name, int64_t exp_value) const { void checkSubnetStat(const SubnetID& subnet_id, const std::string& name, int64_t exp_value) const {
// Retrieve statistics name, e.g. subnet[1234].assigned-addresses. // Retrieve statistics name, e.g. subnet[1234].assigned-addresses.
const std::string stats_name = StatsMgr::generateName("subnet", subnet_id, name); std::string stats_name = StatsMgr::generateName("subnet", subnet_id, name);
ObservationPtr obs = StatsMgr::instance().getObservation(stats_name); ObservationPtr obs = StatsMgr::instance().getObservation(stats_name);
ASSERT_TRUE(obs) << "cannot find: " << stats_name; ASSERT_TRUE(obs) << "cannot find: " << stats_name;
EXPECT_EQ(exp_value, obs->getInteger().first); EXPECT_EQ(exp_value, obs->getInteger().first);
stats_name = StatsMgr::generateName("subnet", subnet_id, StatsMgr::generateName("pool", 0, name));
obs = StatsMgr::instance().getObservation(stats_name);
ASSERT_TRUE(obs) << "cannot find: " << stats_name;
EXPECT_EQ(exp_value, obs->getInteger().first);
} }
}; };
@ -1018,7 +1019,6 @@ TEST_F(NameDhcpv4SrvTest, serverUpdateHostname) {
ASSERT_TRUE(hostname); ASSERT_TRUE(hostname);
EXPECT_EQ("myhost.example.com.", hostname->getValue()); EXPECT_EQ("myhost.example.com.", hostname->getValue());
} }
// Test that the server skips processing of a mal-formed Hostname options. // Test that the server skips processing of a mal-formed Hostname options.
@ -1089,7 +1089,6 @@ TEST_F(NameDhcpv4SrvTest, serverUpdateForwardPartialNameFqdn) {
testProcessFqdn(query, testProcessFqdn(query,
Option4ClientFqdn::FLAG_E | Option4ClientFqdn::FLAG_S, Option4ClientFqdn::FLAG_E | Option4ClientFqdn::FLAG_S,
"myhost.example.com."); "myhost.example.com.");
} }
// Test that server generates the fully qualified domain name for the client // Test that server generates the fully qualified domain name for the client
@ -1102,7 +1101,6 @@ TEST_F(NameDhcpv4SrvTest, serverUpdateUnqualifiedHostname) {
ASSERT_TRUE(hostname); ASSERT_TRUE(hostname);
EXPECT_EQ("myhost.example.com", hostname->getValue()); EXPECT_EQ("myhost.example.com", hostname->getValue());
} }
// Test that server sets empty domain-name in the FQDN option when client // Test that server sets empty domain-name in the FQDN option when client
@ -1120,7 +1118,6 @@ TEST_F(NameDhcpv4SrvTest, serverUpdateForwardNoNameFqdn) {
testProcessFqdn(query, testProcessFqdn(query,
Option4ClientFqdn::FLAG_E | Option4ClientFqdn::FLAG_S, Option4ClientFqdn::FLAG_E | Option4ClientFqdn::FLAG_S,
"", Option4ClientFqdn::PARTIAL); "", Option4ClientFqdn::PARTIAL);
} }
// Test that exactly one NameChangeRequest is generated when the new lease // Test that exactly one NameChangeRequest is generated when the new lease
@ -2092,7 +2089,6 @@ TEST_F(NameDhcpv4SrvTest, emptyFqdn) {
lease = LeaseMgrFactory::instance().getLease4(IOAddress(expected_address)); lease = LeaseMgrFactory::instance().getLease4(IOAddress(expected_address));
ASSERT_TRUE(lease); ASSERT_TRUE(lease);
EXPECT_EQ(expected_fqdn, lease->hostname_); EXPECT_EQ(expected_fqdn, lease->hostname_);
} }
// Verifies that the replace-client-name behavior is correct for each of // Verifies that the replace-client-name behavior is correct for each of
@ -2833,7 +2829,6 @@ TEST_F(NameDhcpv4SrvTest, withOfferLifetime) {
"B020A13F44859F30A108793564A97", "B020A13F44859F30A108793564A97",
time(NULL), subnet->getValid(), true); time(NULL), subnet->getValid(), true);
// And that this FQDN has been stored in the lease database. // And that this FQDN has been stored in the lease database.
lease = LeaseMgrFactory::instance().getLease4(client.config_.lease_.addr_); lease = LeaseMgrFactory::instance().getLease4(client.config_.lease_.addr_);
ASSERT_TRUE(lease); ASSERT_TRUE(lease);

14
src/bin/dhcp6/tests/fqdn_unittest.cc
View File

@ -758,7 +758,6 @@ TEST_F(FqdnDhcpv6SrvTest, createNameChangeRequestsNoAnswer) {
ctx.fwd_dns_update_ = ctx.rev_dns_update_ = true; ctx.fwd_dns_update_ = ctx.rev_dns_update_ = true;
EXPECT_THROW(srv_->createNameChangeRequests(answer, ctx), EXPECT_THROW(srv_->createNameChangeRequests(answer, ctx),
isc::Unexpected); isc::Unexpected);
} }
// Test that exception is thrown if supplied answer from the server // Test that exception is thrown if supplied answer from the server
@ -774,7 +773,6 @@ TEST_F(FqdnDhcpv6SrvTest, createNameChangeRequestsNoDUID) {
ctx.subnet_ = subnet_; ctx.subnet_ = subnet_;
ctx.fwd_dns_update_ = ctx.rev_dns_update_ = true; ctx.fwd_dns_update_ = ctx.rev_dns_update_ = true;
EXPECT_THROW(srv_->createNameChangeRequests(answer, ctx), isc::Unexpected); EXPECT_THROW(srv_->createNameChangeRequests(answer, ctx), isc::Unexpected);
} }
// Test no NameChangeRequests if Client FQDN is not added to the server's // Test no NameChangeRequests if Client FQDN is not added to the server's
@ -962,7 +960,6 @@ TEST_F(FqdnDhcpv6SrvTest, createRemovalNameChangeRequestRev) {
"000201415AA33D1187D148275136FA30300478" "000201415AA33D1187D148275136FA30300478"
"FAAAA3EBD29826B5C907B2C9268A6F52", "FAAAA3EBD29826B5C907B2C9268A6F52",
lease_->cltt_, lease_->valid_lft_); lease_->cltt_, lease_->valid_lft_);
} }
// Test that NameChangeRequest to remove DNS records is not generated when // Test that NameChangeRequest to remove DNS records is not generated when
@ -974,7 +971,6 @@ TEST_F(FqdnDhcpv6SrvTest, createRemovalNameChangeRequestNoUpdate) {
ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_)); ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_));
ASSERT_EQ(0, d2_mgr_.getQueueSize()); ASSERT_EQ(0, d2_mgr_.getQueueSize());
} }
// Test that NameChangeRequest is not generated if the hostname hasn't been // Test that NameChangeRequest is not generated if the hostname hasn't been
@ -988,7 +984,6 @@ TEST_F(FqdnDhcpv6SrvTest, createRemovalNameChangeRequestNoHostname) {
ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_)); ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_));
ASSERT_EQ(0, d2_mgr_.getQueueSize()); ASSERT_EQ(0, d2_mgr_.getQueueSize());
} }
// Test that NameChangeRequest is not generated if the invalid hostname has // Test that NameChangeRequest is not generated if the invalid hostname has
@ -1002,7 +997,6 @@ TEST_F(FqdnDhcpv6SrvTest, createRemovalNameChangeRequestWrongHostname) {
ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_)); ASSERT_NO_THROW(queueNCR(CHG_REMOVE, lease_));
ASSERT_EQ(0, d2_mgr_.getQueueSize()); ASSERT_EQ(0, d2_mgr_.getQueueSize());
} }
// Test that Advertise message generated in a response to the Solicit will // Test that Advertise message generated in a response to the Solicit will
@ -1059,7 +1053,6 @@ TEST_F(FqdnDhcpv6SrvTest, processTwoRequestsDiffFqdn) {
"000201D422AA463306223D269B6CB7AFE7AAD265FC" "000201D422AA463306223D269B6CB7AFE7AAD265FC"
"EA97F93623019B2E0D14E5323D5A", "EA97F93623019B2E0D14E5323D5A",
0, lease_->valid_lft_); 0, lease_->valid_lft_);
} }
// Test that client may send two requests, each carrying FQDN option with // Test that client may send two requests, each carrying FQDN option with
@ -1119,7 +1112,6 @@ TEST_F(FqdnDhcpv6SrvTest, processRequestSolicit) {
testProcessMessage(DHCPV6_SOLICIT, "otherhost.example.com", testProcessMessage(DHCPV6_SOLICIT, "otherhost.example.com",
"otherhost.example.com."); "otherhost.example.com.");
ASSERT_EQ(0, d2_mgr_.getQueueSize()); ASSERT_EQ(0, d2_mgr_.getQueueSize());
} }
// Test that client may send Request followed by the Renew, both holding // Test that client may send Request followed by the Renew, both holding
@ -1167,7 +1159,6 @@ TEST_F(FqdnDhcpv6SrvTest, processRequestRenewDiffFqdn) {
"000201D422AA463306223D269B6CB7AFE7AAD265FC" "000201D422AA463306223D269B6CB7AFE7AAD265FC"
"EA97F93623019B2E0D14E5323D5A", "EA97F93623019B2E0D14E5323D5A",
0, lease_->valid_lft_); 0, lease_->valid_lft_);
} }
// Test that client may send Request followed by the Renew, both holding // Test that client may send Request followed by the Renew, both holding
@ -1367,7 +1358,6 @@ TEST_F(FqdnDhcpv6SrvTest, processRequestEmptyFqdn) {
"000201C905E54BE12DE6AF92ADE72752B9F362" "000201C905E54BE12DE6AF92ADE72752B9F362"
"13B5A8BC9D217548CD739B4CF31AFB1B", "13B5A8BC9D217548CD739B4CF31AFB1B",
0, 4000); 0, 4000);
} }
// Checks that when the server reuses expired lease, the NameChangeRequest // Checks that when the server reuses expired lease, the NameChangeRequest
@ -1444,7 +1434,6 @@ TEST_F(FqdnDhcpv6SrvTest, processRequestReuseExpiredLease) {
"2001:db8:1:1::dead:beef", "2001:db8:1:1::dead:beef",
"000201415AA33D1187D148275136FA30300478" "000201415AA33D1187D148275136FA30300478"
"FAAAA3EBD29826B5C907B2C9268A6F52", 0, 4); "FAAAA3EBD29826B5C907B2C9268A6F52", 0, 4);
} }
TEST_F(FqdnDhcpv6SrvTest, processClientDelegation) { TEST_F(FqdnDhcpv6SrvTest, processClientDelegation) {
@ -1561,7 +1550,6 @@ TEST_F(FqdnDhcpv6SrvTest, hostnameReservationNoSuffix) {
"000201E2EB74FB53A5778E74AFD43870ECA5" "000201E2EB74FB53A5778E74AFD43870ECA5"
"4150B1F52B0CFED434802DA1259D6D3CA4", "4150B1F52B0CFED434802DA1259D6D3CA4",
0, 4000, "alice.example.com."); 0, 4000, "alice.example.com.");
} }
TEST_F(FqdnDhcpv6SrvTest, hostnameReservationDdnsDisabled) { TEST_F(FqdnDhcpv6SrvTest, hostnameReservationDdnsDisabled) {
@ -1664,7 +1652,6 @@ TEST_F(FqdnDhcpv6SrvTest, sanitizeFqdn) {
std::string("m\000yhost.exa\000mple.com", 20), std::string("m\000yhost.exa\000mple.com", 20),
Option6ClientFqdn::FULL, Option6ClientFqdn::FLAG_S, Option6ClientFqdn::FULL, Option6ClientFqdn::FLAG_S,
"mxyhost.exaxmple.com.", false); "mxyhost.exaxmple.com.", false);
} }
// Verifies that scoped ddns-parameter handling. // Verifies that scoped ddns-parameter handling.
@ -1751,7 +1738,6 @@ TEST_F(FqdnDhcpv6SrvTest, ddnsScopeTest) {
ASSERT_EQ(1, CfgMgr::instance().getD2ClientMgr().getQueueSize()); ASSERT_EQ(1, CfgMgr::instance().getD2ClientMgr().getQueueSize());
verifyNameChangeRequest(isc::dhcp_ddns::CHG_ADD, true, true, "2001:db8:2::1", verifyNameChangeRequest(isc::dhcp_ddns::CHG_ADD, true, true, "2001:db8:2::1",
"", 0, 4000); "", 0, 4000);
} }
// Verifies that the DDNS parameters used for a lease in subnet in // Verifies that the DDNS parameters used for a lease in subnet in

4
src/hooks/dhcp/stat_cmds/stat_cmds.dox
View File

@ -174,7 +174,7 @@ A DHCPv4 response might look like this:
"rows\": [ "rows\": [
[ 30, 256, 300, 100, 2 ], [ 30, 256, 300, 100, 2 ],
[ 40, 16, 5, 0, 0 ], [ 40, 16, 5, 0, 0 ],
[ 50, 256, 100, 35, 0 ], [ 50, 256, 100, 35, 0 ]
], ],
timestamp\": \"2018-05-04 15:03:37.000000\" } timestamp\": \"2018-05-04 15:03:37.000000\" }
} }
@ -186,7 +186,7 @@ and DHCPv6 response might look like this:
{ {
"result-set": { "result-set": {
"columns": [ "columns": [
"subnet-id", "total-nas", "cumulative-assigned-nas" "subnet-id", "total-nas", "cumulative-assigned-nas",
"assigned-nas", "declined-nas", "total-pds", "assigned-nas", "declined-nas", "total-pds",
"cumulative-assigned-pds", "assigned-pds" "cumulative-assigned-pds", "assigned-pds"
], ],

2
src/share/api/config-test.json
View File

@ -5,7 +5,7 @@
"This command instructs the server to check whether the new configuration supplied in the command's arguments can be loaded." "This command instructs the server to check whether the new configuration supplied in the command's arguments can be loaded."
], ],
"cmd-comment": [ "cmd-comment": [
"In the example below, <server> is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"." "In the example below, '<server>' is the configuration element name for a given server such as \"Dhcp4\" or \"Dhcp6\"."
], ],
"cmd-syntax": [ "cmd-syntax": [
"{", "{",

6
src/share/api/stat-lease4-get.json
View File

@ -18,11 +18,7 @@
" \"text\": \"stat-lease4-get: 2 rows found\",", " \"text\": \"stat-lease4-get: 2 rows found\",",
" \"arguments\": {", " \"arguments\": {",
" \"result-set\": {", " \"result-set\": {",
" \"columns\": [ \"subnet-id\",", " \"columns\": [ \"subnet-id\", \"total-addresses\", \"cumulative-assigned-addresses\", \"assigned-addresses\", \"declined-addresses\" ],",
" \"total-addresses\",",
" \"cumulative-assigned-addresses\",",
" \"assigned-addresses\",",
" \"declined-addresses\" ],",
" \"rows\": [", " \"rows\": [",
" [ 10, 256, 200, 111, 0 ],", " [ 10, 256, 200, 111, 0 ],",
" [ 20, 4098, 5000, 2034, 4 ]", " [ 20, 4098, 5000, 2034, 4 ]",

661
src/share/api/statistic-get-all.json
View File

@ -17,39 +17,634 @@
"{", "{",
" \"result\": 0,", " \"result\": 0,",
" \"arguments\": {", " \"arguments\": {",
" \"cumulative-assigned-addresses\": [ [ 0, \"2022-02-11 17:54:17.487569\" ] ],", " \"cumulative-assigned-addresses\": [",
" \"declined-addresses\": [ [ 0, \"2022-02-11 17:54:17.487555\" ] ],", " [",
" \"pkt4-ack-received\": [ [ 0, \"2022-02-11 17:54:17.455233\" ] ],", " 0,",
" \"pkt4-ack-sent\": [ [ 0, \"2022-02-11 17:54:17.455256\" ] ],", " \"2023-06-13 20:42:46.836166\"",
" \"pkt4-decline-received\": [ [ 0, \"2022-02-11 17:54:17.455259\" ] ],", " ]",
" \"pkt4-discover-received\": [ [ 0, \"2022-02-11 17:54:17.455263\" ] ],", " ],",
" \"pkt4-inform-received\": [ [ 0, \"2022-02-11 17:54:17.455265\" ] ],", " \"declined-addresses\": [",
" \"pkt4-nak-received\": [ [ 0, \"2022-02-11 17:54:17.455269\" ] ],", " [",
" \"pkt4-nak-sent\": [ [ 0, \"2022-02-11 17:54:17.455271\" ] ],", " 0,",
" \"pkt4-offer-received\": [ [ 0, \"2022-02-11 17:54:17.455274\" ] ],", " \"2023-06-13 20:42:46.836156\"",
" \"pkt4-offer-sent\": [ [ 0, \"2022-02-11 17:54:17.455277\" ] ],", " ]",
" \"pkt4-parse-failed\": [ [ 0, \"2022-02-11 17:54:17.455280\" ] ],", " ],",
" \"pkt4-receive-drop\": [ [ 0, \"2022-02-11 17:54:17.455284\" ] ],", " \"pkt4-ack-received\": [",
" \"pkt4-received\": [ [ 0, \"2022-02-11 17:54:17.455287\" ] ],", " [",
" \"pkt4-release-received\": [ [ 0, \"2022-02-11 17:54:17.455290\" ] ],", " 0,",
" \"pkt4-request-received\": [ [ 0, \"2022-02-11 17:54:17.455293\" ] ],", " \"2023-06-13 20:42:46.616247\"",
" \"pkt4-sent\": [ [ 0, \"2022-02-11 17:54:17.455296\" ] ],", " ]",
" \"pkt4-unknown-received\": [ [ 0, \"2022-02-11 17:54:17.455299\" ] ],", " ],",
" \"reclaimed-declined-addresses\": [ [ 0, \"2022-02-11 17:54:17.487559\" ] ],", " \"pkt4-ack-sent\": [",
" \"reclaimed-leases\": [ [ 0, \"2022-02-11 17:54:17.487564\" ] ],", " [",
" \"subnet[1].assigned-addresses\": [ [ 0, \"2022-02-11 17:54:17.487579\" ] ],", " 0,",
" \"subnet[1].cumulative-assigned-addresses\": [ [ 0, \"2022-02-11 17:54:17.487528\" ] ],", " \"2023-06-13 20:42:46.616290\"",
" \"subnet[1].declined-addresses\": [ [ 0, \"2022-02-11 17:54:17.487585\" ] ],", " ]",
" \"subnet[1].reclaimed-declined-addresses\": [ [ 0, \"2022-02-11 17:54:17.487595\" ] ],", " ],",
" \"subnet[1].reclaimed-leases\": [ [ 0, \"2022-02-11 17:54:17.487604\" ] ],", " \"pkt4-decline-received\": [",
" \"subnet[1].total-addresses\": [ [ 200, \"2022-02-11 17:54:17.487512\" ] ],", " [",
" \"subnet[1].v4-reservation-conflicts\": [ [ 0, \"2022-02-11 17:54:17.487520\" ] ],", " 0,",
" \"v4-allocation-fail\": [ [ 0, \"2022-02-11 17:54:17.455302\" ] ],", " \"2023-06-13 20:42:46.616296\"",
" \"v4-allocation-fail-classes\": [ [ 0, \"2022-02-11 17:54:17.455306\" ] ],", " ]",
" \"v4-allocation-fail-no-pools\": [ [ 0, \"2022-02-11 17:54:17.455310\" ] ],", " ],",
" \"v4-allocation-fail-shared-network\": [ [ 0, \"2022-02-11 17:54:17.455319\" ] ],", " \"pkt4-discover-received\": [",
" \"v4-allocation-fail-subnet\": [ [ 0, \"2022-02-11 17:54:17.455323\" ] ],", " [",
" \"v4-reservation-conflicts\": [ [ 0, \"2022-02-11 17:54:17.455330\" ] ]", " 0,",
" \"2023-06-13 20:42:46.616303\"",
" ]",
" ],",
" \"pkt4-inform-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616308\"",
" ]",
" ],",
" \"pkt4-nak-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616312\"",
" ]",
" ],",
" \"pkt4-nak-sent\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616314\"",
" ]",
" ],",
" \"pkt4-offer-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616318\"",
" ]",
" ],",
" \"pkt4-offer-sent\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616323\"",
" ]",
" ],",
" \"pkt4-parse-failed\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616326\"",
" ]",
" ],",
" \"pkt4-receive-drop\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616330\"",
" ]",
" ],",
" \"pkt4-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616335\"",
" ]",
" ],",
" \"pkt4-release-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616339\"",
" ]",
" ],",
" \"pkt4-request-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616343\"",
" ]",
" ],",
" \"pkt4-sent\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616348\"",
" ]",
" ],",
" \"pkt4-unknown-received\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616354\"",
" ]",
" ],",
" \"reclaimed-declined-addresses\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836159\"",
" ]",
" ],",
" \"reclaimed-leases\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836163\"",
" ]",
" ],",
" \"subnet[1].assigned-addresses\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836173\"",
" ]",
" ],",
" \"subnet[1].cumulative-assigned-addresses\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836098\"",
" ]",
" ],",
" \"subnet[1].declined-addresses\": [",
" [",
" 0,",
" \"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,",
" \"2023-06-13 20:42:46.836186\"",
" ]",
" ],",
" \"subnet[1].reclaimed-leases\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836194\"",
" ]",
" ],",
" \"subnet[1].total-addresses\": [",
" [",
" 11010049,",
" \"2023-06-13 20:42:46.836083\"",
" ]",
" ],",
" \"subnet[1].v4-lease-reuses\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836105\"",
" ]",
" ],",
" \"subnet[1].v4-reservation-conflicts\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.836111\"",
" ]",
" ],",
" \"v4-allocation-fail\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616358\"",
" ]",
" ],",
" \"v4-allocation-fail-classes\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616363\"",
" ]",
" ],",
" \"v4-allocation-fail-no-pools\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616368\"",
" ]",
" ],",
" \"v4-allocation-fail-shared-network\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616372\"",
" ]",
" ],",
" \"v4-allocation-fail-subnet\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616376\"",
" ]",
" ],",
" \"v4-lease-reuses\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616410\"",
" ]",
" ],",
" \"v4-reservation-conflicts\": [",
" [",
" 0,",
" \"2023-06-13 20:42:46.616412\"",
" ]",
" ]",
" }",
"}",
"",
"or",
"",
"{",
" \"result\": 0,",
" \"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\"",
" ]",
" ]",
" }",
"}",
"",
"or",
"",
"{",
" \"result\": 0,",
" \"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\"",
" ]",
" ]",
" }", " }",
"}" "}"
], ],