# HELP file_cache_read_bytes_count The cumulative number of bytes read from file cache along with read type - Sequential/Random# TYPE file_cache_read_bytes_count counterfile_cache_read_bytes_count{read_type="Random"}0file_cache_read_bytes_count{read_type="Sequential"}80# HELP file_cache_read_count Specifies the number of read requests made via file cache along with type - Sequential/Random and cache hit - true/false# TYPE file_cache_read_count counterfile_cache_read_count{cache_hit="false",read_type="Random"}215file_cache_read_count{cache_hit="false",read_type="Sequential"}5# HELP file_cache_read_latencies The cumulative distribution of the file cache read latencies along with cache hit - true/false# TYPE file_cache_read_latencies histogramfile_cache_read_latencies_bucket{cache_hit="false",le="1"}215file_cache_read_latencies_bucket{cache_hit="false",le="2"}216file_cache_read_latencies_bucket{cache_hit="false",le="3"}216file_cache_read_latencies_bucket{cache_hit="false",le="4"}216file_cache_read_latencies_bucket{cache_hit="false",le="5"}216...
file_cache_read_latencies_sum{cache_hit="false"}483.62783500000023
file_cache_read_latencies_count{cache_hit="false"}220# HELP fs_ops_count The cumulative number of ops processed by the file system.# TYPE fs_ops_count counterfs_ops_count{fs_op="FlushFile"}9fs_ops_count{fs_op="GetInodeAttributes"}91fs_ops_count{fs_op="LookUpInode"}584fs_ops_count{fs_op="OpenDir"}122fs_ops_count{fs_op="OpenFile"}9fs_ops_count{fs_op="ReadDir"}184fs_ops_count{fs_op="ReadFile"}220fs_ops_count{fs_op="ReleaseDirHandle"}122fs_ops_count{fs_op="ReleaseFileHandle"}9fs_ops_count{fs_op="StatFS"}10# HELP fs_ops_error_count The cumulative number of errors generated by file system operations# TYPE fs_ops_error_count counterfs_ops_error_count{fs_error_category="NOT_IMPLEMENTED",fs_op="GetXattr"}1fs_ops_error_count{fs_error_category="NOT_IMPLEMENTED",fs_op="ListXattr"}1fs_ops_error_count{fs_error_category="INTERRUPT_ERROR",fs_op="LookUpInode"}58fs_ops_error_count{fs_error_category="NO_FILE_OR_DIR",fs_op="LookUpInode"}6# HELP fs_ops_latency The cumulative distribution of file system operation latencies# TYPE fs_ops_latency histogramfs_ops_latency_bucket{fs_op="FlushFile",le="1"}9fs_ops_latency_bucket{fs_op="FlushFile",le="2"}9fs_ops_latency_bucket{fs_op="FlushFile",le="3"}9fs_ops_latency_bucket{fs_op="FlushFile",le="4"}9fs_ops_latency_bucket{fs_op="FlushFile",le="5"}9...
fs_ops_latency_sum{fs_op="FlushFile"}0.28800000000000003
fs_ops_latency_count{fs_op="FlushFile"}9# HELP gcs_download_bytes_count The cumulative number of bytes downloaded from GCS along with type - Sequential/Random# TYPE gcs_download_bytes_count countergcs_download_bytes_count{read_type="Sequential"}2.0971528e+08
# HELP gcs_read_count Specifies the number of gcs reads made along with type - Sequential/Random# TYPE gcs_read_count countergcs_read_count{read_type="Sequential"}5```
[[["容易理解","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 (世界標準時間)。"],[],[],null,["# Cloud Storage FUSE metrics\n\nThis page provides an overview of metrics for Cloud Storage FUSE and how to\ncollect, export, and analyze metrics data.\n\nOverview\n--------\n\nCloud Storage provides in-depth metrics for Cloud Storage FUSE when you use\nCloud Storage FUSE to mount your buckets to Cloud Storage as file systems.\nMetrics can help you continuously monitor performance, identify potential\nbottlenecks that can impact throughput and latency, and address issues quickly\nas they occur.\n\nFor diagnostic purposes, you can collect metrics in the background when you use\nCloud Storage FUSE. Cloud Storage offers two ways for collecting, exporting,\nand analyzing metrics:\n\n- [**Cloud Monitoring exporter**](/architecture/monitoring-metric-export): metrics are collected and exported\n directly from Cloud Storage FUSE to Cloud Monitoring. Exported metrics can\n then be viewed in the Google Cloud console.\n\n- [**Prometheus port**](https://prometheus.io/): metrics are exported in the Prometheus metrics\n text-based format at a specified Prometheus port such as\n `http://`\u003cvar translate=\"no\"\u003eHost\u003c/var\u003e`:`\u003cvar translate=\"no\"\u003eprometheus-port\u003c/var\u003e`/metrics`\n using the Prometheus open-source monitoring and alerting toolkit.\n Metrics can then be viewed as an output using a client URL such as\n `curl http://`\u003cvar translate=\"no\"\u003ehost\u003c/var\u003e`:`\u003cvar translate=\"no\"\u003eport\u003c/var\u003e`/metrics`\n\nPricing\n-------\n\nCloud Storage FUSE metrics are charged based on your usage. For more\ninformation about pricing, refer to [Google Cloud Observability pricing](/stackdriver/pricing).\n\nUse the Cloud Monitoring exporter\n---------------------------------\n\nTo use the Cloud Monitoring exporter to export, collect, and analyze your\nmetrics from Cloud Storage FUSE to Cloud Monitoring, you must complete the\nsteps outlined in the following sections.\n\n### Get required roles\n\nTo get the permissions that you need to use the Cloud Monitoring exporter,\ngrant the [Monitoring Metric Writer](/iam/docs/understanding-roles#monitoring.metricWriter) (`roles/monitoring.metricWriter`)\nIAM role on the project you want to collect metrics for.\n\nThis predefined role contains the permissions required to use the\nCloud Monitoring exporter. For more information about the Monitoring\nMetric Writer role, see\n[IAM documentation about `roles/monitoring.metricWriter`](/iam/docs/understanding-roles#monitoring.metricWriter).\n\nFor instructions on granting roles for projects, see\n[Manage access to projects](/iam/docs/granting-changing-revoking-access).\n\n### Before you begin\n\n1. Enable the [Cloud Monitoring API](https://cloud.google.com/monitoring/api/enable-api#enabling-api-v3).\n\n2. Enable the Cloud Storage API.\n\n [Go to Cloud Storage API](https://console.cloud.google.com/flows/enableapi?apiid=storage-component.googleapis.com&_ga=2.70110096.1642044780.1726157710-823539626.1726157710)\n\n### Set up the Cloud Monitoring exporter\n\nTo set up the Cloud Monitoring exporter to collect, export, and analyze\nCloud Storage FUSE metrics, specify an integer value in seconds using the\n[`metrics:cloud-metrics-export-interval-secs`](/storage/docs/cloud-storage-fuse/config-file#cloud-metrics-export-interval-secs) configuration field using a\nCloud Storage FUSE configuration file or the\n[`--cloud-metrics-export-interval-secs`](/storage/docs/cloud-storage-fuse/cli-options#cloud-metrics-export-interval-secs) using the\nCloud Storage FUSE CLI.\n\n### View metrics using the Google Cloud console\n\nTo view Cloud Storage FUSE metrics using the Google Cloud console, use the following\ninstructions:\n\n1. In the Google Cloud console, go to the **Metrics Explorer** page.\n\n [Go\n to Metrics Explorer](https://console.cloud.google.com/projectselector/monitoring/metrics-explorer?supportedpurview=project,folder,organizationId)\n2. Select the project you want to view metrics for.\n\n3. From the **Metric** drop-down menu, click **Select a metric**.\n\n4. Select **VM Instance** , then click **Custom** and enter the name of the\n metric you want to view. To see which metrics Cloud Storage\n offers for Cloud Storage FUSE, see [Available metrics](/storage/docs/cloud-storage-fuse/metrics#available-metrics).\n\nUse Prometheus to export, collect, and analyze metrics\n------------------------------------------------------\n\nThe following sections describe how to configure and use Prometheus to\nexport, collect, and analyze Cloud Storage FUSE metrics.\n\n### Configure Prometheus\n\nTo configure Prometheus, follow the instructions in\n[Configuring Prometheus for the Ops Agent](/monitoring/agent/ops-agent/prometheus#oagent-config-json-exporter.).\n\n### Use Prometheus\n\n1. Specify the HTTP port you want to export metrics to using either the\n [`prometheus-port`](/storage/docs/cloud-storage-fuse/config-file#prometheus-port) configuration option in a\n Cloud Storage FUSE configuration file or [`--prometheus-port`](/storage/docs/cloud-storage-fuse/cli-options#prometheus-port)\n CLI option using the Cloud Storage FUSE CLI.\n\n2. Validate the Prometheus metrics endpoint using the following command:\n\n curl https://localhost:8080/metrics\n\n If successful, the command returns an output which contains text similar to\n the following: \n\n # HELP file_cache_read_bytes_count The cumulative number of bytes read from file cache along with read type - Sequential/Random\n # TYPE file_cache_read_bytes_count counter\n file_cache_read_bytes_count{read_type=\"Random\"} 0\n file_cache_read_bytes_count{read_type=\"Sequential\"} 80\n # HELP file_cache_read_count Specifies the number of read requests made via file cache along with type - Sequential/Random and cache hit - true/false\n # TYPE file_cache_read_count counter\n file_cache_read_count{cache_hit=\"false\",read_type=\"Random\"} 215\n file_cache_read_count{cache_hit=\"false\",read_type=\"Sequential\"} 5\n # HELP file_cache_read_latencies The cumulative distribution of the file cache read latencies along with cache hit - true/false\n # TYPE file_cache_read_latencies histogram\n file_cache_read_latencies_bucket{cache_hit=\"false\",le=\"1\"} 215\n file_cache_read_latencies_bucket{cache_hit=\"false\",le=\"2\"} 216\n file_cache_read_latencies_bucket{cache_hit=\"false\",le=\"3\"} 216\n file_cache_read_latencies_bucket{cache_hit=\"false\",le=\"4\"} 216\n file_cache_read_latencies_bucket{cache_hit=\"false\",le=\"5\"} 216\n ...\n file_cache_read_latencies_sum{cache_hit=\"false\"} 483.62783500000023\n file_cache_read_latencies_count{cache_hit=\"false\"} 220\n # HELP fs_ops_count The cumulative number of ops processed by the file system.\n # TYPE fs_ops_count counter\n fs_ops_count{fs_op=\"FlushFile\"} 9\n fs_ops_count{fs_op=\"GetInodeAttributes\"} 91\n fs_ops_count{fs_op=\"LookUpInode\"} 584\n fs_ops_count{fs_op=\"OpenDir\"} 122\n fs_ops_count{fs_op=\"OpenFile\"} 9\n fs_ops_count{fs_op=\"ReadDir\"} 184\n fs_ops_count{fs_op=\"ReadFile\"} 220\n fs_ops_count{fs_op=\"ReleaseDirHandle\"} 122\n fs_ops_count{fs_op=\"ReleaseFileHandle\"} 9\n fs_ops_count{fs_op=\"StatFS\"} 10\n # HELP fs_ops_error_count The cumulative number of errors generated by file system operations\n # TYPE fs_ops_error_count counter\n fs_ops_error_count{fs_error_category=\"NOT_IMPLEMENTED\",fs_op=\"GetXattr\"} 1\n fs_ops_error_count{fs_error_category=\"NOT_IMPLEMENTED\",fs_op=\"ListXattr\"} 1\n fs_ops_error_count{fs_error_category=\"INTERRUPT_ERROR\",fs_op=\"LookUpInode\"} 58\n fs_ops_error_count{fs_error_category=\"NO_FILE_OR_DIR\",fs_op=\"LookUpInode\"} 6\n # HELP fs_ops_latency The cumulative distribution of file system operation latencies\n # TYPE fs_ops_latency histogram\n fs_ops_latency_bucket{fs_op=\"FlushFile\",le=\"1\"} 9\n fs_ops_latency_bucket{fs_op=\"FlushFile\",le=\"2\"} 9\n fs_ops_latency_bucket{fs_op=\"FlushFile\",le=\"3\"} 9\n fs_ops_latency_bucket{fs_op=\"FlushFile\",le=\"4\"} 9\n fs_ops_latency_bucket{fs_op=\"FlushFile\",le=\"5\"} 9\n ...\n fs_ops_latency_sum{fs_op=\"FlushFile\"} 0.28800000000000003\n fs_ops_latency_count{fs_op=\"FlushFile\"} 9\n # HELP gcs_download_bytes_count The cumulative number of bytes downloaded from GCS along with type - Sequential/Random\n # TYPE gcs_download_bytes_count counter\n gcs_download_bytes_count{read_type=\"Sequential\"} 2.0971528e+08\n # HELP gcs_read_count Specifies the number of gcs reads made along with type - Sequential/Random\n # TYPE gcs_read_count counter\n gcs_read_count{read_type=\"Sequential\"} 5\n ```\n\nAvailable metrics\n-----------------\n\nCloud Storage FUSE provides the following metrics.\n\n### File system metrics\n\nFile system metrics provide insight into the operations performed on the\nmounted bucket such as latency and error rates.\n\n### Cloud Storage metrics\n\nCloud Storage metrics provide insight into the interactions between\nCloud Storage FUSE and Cloud Storage.\n\n### File cache metrics\n\nFile cache metrics provide insight into the performance and behavior of\nCloud Storage FUSE file caching operations.\n\nWhat's next\n-----------\n\n- Learn how you can [improve Cloud Storage FUSE performance](/storage/docs/cloud-storage-fuse/performance).\n\n- Forward your [`gcsfuse` logs to Cloud Logging](/storage/docs/cloud-storage-fuse/forward-cloud-storage-fuse-logs-to-cloud-logging)."]]
