[Kea-users] lease state, cltt, and valid-lft

[Darren Ankney]

Hi Diogo,

If Kea has skipped reclamation, it should be logged at debug level 40
(see here: https://kea.readthedocs.io/en/latest/kea-messages.html#dhcp6-reclaim-expired-leases-skipped).
This should only happen if the DHCP service is disabled for some
reason.  If this is logged, then it would give you somewhere to start
looking for the cause.

Thank you,
Darren Ankney

On Fri, Jan 23, 2026 at 7:09 PM Diogo André de Assumpção <daa at meta.com> wrote:
>
> Hi, Darren
>
> I’m seeing both, but with state 0 having over 10x more than others. Both v4 and v6.
>
> Running a "leases-reclaim” command cleans up the expired leases.
>
> Is there a specific even that we could see in the logs that moves leases from 0 -> 2 after cltt+valid-lifetime+reclaim-timer-wait-time?
>
> I guess if leases are not in state 2, cltt+valid-lifetime+hold-reclaimed-time would never apply?
>
> Thanks,
> Diogo
>
>
> From: Darren Ankney <darren.ankney at gmail.com>
> Date: Thursday, January 22, 2026 at 8:35 AM
> To: Kea user's list <kea-users at lists.isc.org>
> Cc: Diogo André de Assumpção <daa at meta.com>
> Subject: Re: [Kea-users] lease state, cltt, and valid-lft
>
>
>
> Hi Diogo,
>
> A couple of questions:
> * do all of your expired leases have state 0 or do some have state 2?
> * have you observed this behavior in dhcp4?
>
> My understanding is that once the lease is reclaimed (sometime after
> cltt+valid-lifetime+reclaim-timer-wait-time) but before
> cltt+valid-lifetime+hold-reclaimed-time, these should be in state 2.
> After that last time period, they should be deleted.
>
> Thank you,
> Darren Ankney
>
> On Wed, Jan 21, 2026 at 3:57 AM Diogo André de Assumpção via Kea-users
> <kea-users at lists.isc.org> wrote:
> >
> > Hi all,
> >
> > I'm trying to understand these results from the lease6-get command. Particularly, why the "state" is "0" (assigned) if the cltt + valid-lft is well in the past? Any relation to the LFC process?
> >
> > My logs show a couple of "ALLOC_ENGINE_V6_LEASES_RECLAMATION_SLOW" events, but all before the cltt in the example bellow.
> >
> >
> > root at dhcp-server:~# echo '{ "command": "lease6-get", "arguments": { "ip-address": "2001:db8:1234:5678::1" } }' | socat UNIX:/run/kea/kea6-ctrl-socket -,ignoreeof | jq .
> > {
> >  "arguments": {
> >    "cltt": 1768575433,
> >    "duid": "00:03:00:01:aa:bb:cc:dd:ee:ff",
> >    "fqdn-fwd": false,
> >    "fqdn-rev": false,
> >    "hostname": "",
> >    "hw-address": "aa:bb:cc:dd:ee:ff",
> >    "iaid": 0,
> >    "ip-address": "2001:db8:1234:5678::1",
> >    "preferred-lft": 28800,
> >    "state": 0,
> >    "subnet-id": 123456789,
> >    "type": "IA_NA",
> >    "user-context": {
> >      "ISC": {
> >        "relay-info": [
> >          {
> >            "hop": 0,
> >            "link": "2001:db8:1234:5678::3",
> >            "options": "0x0035001F00020000XXXX00000000000000000000000000000000000000000000004F0008000100000000000000",
> >            "peer": "fe80::1111:2222:3333:4444",
> >            "relay-id": "00020000XXXX00000000000000000000000000000000000000000000"
> >          }
> >        ]
> >      }
> >    },
> >    "valid-lft": 43200
> >  },
> >  "result": 0,
> >  "text": "IPv6 lease found."
> > } The timers and reclaim numbers are:
> > "expired-leases-processing": {
> > "reclaim-timer-wait-time": 3600,
> > "hold-reclaimed-time": 172800,
> > "max-reclaim-leases": 500,
> > "max-reclaim-time": 250,
> > "unwarned-reclaim-cycles": 10
> > },
> > "valid-lifetime": 43200,
> > "preferred-lifetime": 28800,
> > "renew-timer": 14400,
> > "rebind-timer": 23040,
> > "cache-threshold": .30,
> >
> > Any info is appreciated.
> >
> > Thanks,
> > Diogo
> >
> >
> > --
> > ISC funds the development of this software with paid support subscriptions. Contact us at https://urldefense.com/v3/__https://www.isc.org/contact/__;!!Bt8RZUm9aw!7kKQgkM5IwHFjLT52s7vn9XBlKOmZwUveT8ke1bDNZUP6VbhiV-TGTqdvrrtg4pnqk3HX3F8QI0m7m2g$  for more information.
> >
> > To unsubscribe visit https://urldefense.com/v3/__https://lists.isc.org/mailman/listinfo/kea-users__;!!Bt8RZUm9aw!7kKQgkM5IwHFjLT52s7vn9XBlKOmZwUveT8ke1bDNZUP6VbhiV-TGTqdvrrtg4pnqk3HX3F8QD2utWv2$ .
> > Kea-users at lists.isc.org