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 in Cloud Storage come file system. Le metriche possono aiutarti a monitorare continuamente le prestazioni, identificare potenziali colli di bottiglia che possono influire sul throughput e sulla latenza e risolvere rapidamente i problemi man mano che si verificano.

A scopo diagnostico, 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 a una porta Prometheus specificata, ad esempio http://Host:prometheus-port/metrics, utilizzando il toolkit di avvisi e monitoraggio open source Prometheus. Le metriche possono 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.

Utilizza l'esportatore di Cloud Monitoring

Per utilizzare l'esportatore Cloud Monitoring per esportare, raccogliere e analizzare le 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 Cloud Monitoring, concedi il ruolo IAM Scrittore di metriche Monitoring (roles/monitoring.metricWriter) nel progetto per il quale vuoi raccogliere le metriche.

Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare l'esportatore Cloud Monitoring. Per saperne di più sul ruolo Scrittore metriche Monitoring, consulta la documentazione IAM relativa a roles/monitoring.metricWriter.

Per istruzioni sulla concessione dei ruoli per i progetti, vedi 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 Cloud Monitoring

Per configurare l'esportatore Cloud Monitoring in modo da raccogliere, esportare e analizzare le metriche di Cloud Storage FUSE, specifica un valore intero in secondi utilizzando il campo di configurazione metrics:cloud-metrics-export-interval-secs utilizzando un file di configurazione di Cloud Storage FUSE o --cloud-metrics-export-interval-secs utilizzando la CLI 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, quindi fai clic su Personalizzata e inserisci il nome della metrica che vuoi visualizzare. Per vedere 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 a cui vuoi esportare le metriche utilizzando l'opzione di configurazione prometheus-port in un file di configurazione di Cloud Storage FUSE o l'opzione della CLI --prometheus-port utilizzando la 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_category="NOT_IMPLEMENTED",fs_op="GetXattr"} 1
 fs_ops_error_count{fs_error_category="NOT_IMPLEMENTED",fs_op="ListXattr"} 1
 fs_ops_error_count{fs_error_category="INTERRUPT_ERROR",fs_op="LookUpInode"} 58
 fs_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 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 dettagliate sulle operazioni eseguite sul bucket montato, ad esempio latenza e tassi di errore.

Nome metrica Descrizione metrica
fs/ops_count Il numero di operazioni elaborate dal file system. Questa metrica consente il raggruppamento 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 Cloud Storage

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

Nome metrica Descrizione 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, che è diverso da download_bytes_count. Ad esempio, vengono recuperati più dati da Cloud Storage di quelli effettivamente utilizzati dall'applicazione.
gcs/read_count Il numero di letture da Cloud Storage e il tipo di lettura, sequenziale, casuale o parallela.
gcs/reader_count Il numero di lettori di oggetti Cloud Storage che sono 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 Cloud Storage elaborate.
gcs/request_latencies La distribuzione totale delle latenze delle richieste Cloud Storage.

Metriche della cache dei file

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

Nome metrica Descrizione 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, vero o falso.
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, vero o falso.

Passaggi successivi