Cloud Data Fusion flow control overview

A flow control mechanism in Cloud Data Fusion prevents you from submittingtoo many requests, which can cause stuck or failed pipeline runs. This mechanismapplies to start (Launch) requests for the following pipelines and jobs in alleditions of Cloud Data Fusion, versions 6.6 and later:

  • Batch pipelines
  • Real-time pipelines
  • Replication jobs

Thresholds

To control the number of outstanding start requests in Cloud Data Fusion,flow control relies on two thresholds:

Launch threshold
Limits the number of launch requests being made. If thenumber of launch requests received by Cloud Data Fusion that are not yet inRunning state is greater than the launch threshold (number of launch requeststhat aren't running yet > launch threshold), the request is rejected. Thenumber includes batch pipelines, real-time pipelines, andreplication jobs.
Runs threshold
Limits the number of outstanding launch requests inthe system. If the number of outstanding launch requests received byCloud Data Fusion that have not yet finished is greater than a specifiedruns threshold (number of outstanding requests that aren't finished yet > runsthreshold), the request is rejected.

Rejected requests

If either threshold is met, every new start request gets rejected. For example,a rejected batch pipeline has aRejected status in the logs, and a dialog inthe UI describes why the launch was rejected.

Metrics

The number of launching and running pipelines along with the number of rejectedpipelines in the system can be accessed through the metrics service as follows.

Launching metric

Reports the number of launching requests in the system. That is, it reports thenumber of launch requests that are inProvisioning orStarting states.

Metrics name:flowcontrol.launching.count

POST /v3/metrics/query?metric=system.flowcontrol.launching.count

Running metric

Reports the number of running pipelines and jobs in the system. The runthreshold is based on the sum of theLaunching andRunning metrics values.

Metrics name:flowcontrol.running.count

POST /v3/metrics/query?metric=system.flowcontrol.running.count

Rejected metric

Reports the number of rejected runs due to the flow control mechanism.

Metrics name:program.rejected.runs

POST /v3/metrics/query?metric=system.program.rejected.runs

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.