Skip to content

Conversation

@taroface
Copy link
Contributor

DOC-15229

  • Add new Replicator Metrics page
    • Remove previous include used for Replicator metrics
    • Add to sidebar
    • Some maintenance work (renaming, relinking) in existing migration pages

@netlify
Copy link

netlify bot commented Dec 11, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit df6e8e5
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/694577beeeb08a00081f3568

@netlify
Copy link

netlify bot commented Dec 11, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit df6e8e5
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/694577be7c5cb800085868c8

@github-actions
Copy link

github-actions bot commented Dec 11, 2025

Files changed:

@netlify
Copy link

netlify bot commented Dec 11, 2025

Deploy Preview for cockroachdb-docs canceled.

Name Link
🔨 Latest commit df6e8e5
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/694577be3bb26b0008b7d294

Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

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

The content and layout look great! I think it's a really clean doc and intuitive. I left some comments just so Shashwat can clarify a few discrepancies I noted.

Regarding the layout, I don't think you need to show the "Staging" section for MySQL, Oracle, and PG sources. Staging is really only relevant for Cockroach sources. Can probably add conditional logic there. Other than that, sections look right to me.

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

lgtm pending suggestions

- Interpretation: High values indicate target apply cannot keep up with incoming transactions.
- `target_apply_queue_utilization_percent`
- Description: Percentage of apply queue capacity utilization.
- Interpretation: Values above 90 percent indicate severe backpressure. Increase [`--targetApplyQueueSize`]({% link molt/replicator-flags.md %}#target-apply-queue-size) or investigate target database performance.
Copy link
Contributor

Choose a reason for hiding this comment

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

Should this flag link be displayed for MySQL and Oracle, since "This flag applies only to CockroachDB and PostgreSQL (pglogical) sources"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@crash-overdrive @ryanluu12345 Florence raised a really good point -- does the --targetApplyQueueSize only apply to CRDB and PG sources? If so, I need to clarify here.

Choose a reason for hiding this comment

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

it is applicable to Oracle
it is not applicable to MySQL.

Choose a reason for hiding this comment

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

Shashwat is right. Only CRDB, PG, and Oracle. MySQL upcoming.

Choose a reason for hiding this comment

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

Its only PG and Oracle. CRDB supports it too (with pebble stager) but we dont expose pebble stager publicly as of yet. So for now lets just mention PG and Oracle @taroface !

Choose a reason for hiding this comment

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

Good catch Shashwat! That's an oversight on my end, my mistake! Sorry @taroface

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Just to confirm, we're talking about the --targetApplyQueueSize flag and not the target_apply_queue_size metric, right?

Copy link

@crash-overdrive crash-overdrive left a comment

Choose a reason for hiding this comment

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

LGTM mod minor things!

Can we update the metric mutations_total to mutation_total and also add it to the Oracle section as oracle supports this metric as well!

Also can we move the Note for Checkpoint terminology to CRDB section only instead of all the sections? Also for some reason staging has the Note for Checkpoint terminology as well, dont know if thats intentional or not!

@taroface taroface force-pushed the molt-replicator-metrics branch from 710f1cf to df6e8e5 Compare December 19, 2025 16:05
@taroface taroface merged commit 226530e into main Dec 19, 2025
5 checks passed
@taroface taroface deleted the molt-replicator-metrics branch December 19, 2025 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants