Skip to content

Conversation

@tstirrat15
Copy link
Collaborator

Fixes #414

Description

We got a few questions about what ResourceExhausted means. This splits out a Resilience page and elaborates on what ResourceExhausted means and what might cause it.

Changes

See above.

Testing

Review.

@vercel
Copy link
Contributor

vercel bot commented Nov 25, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 8, 2025 3:06pm

Copy link

@barakmich barakmich left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM with optional fix

* You may want to leave additional headroom to allow a new instance to come into service without exhausting connections, depending on your deployment model
and how instances roll.

#### CockroachDB fix

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

match caps


#### Postgres Fix

* Ensure that Postgres has enough available connections.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would these bullets read better as h5s instead of bullet/subbullet? Eg:

##### Available Connections
Ensure that Postgres has enough available connections.
....
##### Connection Pooling
##### Connection Flags

Same also with Cockroach, below

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I might actually wanna use steps? https://nextra.site/docs/built-ins/steps

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@@ -6,52 +6,6 @@ import { Callout } from 'nextra/components'
This page will provide some practical recommendations for writing relationships to SpiceDB.
If you are interested in relationships as a concept, check out this [page](/spicedb/concepts/relationships).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is a good split!

Should there be a small reference to the resilience page here ? Something like: "If you want to focus on more reliable operations with your app, go here (with link to the resilience page)"

@tstirrat15
Copy link
Collaborator Author

additional feedback:

i might change the titles of the "Postgres Fix" "CockroachDB fix" to be more specific because search engines index based on headings (edited)

@tstirrat15 tstirrat15 force-pushed the move-retries-to-resilience-section branch from d3e1c27 to 00ba6ea Compare December 8, 2025 15:01
@tstirrat15 tstirrat15 force-pushed the move-retries-to-resilience-section branch from 00ba6ea to 2c8c76e Compare December 8, 2025 15:04
Copy link
Collaborator Author

@tstirrat15 tstirrat15 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See comments

@@ -1,5 +1,6 @@
/// <reference types="next" />
/// <reference types="next/image-types/global" />
/// <reference types="next/navigation-types/compat/navigation" />
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was an automatic change on running pnpm run dev; it should be fine.

"yaml-loader": "^0.8.1"
},
"packageManager": "pnpm@10.17.1"
"packageManager": "pnpm@10.24.0"
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pnpm told me about this so I did it.

## Retries

When making requests to SpiceDB, it's important to implement proper retry logic to handle transient failures.
The [SpiceDB Client Libraries](/spicedb/getting-started/client-libraries) use gRPC[^1],
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Footnote syntax now works!

@tstirrat15 tstirrat15 force-pushed the move-retries-to-resilience-section branch from 2c8c76e to e559981 Compare December 8, 2025 15:05
@tstirrat15 tstirrat15 merged commit 9bcf7a4 into main Dec 8, 2025
10 of 11 checks passed
@tstirrat15 tstirrat15 deleted the move-retries-to-resilience-section branch December 8, 2025 15:07
@github-actions github-actions bot locked and limited conversation to collaborators Dec 8, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document use of ResourceExhausted

4 participants