Se sua VM de cliente estiver executando o Linux, verifique se você está usando as
opções de ativação padrão.
Verifique se a VM cliente está localizada na mesma região que a
instância do Filestore. A ativação entre regiões não apenas reduz o
desempenho, como também gera um custo de rede.
Certifique-se de que sua instância do Filestore não esteja atingindo ou perto
de atingir a capacidade total. Quando a capacidade estiver quase cheia, qualquer espaço restante será altamente
fragmentado, causando lentidão nas operações de leitura e gravação. A quantidade de
espaço livre necessária para evitar esse cenário depende do caso. Recomendamos
que você configure
alertas de pouco espaço em disco.
Se os resultados do teste apresentarem um desempenho lento fora do normal, entre em contato com
seu representante da conta. Se os resultados do teste apresentarem um desempenho semelhante ou superior ao
esperado, prossiga para a próxima seção.
Casos de uso que provocam desempenho lento
Veja abaixo alguns casos de uso e cenários que causam baixo desempenho:
Cargas de trabalho que envolvem grandes volumes de arquivos pequenos
Os compartilhamentos de arquivos do Filestore usam a opção de exportação sync para segurança
de dados e conformidade com o protocolo NFS. Para a maioria das operações de modificação de dados, a
instância do Filestore espera que os dados sejam confirmados para armazenamento
antes de responder às solicitações da VM do cliente. Quando muitos arquivos estão envolvidos
em uma operação, o cliente faz uma longa série de operações síncronas,
e a latência cumulativa aumenta.
Um exemplo desse cenário é quando você extrai um arquivo do compartilhamento de arquivos,
como arquivos .tar. O TAR faz muitas operações síncronas em série ao
extrair um arquivo que contém muitos arquivos. Como resultado, o desempenho é
reduzido.
Se você estiver tentando copiar muitos arquivos pequenos para um compartilhamento de arquivos, tente
criar os arquivos em paralelo com uma ferramenta como a Google Cloud CLI:
mkdir -p /mnt/nfs/many_files_rsync/
time gcloud storage rsync many_files /mnt/nfs/many_files_rsync/ --recursive
Cada arquivo armazenado no compartilhamento de arquivos consome um inode. Se o sistema de arquivos
ficar sem nós, não será possível armazenar mais arquivos no compartilhamento de arquivos,
mesmo que você não tenha atingido a capacidade máxima alocada. No entanto, alcançar
o número máximo de inodes é raro e só será uma preocupação se você precisar
armazenar vários arquivos pequenos.
Como copiar dados entre o Cloud Storage e o Filestore
Sabe-se até o momento que a cópia de dados do Cloud Storage para uma instância do Filestore usando a
CLI gcloud é lenta. Para informações detalhadas sobre como
melhorar o desempenho, consulte
Melhorar o desempenho em todos os Google Cloud recursos.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 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)."]]
