Thanks Larry, this is inline with my understanding of best practices, thinking critically about the

Thanks Larry, this is inline with my understanding of best practices, thinking critically about the "partitioning" strategy for DO, basically how you uniquely name DOs. For named/identified things like organizations, users, cities, etc. this is perfect. The thing I'm struggling with is best practice for using DO's with single use identifiers (like a job run id). I think I just need to accept there will be lots of DO's lingering around forever or use a pool of 100x DOs like "runner-001", "runner-002", etc. and then just reuse those, so my OCD isn't triggered

My spider sense is telling me be careful about letting millions of resources just pile up, it could come back to bite you - but I get lots of feedback on this forum saying "don't worry about it"

PPaul Thanks Larry, this is inline with my understanding of best practices, thinking c...

PaulOP•10/30/25, 3:40 PM

Or maybe I need to think more about the partition key that actually might make sense for this use case, the account and repo and workflow name for example could be concatenated to create a unique slot. I could either use that or a hash of that to create a unique identifier. - this is probably the way...

Larry•10/30/25, 3:55 PM

I think you are aligned now. Just keep in mind that you'll have to keep that list of active ones somewhere. When you think one should go away forever, just make absolutely sure it's empty of data. Then delete that key from your outside maintained list. You could have a cron job somewhere that use the Cloudflare API to get the full list and crawl it to check that they are absolutely empty. That's not as trivial as it should be because there are some edge cases. I don't have them in my head but I bet someone else in this conversation does.

LLarry You can sense if that is happening by storing a counter in global context. That ...

hollowaya•10/30/25, 9:58 PM

Hey, did you mean that a value in globalThis will be the same if the DO instances are running in the same isolate?

Hhollowaya Hey, did you mean that a value in globalThis will be the same if the DO instance...

Larry•10/30/25, 10:15 PM

Exactly. Surprising but true. I used a Set of instance ids for my experiments. It was not unheard of but it was rare-ish for there to be two. I don't think I ever saw three. I stopped monitoring years ago because I stopped pre-loading stuff into instance variables and I now retrieve from storage just what I needed to handle that one Request/Message. It sounds inefficient, but it's not with an embedded database that has a cache... and it's more memory efficient. It's also cost effective because reads are dirt cheap.

LLarry Exactly. Surprising but true. I used a Set of instance ids for my experiments. I...

hollowaya•10/30/25, 10:19 PM

Amazing, thanks for explaining, we just added an id/counter to prod and hopefully it will shed light on our problem haha

Larry•10/30/25, 10:39 PM

Is the DurableObject base class in a repo somewhere that can look at?

LLarry Is the DurableObject base class in a repo somewhere that can look at?

1984 Ford Laser•10/30/25, 10:56 PM

Poking around a bit, maybe this is of use? https://github.com/cloudflare/workerd/blob/aee8c81a780095b66f80c424545eb5a97a062452/src/workerd/api/workers-module.h#L43

11984 Ford Laser Poking around `workerd` a bit, maybe this is of use? https://github.com/cloudfla...

Larry•10/30/25, 11:13 PM

Thanks. I don't know C++ but this is the "interface" essentially. The "implementation" was in a link on the side of the page you took me to so thanks again. It looks like all it does it set and but there is some other C++ foo I don't follow if anyone knows?

1984 Ford Laser•10/30/25, 11:14 PM

I found other references to DurableObjectBranded that might also be of use

Larry•10/30/25, 11:30 PM

I think the implementation is here: https://github.com/cloudflare/workerd/blob/main/src/workerd/api/workers-module.c%2B%2B#L25. It's a c++ file and it does what I said. I'm guessing the other c++ foo is just allocating memory and housekeeping. I think I have what I need. Thanks again for the help.

GitHub

workerd/src/workerd/api/workers-module.c++ at main · cloudflare/wo...

The JavaScript / Wasm runtime that powers Cloudflare Workers - cloudflare/workerd

John Spurlock•10/31/25, 4:30 PM

recent message from over in the d1 channel that might be of interest to folks here eagerly awaiting DO storage read replication...

d1-database

Need_Not•11/1/25, 8:30 AM

how much slower is it to use sql reads directly instead of keeping an in memory copy of the table to look up by PM?
Obviously in memory is going to be effectively instant but it's already a hassle to update data in both sql and in memory.

NNeed_Not how much slower is it to use sql reads directly instead of keeping an in memory ...

lambrospetrou•11/1/25, 9:17 AM

If you use SQLite DOs there is already an in-memory cache of your reads, so the difference should be negligible. Using in-memory state could make sense within the context of a single request but otherwise it should be fast enough.

NNeed_Not how much slower is it to use sql reads directly instead of keeping an in memory ...

Larry•11/1/25, 9:36 AM

I switched away from keeping instance variables (with a rare exception) a year or so ago and it was one of my best design decisions. We noticed no bump in cost because reads are so cheap and as you pointed out, you already need to do the writes. We noticed no performance penalty. We didn't know how to measure it but we suspect that cold starts got faster by a few ms, although we now believe that's driven by the size of the SQLite storage.

ALECKS•11/1/25, 2:21 PM

Has there been any discussion/consideration around adding some built in lifecycle hooks to Durable Objects? For example, these two would be super helpful:

async onWake() - called automatically after a DO is instantiated
async onEvict() - called automatically right before a DO is evicted

My current pattern is to call onWake() myself, but every time the DO is accessed, and it has a flag internally to check if it's already awake. Works, but annoying ergonomics.

For evict, this is trickier, I currently do not know how to catch this. Having this OOTB would allow us to keep DB connections open between multiple requests while the DO is active and serving. Right now, I have to open and close a pg connection for each request which isn't ideal.
I suppose I could use a setTimeout and close when that expires, and reset the timeon on each new request... but that also feels weird.

How are people solving this pattern?

Sstickman `onWake` is essentially equivalent to calling your `constructor`? I remember the...

ALECKS•11/1/25, 2:25 PM

The big problem with that is doing any sort of async work in the constructor, like initializing state with same data from a postgres call

Sstickman you can do async work inside `blockConcurrencyWhile`

ALECKS•11/1/25, 2:26 PM

in a constructor?

ALECKS•11/1/25, 2:27 PM

Oh yeah.. hmm even the docs show it: https://developers.cloudflare.com/durable-objects/reference/in-memory-state/

ALECKS•11/1/25, 2:28 PM

ok, that's great, missed this before

AALECKS ok, that's great, missed this before

Larry•11/1/25, 3:43 PM

BTW, I've been using Durable Objects for about 4 years now and it was just last week when I learned something new about it.

LLarry BTW, I've been using Durable Objects for about 4 years now and it was just last ...

ALECKS•11/1/25, 3:46 PM

hey since you have so much experience, curious... for DOs that need an identity, for ex, let's say you have a DO per tenant

since you can't know the state ahead of time, is this really the only way to call methods on it:

or is there some clever way to initialize a worker once, and not have to redo it every time?

AALECKS 🙂 hey since you have so much experience, curious... for DOs that need an ident...

James•11/1/25, 3:59 PM

I send the id as metadata on every rpc call since any given worker may or may not be initializing the DO given its a singleton.

AALECKS 🙂 hey since you have so much experience, curious... for DOs that need an ident...

Larry•11/1/25, 6:17 PM

You can't know it's name without doing something like James suggests or what you suggest with . However, depending upon why you need it, you may just be able to get away with using That address is always accurate and always present. It's that 64 hex digit string that you would use in or maybe it's the actual id object so you'd use . I let TypeScript tell me when I get it wrong and I'm on mobile so can't try it.

Most of the time, I only need that because I'm using it as the return address for something like @lumenize/proxy-fetch.

There is also another trick I use essentially every time now. I almost always use WebSockets from a browser. My

routeDORequest

routeDORequest

expects this format for URLs, . That's always how my WebSocket upgrades happen so I always have the name in that slot. There is also an undocumented header (I just added it and it's on my to-do list to document) that has it as well, in case you don't want to parse the URL again inside your DO's fetch handler. Since you have to use fetch for WebSockets and I'm always using WebSockets, I always have those.

AALECKS 🙂 hey since you have so much experience, curious... for DOs that need an ident...

lambrospetrou•11/1/25, 7:55 PM

Personally, I either do the approach, or send the identifier all the time if the original request also contains the information to derive it.

Sstickman you can do async work inside `blockConcurrencyWhile`

lambrospetrou•11/1/25, 7:57 PM

Keep in mind that just because you can do it, you should not do slow operations in the constructor.
While you do that you literally cannot process anything, so with sufficient traffic you will be overloading your DO potentially.

Ideally the constructor should only do light initialization, reading from its storage if needed, or some other "fast-ish" action. Reading from a remote database could take hundreds of milliseconds potentially, so do it if absolutely necessary but be careful and monitor the latency.

Llambrospetrou If you use SQLite DOs there is already an in-memory cache of your reads, so the ...

Need_Not•11/1/25, 9:42 PM

does that apply to SQL too? I can see if KV is cached but sql?

<@235148962103951360>•11/2/25, 4:19 AM

Does running durableObject.fetch count as a billable request?

NNeed_Not does that apply to SQL too? I can see if KV is cached but sql?

lambrospetrou•11/2/25, 7:46 AM

Yes, all storage operations use the underlying SQLite engine when using SQLite DOs, therefore benefit from in-memory cache by the runtime already where applicable.

Need_Not•11/2/25, 7:50 AM

That's good.

Need_Not•11/2/25, 7:54 AM

too bad there is no way to set multiple alarms. I want an alarm for additional work after returning. But also an alarm to clean up and delete everything after inactivity.

Sstickman Yes, every RPC/fetch on a Durable Object is one billable session.

<@235148962103951360>•11/2/25, 7:54 AM

thanks for your response

NNeed_Not too bad there is no way to set multiple alarms. I want an alarm for additional w...

Larry•11/2/25, 12:17 PM

There are several solutions for this running around. They all work off the same basic concept. They store your alarm specifications in DO storage. This can be quite complicated with recurring alarms specified as well as multiple single alarms in the future. The key is that they make sure the next alarm, according to that stored specification, is the one that the single native alarm is setup for. Smart implementations make sure that if you somehow missed an alarm, it'll get caught and executed-maybe a little late, but not missed. They also have retry logic.

The package has such a system and it's documented, but unfortunately, you have to adopt the somewhat rickety and spotily-documented Agents ecosystem to use it. There is Brayden's elegant Alarm class but it's not documented, and by default requires your DO extend the Actor base class unless you duplicate what that base class does manually. It's still my favorite implementaion and can be found at on npm. And PartyKit has one as well.

Internally, we used the PartyKit one for the 5 minutes we were using PartyKit, then we created our own, now we use a fork of Brayden's. I had on my to-do list to release a well-documented stand-alone package that is pluggable based upon Brayden's implementation. I'll move that to the top of the list for Lumenize and you should have something in a day or so.

NNeed_Not too bad there is no way to set multiple alarms. I want an alarm for additional w...

Larry•11/2/25, 12:23 PM

As a thought... based upon your use of "additional work after returning", what are you "returning" from? The reason I ask, that there is which offloads Requests to a Worker or a dedicated DO and then when the fetch is done, it calls back to the original DO and executes a handler that you provided when you made the original call.

Introduction | Lumenize

Cost-effective external API calls from Durable Objects using Cloudflare Queues

NNeed_Not too bad there is no way to set multiple alarms. I want an alarm for additional w...

Larry•11/2/25, 1:30 PM

Actually, I just looked at our Alarms port and it looks like the only thing we did was add a Lumenize NADIS (not a DI system) wrapper around it. So, instead of rushing that to market, I'm now working on docs for Brayden's Alarms. I should have that out later today.

ALECKS•11/2/25, 1:31 PM

I think the Cloudflare Agent class has that kind of Alarm system

plgingras88•11/2/25, 1:39 PM

Larry you deserve a wage from CF !

plgingras88•11/2/25, 1:40 PM

Thanks for your precious involvement, I read and take great interest in your work

Pplgingras88 Thanks for your precious involvement, I read and take great interest in your wor...

Larry•11/2/25, 2:05 PM

That makes it all worth it.

AALECKS I think the Cloudflare Agent class has that kind of Alarm system

Larry•11/2/25, 2:07 PM

It does. I included a mention of it in my reply but switching to Agents is a big commitment and I don't trust it since they let a security-relevant bug go unfixed for months

ALECKS•11/2/25, 2:08 PM

Yeah, I pulled the individual methods out instead of using the whole thing

LLarry There are several solutions for this running around. They all work off the same ...

lambrospetrou•11/2/25, 5:09 PM

There is Brayden's elegant Alarm class but it's not documented, and by default requires your DO extend the Actor base class unless you duplicate what that base class does manually.

You actually don't need the Actor base class. I am a fan of toolkits personally, so we tried ~~most~~ some of the functionality in the package to make it available on its own, only depending on the of SQLite Durable Objects.

See example in https://github.com/cloudflare/actors/blob/e910e86ac1567fe58e389d1938afbdf1e53750ff/examples/durable-objects/src/index.ts#L21

Same goes for the SQL Schema migrations, you can use them without the Actor base class, and retry utilities too.

Llambrospetrou > There is Brayden's elegant Alarm class but it's not documented, and by default...

lambrospetrou•11/2/25, 5:10 PM

And yes, we need to document the whole package better. It's coming.