Metriche di Cloud Storage FUSE

Questa pagina fornisce una panoramica delle metriche per Cloud Storage FUSE e spiega come raccogliere, esportare e analizzare i dati delle metriche.

Panoramica

Cloud Storage fornisce metriche dettagliate per Cloud Storage FUSE quando utilizzi Cloud Storage FUSE per montare i bucket su Cloud Storage come file system. Le metriche possono aiutarti a monitorare costantemente le prestazioni, identificare potenziali colli di bottiglia che possono influire su throughput e latenza e risolvere rapidamente i problemi man mano che si verificano.

Per scopi diagnostici, puoi raccogliere le metriche in background quando utilizzi Cloud Storage FUSE. Cloud Storage offre due modi per raccogliere, esportare e analizzare le metriche:

  • Esportatore Cloud Monitoring: le metriche vengono raccolte ed esportate direttamente da Cloud Storage FUSE a Cloud Monitoring. Le metriche esportate possono essere visualizzate nella console Google Cloud.

  • Porta Prometheus: le metriche vengono esportate nel formato basato su testo delle metriche Prometheus su una porta Prometheus specificata, ad esempiohttp://Host:prometheus-port/metrics, utilizzando il toolkit di monitoraggio e generazione di avvisi open source Prometheus. Le metriche possono quindi essere visualizzate come output utilizzando un URL client come curl http://host:port/metrics

Prezzi

Le metriche di Cloud Storage FUSE vengono addebitate in base all'utilizzo. Per ulteriori informazioni sui prezzi, consulta la pagina Prezzi di Google Cloud Observability.

Utilizzare l'esportatore di Cloud Monitoring

Per utilizzare l'esportatore di Cloud Monitoring per esportare, raccogliere e analizzare le tue metriche da Cloud Storage FUSE a Cloud Monitoring, devi completare i passaggi descritti nelle sezioni seguenti.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per utilizzare l'esportatore di Cloud Monitoring, concedi il ruolo IAM Monitoring Metric Writer (roles/monitoring.metricWriter) al progetto per cui vuoi raccogliere le metriche.

Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare l'esportatore di monitoraggio di Cloud. Per ulteriori informazioni sul ruolo Monitoring Metric Writer, consulta la documentazione IAM relativa a roles/monitoring.metricWriter.

Per istruzioni su come concedere i ruoli per i progetti, consulta Gestire l'accesso ai progetti.

Prima di iniziare

  1. Abilita l'API Cloud Monitoring.

  2. Attiva l'API Cloud Storage.

    Vai all'API Cloud Storage

Configura l'esportatore di Cloud Monitoring

Per configurare l'esportatore di monitoraggio di Cloud per raccogliere, esportare e analizzare le metriche di Cloud Storage FUSE, specifica un valore intero in secondi utilizzando l'opzione di configurazione cloud-metrics-export-interval-secs utilizzando un file di configurazione di Cloud Storage FUSE o --cloud-metrics-export-interval-secs utilizzando l'interfaccia a riga di comando Cloud Storage FUSE.

Visualizzare le metriche utilizzando la console Google Cloud

Per visualizzare le metriche di Cloud Storage FUSE utilizzando la console Google Cloud, segui queste istruzioni:

  1. Nella console Google Cloud, vai alla pagina Esplora metriche.

    Vai a Esplora metriche

  2. Seleziona il progetto per cui vuoi visualizzare le metriche.

  3. Nel menu a discesa Metrica, fai clic su Seleziona una metrica.

  4. Seleziona Istanza VM, poi fai clic su Personalizzata e inserisci il nome della metrica che vuoi visualizzare. Per scoprire quali metriche offre Cloud Storage per Cloud Storage FUSE, consulta Metriche disponibili.

Utilizzare Prometheus per esportare, raccogliere e analizzare le metriche

Le sezioni seguenti descrivono come configurare e utilizzare Prometheus per esportare, raccogliere e analizzare le metriche di Cloud Storage FUSE.

Configura Prometheus

Per configurare Prometheus, segui le istruzioni riportate in Configurazione di Prometheus per Ops Agent.

Utilizzare Prometheus

  1. Specifica la porta HTTP in cui vuoi esportare le metriche utilizzando l'opzione di configurazione prometheus-port in un file di configurazione di Cloud Storage FUSE o l'opzione --prometheus-port CLI di Cloud Storage FUSE.

  2. Convalida l'endpoint delle metriche Prometheus utilizzando il seguente comando:

     curl https://localhost:8080/metrics

    In caso di esito positivo, il comando restituisce un output contenente un testo simile al seguente:

     # 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 counter
 file_cache_read_bytes_count{read_type="Random"} 0
 file_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 counter
 file_cache_read_count{cache_hit="false",read_type="Random"} 215
 file_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 histogram
 file_cache_read_latencies_bucket{cache_hit="false",le="1"} 215
 file_cache_read_latencies_bucket{cache_hit="false",le="2"} 216
 file_cache_read_latencies_bucket{cache_hit="false",le="3"} 216
 file_cache_read_latencies_bucket{cache_hit="false",le="4"} 216
 file_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 counter
 fs_ops_count{fs_op="FlushFile"} 9
 fs_ops_count{fs_op="GetInodeAttributes"} 91
 fs_ops_count{fs_op="LookUpInode"} 584
 fs_ops_count{fs_op="OpenDir"} 122
 fs_ops_count{fs_op="OpenFile"} 9
 fs_ops_count{fs_op="ReadDir"} 184
 fs_ops_count{fs_op="ReadFile"} 220
 fs_ops_count{fs_op="ReleaseDirHandle"} 122
 fs_ops_count{fs_op="ReleaseFileHandle"} 9
 fs_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 counter
 fs_ops_error_count{fs_error="function not implemented",fs_error_category="function not implemented",fs_op="GetXattr"} 1
 fs_ops_error_count{fs_error="function not implemented",fs_error_category="function not implemented",fs_op="ListXattr"} 1
 fs_ops_error_count{fs_error="interrupted system call",fs_error_category="interrupt errors",fs_op="LookUpInode"} 58
 fs_ops_error_count{fs_error="no such file or directory",fs_error_category="no such file or directory",fs_op="LookUpInode"} 6
 # HELP fs_ops_latency The cumulative distribution of file system operation latencies
 # TYPE fs_ops_latency histogram
 fs_ops_latency_bucket{fs_op="FlushFile",le="1"} 9
 fs_ops_latency_bucket{fs_op="FlushFile",le="2"} 9
 fs_ops_latency_bucket{fs_op="FlushFile",le="3"} 9
 fs_ops_latency_bucket{fs_op="FlushFile",le="4"} 9
 fs_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 counter
 gcs_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 counter
 gcs_read_count{read_type="Sequential"} 5
 ```

Metriche disponibili

Cloud Storage FUSE fornisce le seguenti metriche.

Metriche del file system

Le metriche del file system forniscono informazioni sulle operazioni eseguite sul bucket montato, ad esempio latenza e tassi di errore.

Nome metrica Descrizione della metrica
fs/ops_count Il numero di operazioni elaborate dal file system. Questa metrica consente di raggruppare per op_type per ottenere i conteggi per le singole operazioni.
fs/ops_error_count Il numero di errori generati dalle operazioni del file system. Questa metrica può essere raggruppata per op_type e error_category. Ogni errore è mappato a un error_category in una relazione many-to-one.
fs/ops_latency La distribuzione cumulativa delle latenze delle operazioni del file system. Questa metrica può essere raggruppata per op_type.

Metriche di Cloud Storage

Le metriche di Cloud Storage forniscono informazioni sulle interazioni tra Cloud Storage FUSE e Cloud Storage.

Nome metrica Descrizione della metrica
gcs/download_bytes_count Il numero di byte scaricati da Cloud Storage insieme al tipo di lettura. Il tipo di lettura specifica letture sequenziali, casuali o parallele.
gcs/read_bytes_count Il numero di byte letti dagli oggetti Cloud Storage, diverso da download_bytes_count. Ad esempio, vengono recuperati da Cloud Storage più dati di quelli effettivamente utilizzati dall'applicazione.
gcs/reader_count Il numero di lettori di oggetti Cloud Storage aperti o chiusi. I dati di questa metrica sono raggruppati in base al tipo di metodo di input/output (I/O), ad esempio opened o closed.
gcs/request_count Il numero di richieste di Cloud Storage elaborate.
gcs/request_latencies La distribuzione totale delle latenze delle richieste di Cloud Storage.

Metriche della cache dei file

Le metriche della cache dei file forniscono informazioni sulle prestazioni e sul comportamento delle operazioni di memorizzazione nella cache dei file FUSE di Cloud Storage.

Nome metrica Descrizione della metrica
file_cache/read_bytes_count Il numero di byte letti dalla cache dei file e il tipo di lettura, sequenziale o casuale.
file_cache/read_latencies La distribuzione totale delle latenze di lettura della cache dei file e l'hit della cache, true o false.
file_cache/read_count Il numero di richieste di lettura effettuate utilizzando la cache dei file, il tipo di richiesta, ad esempio sequenziale o casuale, e l'hit della cache, true o false.

Passaggi successivi