Automated configurations for high-performance machine types
Stay organized with collectionsSave and categorize content based on your preferences.
This page describes automatically set default Cloud Storage FUSE values used
for high-performance Google Cloud machine types, which are designed to
optimize performance for demanding, high-throughput workloads.
Values that are manually set at the time of mount will override these defaults.
Machine types
Configurations are automated for the following high-performance machine types:
1Setting this configuration to-1significantly boosts
performance by always serving files from the cache. Be aware that this
configuration bypasses consistency checks, which can lead to serving
outdated data. For details on managing data consistency, refer toFile, stat, and type cache invalidation.
Further performance tuning
When you use a high-performance Google Cloud machine type, the
configurations detailed on this page are automatically applied. However, you
can further fine-tune your machine for optimal performance using thePerformance tuning best practicesguide.
If you're running training, serving, or checkpointing and JIT cache workloads
on Google Kubernetes Engine clusters that use Cloud GPUs or Cloud TPU to access large
datasets in Cloud Storage, you can streamline your setup by utilizing
pre-configured YAML files to mount your Cloud Storage buckets directly into
your pods more efficiently. For more information and instructions on how to use
pre-configured Google Kubernetes Engine YAML files, seeUse pre-configured Google Kubernetes Engine YAML files to optimize Cloud Storage FUSE performance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["This page describes automatically set default Cloud Storage FUSE values used\nfor high-performance Google Cloud machine types, which are designed to\noptimize performance for demanding, high-throughput workloads.\nValues that are manually set at the time of mount will override these defaults.\n\nMachine types\n\nConfigurations are automated for the following high-performance machine types:\n\n| Series type | Machine type |\n|---------------------------------------------------|------------------------|\n| [A2 machine series](/compute/docs/gpus#a100-gpus) | |\n| | `a2-megagpu-16g` |\n| | `a2-ultragpu-8g` |\n| [A3 machine series](/compute/docs/gpus#a3-series) | |\n| | `a3-edgegpu-8g` |\n| | `a3-highgpu-8g` |\n| | `a3-megagpu-8g` |\n| | `a3-ultragpu-8g` |\n| [A4 machine series](/compute/docs/gpus#b200-gpus) | |\n| | `4-highgpu-8g-lowmem` |\n| [TPU v5e](/tpu/docs/v5e) | |\n| | `ct5l-hightpu-8t` |\n| | `ct5lp-hightpu-8t` |\n| [TPU v5p](/tpu/docs/v5p) | |\n| | `ct5p-hightpu-4t` |\n| | `ct5p-hightpu-4t-tpu` |\n| [TPU v6e (Trillium)](/tpu/docs/v6e) | |\n| | `ct6e-standard-4t` |\n| | `ct6e-standard-4t-tpu` |\n| | `ct6e-standard-8t` |\n| | `ct6e-standard-8t-tpu` |\n\nAutomated configurations\n\nWhen a supported machine type is detected, Cloud Storage FUSE automatically applies\nthe following configuration values:\n\n| Configuration file field | CLI option | Automated configuration value |\n|--------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|-------------------------------|\n| [metadata-cache.negative-ttl-secs](/storage/docs/cloud-storage-fuse/config-file#negative-ttl-secs) | [--metadata-cache-negative-ttl-secs](/storage/docs/cloud-storage-fuse/cli-options#metadata-cache-negative-ttl-secs) | `0` |\n| [metadata-cache.ttl-secs](/storage/docs/cloud-storage-fuse/config-file#ttl-secs)^1^ | [--metadata-cache-ttl-secs](/storage/docs/cloud-storage-fuse/cli-options#metadata-cache-ttl-secs)^1^ | `-1` |\n| [metadata-cache.stat-cache-max-size-mb](/storage/docs/cloud-storage-fuse/config-file#stat-cache-max-size-mb) | [--stat-cache-max-size-mb](/storage/docs/cloud-storage-fuse/cli-options#stat-cache-max-size-mb) | `1024` |\n| [metadata-cache.type-cache-max-size-mb](/storage/docs/cloud-storage-fuse/config-file#type-cache-max-size-mb) | [--type-cache-max-size-mb](/storage/docs/cloud-storage-fuse/cli-options#type-cache-max-size-mb) | `128` |\n| [implicit-dirs](/storage/docs/cloud-storage-fuse/config-file#implicit-dirs) | [--implicit-dirs](/storage/docs/cloud-storage-fuse/cli-options#implicit-dirs) | `true` |\n| [file-system.rename-dir-limit](/storage/docs/cloud-storage-fuse/config-file#rename-dir-limit) | [--rename-dir-limit](/storage/docs/cloud-storage-fuse/cli-options#rename-dir-limit) | `200000` |\n\n^1^Setting this configuration to `-1` significantly boosts\nperformance by always serving files from the cache. Be aware that this\nconfiguration bypasses consistency checks, which can lead to serving\noutdated data. For details on managing data consistency, refer to\n[File, stat, and type cache invalidation](/storage/docs/cloud-storage-fuse/caching#cache-invalidation).\n\nFurther performance tuning\n\nWhen you use a high-performance Google Cloud machine type, the\nconfigurations detailed on this page are automatically applied. However, you\ncan further fine-tune your machine for optimal performance using the\n[Performance tuning best practices](/storage/docs/cloud-storage-fuse/performance) guide.\n\nIf you're running training, serving, or checkpointing and JIT cache workloads\non Google Kubernetes Engine clusters that use Cloud GPUs or Cloud TPU to access large\ndatasets in Cloud Storage, you can streamline your setup by utilizing\npre-configured YAML files to mount your Cloud Storage buckets directly into\nyour pods more efficiently. For more information and instructions on how to use\npre-configured Google Kubernetes Engine YAML files, see\n[Use pre-configured Google Kubernetes Engine YAML files to optimize Cloud Storage FUSE performance](/storage/docs/cloud-storage-fuse/performance).\n\nWhat's next\n\n- Learn how to [tune Cloud Storage FUSE for optimal performance](/storage/docs/cloud-storage-fuse/performance).\n\n- Use a [pre-configured Google Kubernetes Engine YAML file](/storage/docs/cloud-storage-fuse/sample-yaml-files) to configure tuning best practices."]]