Compute Engine consente di esportare report dettagliati sull'utilizzo di Compute Engine in un bucket Cloud Storage utilizzando la funzionalità di esportazione dell'utilizzo. I report sull'utilizzo forniscono informazioni
sulla durata delle risorse. Ad esempio, puoi vedere quante istanze VM nel tuo progetto eseguono un tipo di macchina n2-standard-4
e da quanto tempo è in esecuzione ogni istanza. Puoi inoltre esaminare lo spazio di archiviazione di un disco permanente
e informazioni su altre funzionalità di Compute Engine.
I report sull'utilizzo non forniscono informazioni sulla fatturazione o sulle attività, ad esempio informazioni sulle richieste API. Per i dati di fatturazione, consulta la funzionalità di esportazione della fatturazione. Per i log delle attività, vedi Log delle attività.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
Report sull'utilizzo giornaliero
Questi report vengono pubblicati ogni giorno e includono i dati sull'utilizzo del giorno precedente. Ogni report è un file separato contenente i dati dell'ultimo periodo. I dati in questi report sono immutabili, il che significa che Compute Engine non aggiorna o riscrive il file di log in caso di inesattezze. Vengono invece corretti nel nuovo report successivo pubblicato nel bucket.
I report sull'utilizzo giornaliero hanno il seguente formato di nome:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv
Report di aggregazione mensile
Viene pubblicato un singolo report di aggregazione mensile contenente i dati sull'utilizzo mensili per il progetto fino al giorno escluso. Il report sull'utilizzo mensile viene sovrascritto ogni giorno con nuovi dati che riflettono l'utilizzo mensile delle risorse fino a quella data. È disponibile un solo file di dati sull'utilizzo al mese per progetto.
I report mensili di aggregazione hanno il seguente formato dei nomi:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv
I file dei report giornalieri e mensili sembrano molto simili, ad eccezione della differenza di formato della data, in cui i report di aggregazione mensili vengono aggiornati con l'anno e il mese (
YYYYMM
), mentre i report sull'utilizzo giornaliero riportano la data secondo l'anno, il mese e la data (YYYYMMDD
).- Devi aver già creato un bucket per archiviare i log di utilizzo.
Il bucket Cloud Storage in cui vuoi ricevere i report.
Puoi selezionare qualsiasi bucket Cloud Storage di cui sei proprietario, inclusi i bucket di progetti diversi. Questo bucket deve esistere prima che tu possa iniziare a esportare i report e tu devi disporre dell'accesso come proprietario al bucket. Cloud Storage addebita costi per l'utilizzo, perciò ti consigliamo di consultare i prezzi di Cloud Storage per avere informazioni su come potrebbero esserti addebitati costi per il servizio.
Qualsiasi utente con accesso in lettura al bucket Cloud Storage può visualizzare i report sull'utilizzo nel bucket. Qualsiasi utente con accesso in scrittura al bucket può creare, visualizzare e modificare i file esistenti nel bucket. Per ulteriori informazioni, consulta la sezione Controllo dell'accesso.
Il prefisso del report per i tuoi file.
Puoi specificare il prefisso da utilizzare per i report sull'utilizzo. I report sull'utilizzo contengono nomi di file che contengono questo prefisso. Ad esempio, se specifichi "my-cool-project-report" come prefisso del report, verrà restituito un nome file simile al formato
my-cool-project-report_1234567890_20131230.csv
. Se non specifichi un prefisso del report, viene utilizzato il prefisso predefinitousage_gce
.Vai alla pagina Impostazioni di Compute Engine.
Seleziona la casella Abilita esportazione dell'utilizzo.
Compila il campo in cui inserisci il Nome bucket. Se vuoi, puoi fornire un prefisso del report. Se lasci vuoto il prefisso del report, viene utilizzato il prefisso predefinito
usage_gce
. Tutti i report sull'utilizzo pubblicati nel bucket hanno questo prefisso.Fai clic su Salva.
[BUCKET_NAME]
è il nome di un bucket esistente che riceverà i report sull'utilizzo. Deve essere nel formatogs://<bucket-name>
ohttps://storage.googleapis.com/<bucket-name>
. L'utente che esegue questo comando deve essere un proprietario del bucket.[PREFIX]
è il prefisso facoltativo per i nomi dei report sull'utilizzo. Se non specificato, il prefisso predefinito èusage_gce
.- Macchine virtuali
- Dischi permanenti
- Immagini
- Snapshot
- Indirizzi IP statici
- Bilanciatori del carico
- Prenotazioni
- Tipo di metrica: stringa
- Descrizione: la data di utilizzo.
- Esempio: 15-08-2019
- Tipo di metrica: stringa
-
Descrizione: l'ID del tipo di risorsa che viene misurata.
Ad esempio,VmimageN2StandardCore_Uswest2
per rappresentare unn2-standard
nel tipo di macchinaus-west2
. -
Esempio:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
-
Esempio:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- Tipo di metrica: numero intero
- Descrizione: quantità di utilizzo per la data specificata.
- Esempio: 86400
- Tipo di metrica: stringa
- Descrizione: il tipo di unità, ad esempio conteggio, secondi, ore e così via.
- Esempio: secondi
- Tipo di metrica: stringa
- Descrizione: l'URI della risorsa specificata.
-
Esempio:
https://compute.googleapis.com/compute/v1/projects/<project‑id>/zones/<zone>/instances/<instance>
- Tipo di metrica: numero intero
- Descrizione: un ID numerico che identifica la risorsa specifica.
- Esempio: 16557630484925648021
- Tipo di metrica: stringa
-
Descrizione: la località della risorsa. Nome di una zona o di una regione oppure
GLOBAL
per le risorse globali. -
Esempio:
us-central1-a
Vai alla pagina Impostazioni di Compute Engine.
Deseleziona la casella Abilita esportazione dell'utilizzo per disabilitare l'esportazione dell'utilizzo.
- Attiva la funzionalità di esportazione della fatturazione per visualizzare i log di fatturazione.
- Tieni traccia dell'attività nel tuo progetto utilizzando Log delle attività.
- Scopri di più sui bucket Cloud Storage.
- Scopri di più sui prezzi di Compute Engine.
- Utilizza il Calcolatore prezzi per avere un prezzo stimato.
Python
Per utilizzare gli Python esempi in questa pagina in una località dell'ambiente di sviluppo, installare e inizializzare gcloud CLI quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Panoramica
Quando abiliti i report sull'utilizzo, Compute Engine invia due tipi di report al bucket Cloud Storage specificato:
Tutti i report sull'utilizzo vengono forniti in formato valori separati da virgole (CSV) e i file dei report sull'utilizzo sono preceduti dal carattere
<report_prefix>
.<report_prefix>
è un valore personalizzabile scelto dall'utente. Se non specifichi un prefisso del report, per impostazione predefinita viene utilizzato il prefissousage_gce
. Tutti gli orari sono indicati nel fuso orario del Pacifico (PST).Prerequisiti
Prima di poter iniziare a utilizzare l'esportazione dell'utilizzo di Compute Engine:
Configurazione dell'esportazione dell'utilizzo
Quando abiliti per la prima volta la funzionalità di esportazione dell'utilizzo, il primo report viene inviato il giorno successivo e fornisce informazioni dettagliate sull'utilizzo del giorno precedente. In seguito, riceverai i report a intervalli di 24 ore.
Per configurare la funzionalità di esportazione dell'utilizzo, abilitala nello strumento
gcloud compute
. Quando attivi questa funzionalità, devi definire due proprietà:Dopo aver deciso queste due proprietà, puoi abilitare la funzionalità di esportazione dell'utilizzo nei seguenti modi:
Console
gcloud
In
gcloud compute
, usa il comandogcloud compute project-info set-usage-bucket
per abilitare questa funzionalità:gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]
Dove:
Python
Per abilitare le esportazioni dell'utilizzo, usa il metodo
set_usage_export_bucket()
nella raccoltaProjects
. Nell'esempio seguente vengono utilizzate le librerie client di Cloud per Python:Per maggiori informazioni, consulta la documentazione di riferimento API per
projects.setUsageExportBucket
Download dei report sull'esportazione dell'utilizzo
Dopo aver iniziato a ricevere i report sull'utilizzo nel bucket, scaricali come faresti con altri oggetti da Cloud Storage. Per ulteriori informazioni, consulta la sezione Download degli oggetti.
Metriche supportate
I report sull'utilizzo giornaliero forniscono informazioni sull'utilizzo delle seguenti risorse:
Ogni risorsa viene descritta utilizzando le seguenti metriche:
Nome metrica Proprietà metrica Data report MeasurementId Quantità Unità URI risorsa ResourceId Località Ecco un esempio di voce nel report:
Data report MeasurementId Quantità Unità URI risorsa ID risorsa Località 13/02/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 secondi https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a Controllo dell'accesso
Quando abiliti la funzionalità di esportazione dell'utilizzo per un bucket Cloud Storage, Compute Engine si aggiunge automaticamente al bucket con accesso in scrittura per fornire i report sull'utilizzo. Finché Compute Engine ha accesso al bucket e la funzionalità di esportazione dell'utilizzo è abilitata, Compute Engine continua a esportare i report sull'utilizzo nel bucket Cloud Storage specificato.
Puoi identificare che Compute Engine ha accesso a un bucket se vedi la seguente identità aggiunta al criterio IAM del bucket:
cloud-cluster-analytics-export@google.com
Qualsiasi utente proprietario del progetto ha accesso completo al bucket Cloud Storage. Altri utenti, ad esempio autori e lettori, hanno diversi gradi di accesso al bucket. Per saperne di più su IAM per un bucket, consulta IAM per Cloud Storage.
Se disabiliti la funzionalità di esportazione dell'utilizzo, Compute Engine rimuove automaticamente l'accesso in scrittura da Compute Engine al bucket. Se modifichi le autorizzazioni nell'account cloud-cluster-analytics-export@google.com e poi disattivi la funzionalità di esportazione dell'utilizzo, Compute Engine disabilita la funzionalità di esportazione dell'utilizzo, ma non rimuoverà l'account dall'elenco per gli accessi del progetto. Se vuoi, puoi scegliere di rimuovere l'account manualmente.
Controllo dell'abilitazione dei report sull'utilizzo in corso...
Puoi controllare le impostazioni di esportazione dell'utilizzo di un progetto ottenendo informazioni sul progetto:
gcloud compute project-info describe
Cerca il campo
usageExportLocation
:+-------------------------+----------------------------------------------------+ | name | myproject | | description | | | creation-time | 2019-10-18T16:31:52.308-07:00 | | usage | | | snapshots | 1.0/1000.0 | | networks | 2.0/2.0 | | firewalls | 3.0/10.0 | |... | | | usageExportLocation | | | bucketName | https://storage.googleapis.com/usage-export-sample | | reportNamePrefix | | +-------------------------+----------------------------------------------------+
Disattivazione dei report sull'utilizzo
Quando disabiliti i report sull'utilizzo, Compute Engine rimuove automaticamente l'accesso in scrittura per Compute Engine al bucket Cloud Storage e smette di inviare nuovi report.
Console
gcloud
In
gcloud compute
, disabilita la funzionalità di esportazione dell'utilizzo eseguendo il comandogcloud compute project-info set-usage-bucket
con il flag--no-bucket
:gcloud compute project-info set-usage-bucket --no-bucket
Python
Per disabilitare le esportazioni relative all'utilizzo, usa il metodo
set_usage_export_bucket()
nella raccoltaProjects
conusage_export_location_resource
impostato suNone
. Nell'esempio seguente vengono utilizzate le librerie client di Cloud per Python:Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-07-24 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -