# UFS Bandwidth Control

When Alluxio reads data from an underlying file system (UFS), especially during cache-warming jobs or periods of high cache misses, the traffic can overwhelm the UFS. This can impact other applications that rely on the same UFS. To prevent this, Alluxio allows you to limit the UFS read bandwidth on each worker.

## How It Works

The UFS read rate limiter restricts the maximum bandwidth per second for all UFS reads originating from a single Alluxio worker. While peak bandwidth may occasionally exceed the configured limit for very short bursts, the *average* bandwidth will be capped at the specified rate.

This feature is currently supported for the following UFS connectors:

* HDFS
* Amazon S3
* Google Cloud Storage (GCS)
* Alibaba Cloud OSS
* Tencent COS

## Configuration

To enable the UFS read rate limiter, set the following property in `alluxio-site.properties` on each worker. The value is specified in megabytes per second (MB/s).

```properties
# Limit UFS read bandwidth to 100 MB/s per worker
alluxio.worker.data.ufs.read.rate.limit.mb=100
```

By default, this feature is disabled (unlimited). Setting this property enables the limiter with the specified bandwidth cap.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.alluxio.io/ee-ai-en/ai-3.8-15.1.x/performance/ufs-bandwidth-limiting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
