Skip to content

Commit e8434a0

Browse files
authored
Refine wording and clarify instructions
Edit review per CI 5312
1 parent 58deb50 commit e8434a0

1 file changed

Lines changed: 7 additions & 8 deletions

File tree

support/azure/azure-storage/files/performance/files-troubleshoot-performance.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -241,33 +241,32 @@ Ensure your app is within the [Azure Files scale targets](/azure/storage/files/s
241241

242242
### Cause 3: Azure File Share reaches capacity
243243

244-
When the Azure file share is close to reaching its capacity, it's important to identify the largest files and directories to optimize storage. This step helps you understand which files and folders are using the most space.
244+
If the Azure file share is close to reaching its capacity, an important step is to identify the largest files and directories in order to optimize storage. This step helps you to understand which files and folders are using the most space.
245245

246246
### Workaround
247247

248-
To get a comprehensive view of storage usage across the entire share, mount the root of the share. This allows for a thorough inspection of file and directory sizes. From the root of the file share, run the following commands to identify the largest files and directories:
248+
To get a comprehensive view of storage usage across the entire share, mount the root of the share. This action enables a thorough inspection of file and directory sizes. At the root of the file share, run the following commands to identify the largest files and directories:
249249

250-
251250
```bash
252251
cd /path/to/mount/point
253252
du -ah --max-depth=1 | sort -rh | head -n 20
254253
```
255-
256-
This command will display the top 20 largest files and directories in descending order of size. It provides a clear overview of storage consumption.
254+
255+
This command displays the 20 largest files and directories in descending order of size. This display provides a clear overview of storage consumption.
257256

258257
If you can't mount the root of the share, use Azure Storage Explorer or a third-party tool to analyze storage usage. These tools provide similar insights into file and directory sizes without requiring you to mount the share.
259258

260259
## Throughput on Linux clients is lower than that of Windows clients
261260

262261
### Cause
263262

264-
This is a known issue with implementing the SMB client on Linux.
263+
This is a known issue that affects implementing the SMB client on Linux.
265264

266265
### Workaround
267266

268267
- Spread the load across multiple VMs.
269-
- On the same VM, use multiple mount points with a `nosharesock` option, and spread the load across these mount points.
270-
- On Linux, try mounting with a `nostrictsync` option to avoid forcing an SMB flush on every `fsync` call. For Azure Files, this option doesn't interfere with data consistency, but it might result in stale file metadata on directory listings (`ls -l` command). Directly querying file metadata by using the `stat` command will return the most up-to-date file metadata.
268+
- On the same VM, use multiple mount points that have a `nosharesock` option, and spread the load across these mount points.
269+
- On Linux, try mounting by using a `nostrictsync` option to avoid forcing an SMB flush on every `fsync` call. For Azure Files, this option doesn't interfere with data consistency, but it might cause stale file metadata on directory listings (`ls -l` command). Directly querying file metadata by using the `stat` command returns the most up-to-date file metadata.
271270

272271
## High latencies for metadata-heavy workloads involving extensive open/close operations
273272

0 commit comments

Comments
 (0)