Diagnosing Serverless RU consumption #17826
Conversation
Files changed:
|
✅ Deploy Preview for cockroachdb-api-docs canceled.
|
✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
|
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify site configuration. |
|
@mdlinville @Amruta-Ranade could either of you give a docs review? trying to get this merged asap |
ah, thanks for the ping! looking at it now |
Happy to help if required! |
|
|
||
| For information on planning your cluster configuration and setting resource limits, refer to [Plan a Serverless Cluster]({% link cockroachcloud/plan-your-cluster-serverless.md %}). | ||
|
|
||
| ## Understand resource consumption in CockroachDB {{ site.data.products.serverless }} |
There was a problem hiding this comment.
This section feels disconnected from the rest of the doc since we don't refer to it anywhere else + feels distracting from what the user actually cares about (prescriptive and actionable guidance on diagnosing their RU usage). Let me know if I'm missing historical context on why this section is here.
There was a problem hiding this comment.
Agree it's not a great fit, but it was already on this page and I think it's important context. I've been considering moving it to Plan Your Serverless Cluster but that page is also getting a bit long, especially with the multi-region additions i have to publish right after this. Do you think it should move there?
There was a problem hiding this comment.
TLDR would like to move but don't have a better place in mind
There was a problem hiding this comment.
Can we move it to the end of the doc? Let the user find the actionable guidance first and read additional material if they're interested?
There was a problem hiding this comment.
just pushed an update. what do you think of this version with some prerequisite info at the top and the example RU calculation moved under the diagnostics?
There was a problem hiding this comment.
As discussed in our 1:1, let's handle the info rearchitecture in a follow-up PR.
https://cockroachlabs.atlassian.net/browse/DOC-8497