클라이언트 VM과 Filestore 인스턴스가 동일한 리전에 있는지 확인합니다. 리전 간에 마운트하면 성능이 저하될 뿐만 아니라 네트워킹 비용도 발생합니다.
Filestore 인스턴스가 전체 용량에 도달했거나 거의 근접하지 않았는지 확인합니다. 용량이 거의 가득 차면 남은 공간이 심하게 조각나므로 읽기 및 쓰기 작업이 느려집니다. 이 시나리오를 방지하는 데 필요한 여유 공간 양은 경우에 따라 다릅니다. 디스크 공간 알림 부족을 설정하는 것이 좋습니다.
테스트 결과에 비정상적인 성능 저하가 나타나면 비즈니스 계정 담당자에게 문의하세요. 테스트 결과가 예상과 비슷하거나 더 나은 경우 다음 섹션을 계속 진행하세요.
성능 저하를 일으키는 사용 사례
다음은 성능 저하를 일으키는 몇 가지 사용 사례 및 시나리오입니다.
작은 파일이 대량 포함된 워크로드
Filestore 파일 공유는 데이터 안전 및 NFS 프로토콜 규정 준수를 위해 sync 내보내기 옵션을 사용합니다. 대부분의 데이터 수정 작업에 대해 Filestore 인스턴스는 데이터가 스토리지에 커밋될 때까지 기다린 후 클라이언트 VM의 요청에 회신합니다. 작업에 많은 파일이 관련되어 있으면 클라이언트에서 수행되는 동기 작업이 길어지고 누적 지연 시간이 추가됩니다.
이 시나리오의 예시는 tar 파일과 같이 파일 공유에서 보관 파일을 추출할 때입니다. TAR은 많은 파일이 포함된 보관 파일을 처리할 때 일련의 많은 동기 작업을 만듭니다. 이로 인해 성능이 저하됩니다.
많은 작은 파일을 파일 공유에 복사하려는 경우 Google Cloud CLI와 같은 도구를 사용하여 파일을 동시에 생성해 보세요.
mkdir -p /mnt/nfs/many_files_rsync/
time gcloud storage rsync many_files /mnt/nfs/many_files_rsync/ --recursive
파일 공유에 저장된 파일마다 inode 하나를 사용합니다. 파일 시스템에서 inode가 부족하면 할당된 최대 용량에 도달하지 않았어도 파일 공유에 파일을 더 저장할 수 없습니다. 하지만 최대 inode 수에 도달하는 경우는 매우 드뭅니다. 많은 작은 파일을 저장해야 하는 경우에만 문제가 됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThis page helps troubleshoot slow performance issues with Filestore, providing actionable steps to diagnose and resolve them.\u003c/p\u003e\n"],["\u003cp\u003eSlow performance can often be attributed to client VM configuration, such as incorrect machine type, mount options (avoid using \u003ccode\u003esync\u003c/code\u003e), or being in a different region than the Filestore instance.\u003c/p\u003e\n"],["\u003cp\u003eFilestore performance can degrade when the instance is near full capacity, leading to fragmentation and slower read/write operations, so monitoring is crucial.\u003c/p\u003e\n"],["\u003cp\u003eWorkloads involving a high volume of small files can result in slow performance due to the synchronous nature of Filestore operations, and copying data between Cloud Storage and Filestore using the gcloud CLI can be slow as well.\u003c/p\u003e\n"],["\u003cp\u003eTesting performance using \u003ccode\u003efio\u003c/code\u003e is recommended to identify issues, and if performance is slower than expected, contacting an account representative is advised.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot slow performance\n\nThis page provides troubleshooting information to help address slow performance\nissues you might encounter while using Filestore.\n\nSlow read or write performance\n------------------------------\n\n1. Ensure that you are using the\n [recommended machine type](/filestore/docs/performance#client-machine)\n for the client VM.\n\n2. If your client VM is running Linux, confirm that you're using the\n [default mount options](/filestore/docs/performance#linux_client_mount_options).\n\n | **Note:** Using the `sync` client mount option significantly reduces performance.\n3. Ensure that the client VM is located in the same region as the\n Filestore instance. Mounting across regions not only reduces\n performance, it also incurs a [networking cost](/vpc/network-pricing).\n\n4. Ensure that your Filestore instance isn't at or near full\n capacity. When capacity is nearly full, any remaining space is highly\n fragmented, causing read and write operations to slow down. The amount of\n free space needed to avoid this scenario is case-dependent. We recommend\n setting up\n [low disk space alerts](/filestore/docs/monitoring-instances#low-disk-space).\n\n For more information, see [Troubleshoot capacity issues](/filestore/docs/capacity-issues).\n5. [Test the performance](/filestore/docs/performance#testing_performance)\n of your Filestore instance using the `fio` tool.\n\n If the test results show abnormally slow performance, contact your account\n representative. If the test results show similar or greater performance than\n expected, continue to the next section.\n\nUse cases that cause slow performance\n-------------------------------------\n\nHere are some use cases and scenarios that cause poor performance:\n\n### Workloads involving high volumes of small files\n\n- Filestore file shares use the `sync` export option for data safety\n and NFS protocol compliance. For most data-modifying operations, the\n Filestore instance waits for the data to be committed to storage\n before replying to requests from the client VM. When many files are involved\n in an operation, the client makes a long series of synchronous operations\n and the cumulative latency adds up.\n\n An example of this scenario is when you extract an archive on the file share,\n like tar files. TAR makes many synchronous operations in a series when\n extracting an archive containing many files. As a result, performance is\n reduced.\n\n If you're trying to copy many small files to a file share, try parallelizing\n file creation with a tool like the [Google Cloud CLI](/sdk/gcloud/reference/storage/rsync): \n\n mkdir -p /mnt/nfs/many_files_rsync/\n time gcloud storage rsync many_files /mnt/nfs/many_files_rsync/ --recursive\n\n- Each file stored on the file share consumes one inode. If the file system\n runs out of inodes, you won't be able to store more files on the file share\n even if you haven't reached the maximum allocated capacity. However, reaching\n the maximum number of inodes is rare and is only a concern if you need to\n store numerous small files.\n\n For more information, see [Inode usage](/filestore/docs/scale#inode-usage).\n\n### Copying data between Cloud Storage and Filestore\n\nCopying data from Cloud Storage to a Filestore instance using the\ngcloud CLI is known to be slow. For detailed information on how to\nimprove performance, see\n[Improve performance across Google Cloud resources](/filestore/docs/performance#across-resources).\n\nWhat's next\n-----------\n\n- [Troubleshoot capacity issues](/filestore/docs/capacity-issues)\n- [Improve performance across Google Cloud resources](/filestore/docs/performance#across-resources).\n- [Scale capacity](/filestore/docs/scale)."]]
