Console
Start free

Custom performance

Custom performance lets you define the performance settings for your Filestore instances independently of the specified capacity. This means you can optimize your Filestore instances for your workload requirements and scale your file shares to meet the demands of your applications without resizing the capacity.

If you use Google Cloud console to create Filestore zonal and regional instances, custom performance is the default mechanism for configuring performance.

Read and write IOPS

You can use 100% of IOPS purchased for your file system for read and write operations combined. Read and write operations have different weights, with each read operation takes one operation from the purchased IOPS, while write operation takes 3.33 IOPS from the purchased IOPS.

For example, if your file system uses 33% of its purchased IOPS for read operations, it can simultaneously use up to 67% of its purchased IOPS for write operations, utilizing the purchased IOPS according to the 3.33 ratio per write.

Custom performance supports up to 100 client connections per 1,000 purchased IOPS, regardless of the capacity range or service tier being regional or zonal.

IOPS accrued from replicated data, such as backup operations, don't count towards user-purchased IOPS.

Example IOPS calculation

Assuming you have purchased 4,000 IOPS:

If you need more IOPS or throughput, you can increase your purchased IOPS rate.

Configure custom performance

You can set custom performance for zonal and regional instances that already support it. Basic tiers don't support this feature.

Custom performance instances are billed differently than instances where custom performance is not configured. For details, see Filestore pricing.

You have the following options to configure custom performance:

When creating an instance in the Google Cloud console, custom performance is enabled by default, letting you configure performance based on your workload and scale. If you don't provide specific IOPS values, a recommended default rate is used. You can opt out of custom performance, but you must do it before you create the instance, as the setting is permanent and can't be changed later.

For more information about setting custom performance, see creating instances.

For more information about custom performance in GKE, see Filestore CSI Driver.

Check custom performance status

If you want to check the custom performance status, follow these instructions:

Google Cloud console

  1. In the Google Cloud console, go to the Instances page.

    Go to Instances

  2. Click the Instance ID to open the Instance Details page.

  3. Go to the Overview tab and look for a Custom Performance entry.

    • Not supported means that custom performance is not supported for a specific instance. For example, when you create a basic tier instance, or when the instance was created before the feature was launched.
    • Enabled means that custom performance is supported and active for this instance.
    • Disabled means that custom performance is supported but not enabled for this instance.

gcloud

Get information about a Filestore instance by running the instances describe command:

    gcloud filestore instances describe INSTANCE_ID --project=PROJECT_ID --location=LOCATION

The output might vary depending on the instance settings. The following is an example output:

    createTime: '2021-10-11T17:28:23.340943077Z'
    customPerformanceSupported: true
    fileShares:
    - capacityGb: '1024'
    name: vol1
    kmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key
    labels:
    key:val
    name: projects/yourproject/locations/us-central1/instances/nfs-server
    networks:
    - ipAddresses:
    - 10.0.0.2
    network: default
    reservedIpRange: 10.0.0.0/26
    performanceConfig:
      iopsPerTb:
        maxIopsPerTb: '17000'
    performanceLimits:
      maxIops: '17000'
      maxReadIops: '17000'
      maxReadThroughputBps: '417792000'
      maxWriteIops: '5100'
      maxWriteThroughputBps: '139264000'
    state: READY
    tier: REGIONAL

REST API

Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.

  • Use cURL to call the Filestore API:

    curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    Where:

    If custom performance is supported and configured for the provided instance, the response will include the following parameters:

     "customPerformanceSupported": true,
  "performanceConfig": {
    "fixedIops": {
      "maxIops": "9000"
    }
  },
  "performanceLimits": {
    "maxReadIops": "9000",
    "maxWriteIops": "2700",
    "maxReadThroughputBps": "221184000",
    "maxWriteThroughputBps": "73728000",
    "maxIops": "9000"
  }

    • Monitoring

    To monitor instance IOPS usage, you can use the Metrics Explorer to view the following metrics: read_ops_count, write_ops_count, and metadata_ops_count.

    For more information, see monitoring instances.

    What's next