Skip to content

Document upstream RDS ReadIOPS spikes caused by streaming backpressure #989

@kwannoel

Description

@kwannoel

Context

Slack transcript (no public thread link provided):

  • [2026-02-17T03:36:38.751Z] <@U0AF0DZ7C9Y>: <@U03EA02K5L5> /docs file some docs about upstream rds having readiops read spikes because of streaming backpressure.

Related docs/context from search_docs_context:

Problem

Users can observe spikes in upstream AWS RDS ReadIOPS during streaming backpressure, but this symptom/cause path is not clearly documented in CDC troubleshooting guidance.

Without a documented explanation, users may misdiagnose these spikes as source-side issues instead of downstream backpressure and miss the right remediation steps.

Suggested Fix

Add a troubleshooting section for CDC sources (PostgreSQL/RDS) that explains:

  1. The likely causal chain: downstream streaming backpressure -> replication lag/catch-up behavior -> upstream ReadIOPS spikes.
  2. How to validate the diagnosis with RisingWave and source-side indicators (CDC lag/progress + streaming/backpressure signals).
  3. Practical mitigations and what to tune first (remove downstream bottlenecks, scale RW resources, and monitor recovery after backlog drains).

Suggested placement:

  • Primary: integrations/sources/postgresql-cdc.mdx
  • Cross-reference: ingestion/monitor-cdc-progress.mdx
  • Optional link to scaling guidance in deploy/k8s-cluster-scaling.mdx

Metadata

Metadata

Labels

bugSomething isn't workingdocs-agentdocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions