Visualizzazione dei rapporti di utilizzo

Compute Engine ti consente di esportare report dettagliati sul tuo utilizzo di Compute Engine in un bucket Cloud Storage utilizzando la funzionalità di esportazione dell'utilizzo. I report sull'utilizzo forniscono informazioni sul ciclo di vita 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 anche 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 informazioni sulla fatturazione, consulta la funzionalità Esportazione fatturazione. Per i log delle attività, vedi Log delle attività.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. Python

      Per utilizzare gli Python esempi in questa pagina in un ambiente di sviluppo locale, installa e inizializza l'interfaccia alla gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

      1. Install the Google Cloud CLI.

      2. To initialize the gcloud CLI, run the following command: 

        gcloud init

      3. If you're using a local shell, then create local authentication credentials for your user account: 

        gcloud auth application-default login

        You don't need to do this if you're using Cloud Shell.

      Per ulteriori informazioni, consulta Set up authentication for a local development environment.

Panoramica

Quando attivi i report sull'utilizzo, Compute Engine genera due tipi di report nel bucket Cloud Storage specificato:

  1. Report giornalieri sull'utilizzo

    Questi report vengono generati quotidianamente e includono i dati sull'utilizzo del giorno precedente. Ogni report è un file separato che contiene i dati dell'ultimo periodo. I dati di questi report sono immutabili, il che significa che Compute Engine non aggiorna né riscriverà il file log se sono presenti imprecisioni. I dati vengono corretti nel nuovo report successivo inviato al bucket.

    I report sull'utilizzo giornaliero hanno il seguente formato del nome:

    <bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv

  2. Report mensile aggregato

    Viene generato un singolo report di riepilogo mensile giornaliero contenente i dati di utilizzo mensile del progetto fino al giorno in questione, escluso. Il report sull'utilizzo mensile viene sovrascritto ogni giorno con nuovi dati che riflettono l'utilizzo mensile delle risorse fino a quella data. Esiste un solo file mensile di dati sull'utilizzo per progetto e per mese.

    I report di aggregazione mensile hanno il seguente formato del nome:

    <bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv

    I file dei report giornalieri e mensili sono molto simili, tranne per la differenza nel formato della data, in cui i report di aggregazione mensili sono datati utilizzando l'anno e il mese (YYYYMM) e i report sull'utilizzo giornaliero sono datati utilizzando l'anno, il mese e la data (YYYYMMDD).

Tutti i report sull'utilizzo vengono generati in formato valori separati da virgole (CSV) e i file dei report sull'utilizzo hanno il prefisso <report_prefix>. <report_prefix> è un valore personalizzabile scelto dall'utente. Se non specifichi un prefisso per i report, per impostazione predefinita viene utilizzato il prefisso usage_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 attivi 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. Successivamente, riceverai i report a intervalli di 24 ore.

Per configurare la funzionalità di esportazione dell'utilizzo, attivala nello strumento gcloud compute. Quando attivi questa funzionalità, devi definire due proprietà:

  1. Il bucket Cloud Storage in cui vuoi che vengano inviati 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 devi disporre dell'accesso come proprietario al bucket. Cloud Storage prevede un addebito in base all'utilizzo, pertanto ti consigliamo di consultare la pagina Prezzi di Cloud Storage per informazioni su come potresti incorrere in addebiti per il servizio.

    Qualsiasi utente con accesso in lettura al bucket Cloud Storage può visualizzare i report sull'utilizzo nel bucket. Qualsiasi utente che dispone dell'accesso in scrittura al secchio può creare, visualizzare e modificare i file esistenti al suo interno. Per ulteriori informazioni, consulta la sezione Controllo dell'accesso.

  2. Il prefisso del report per i file.

    Puoi specificare il prefisso del report da utilizzare per i report sull'utilizzo. I report sull'utilizzo hanno quindi nomi di file che contengono questo prefisso. Ad esempio, se specifichi "my-cool-project-report" come prefisso del report, il nome del file sarà simile al formato my-cool-project-report_1234567890_20131230.csv. Se non specifichi un prefisso per i report, viene utilizzato il prefisso predefinito usage_gce.

Dopo aver scelto queste due proprietà, puoi attivare la funzionalità di esportazione dell'utilizzo nei seguenti modi:

Console

  1. Vai alla pagina Impostazioni Compute Engine.

    Vai a Impostazioni Compute Engine.

  2. Seleziona la casella Attiva esportazione dell'utilizzo.

  3. Compila il campo che richiede un nome del bucket. Se vuoi, fornisci un prefisso per i report. Se lasci vuoto il prefisso del report, viene utilizzato il prefisso predefinito usage_gce. Tutti i report sull'utilizzo inviati al separato vengono denominati con questo prefisso.

  4. Fai clic su Salva.

gcloud

In gcloud compute, utilizza il comando gcloud compute project-info set-usage-bucket per attivare questa funzionalità:

 gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]

Dove:

  • [BUCKET_NAME] è il nome di un bucket esistente in cui ricevere i report sull'utilizzo. Deve essere nel formato gs://<bucket-name> o https://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.

Python

Per attivare le esportazioni dell'utilizzo, utilizza il metodo set_usage_export_bucket() nella raccolta Projects. L'esempio seguente utilizza le librerie client di Cloud per Python:

from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1




def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def set_usage_export_bucket(
    project_id: str, bucket_name: str, report_name_prefix: str = ""
) -> None:
    """
    Set Compute Engine usage export bucket for the Cloud project.
    This sample presents how to interpret the default value for the
    report name prefix parameter.

    Args:
        project_id: project ID or project number of the project to update.
        bucket_name: Google Cloud Storage bucket used to store Compute Engine
            usage reports. An existing Google Cloud Storage bucket is required.
        report_name_prefix: Prefix of the usage report name which defaults to an empty string
            to showcase default values behaviour.
    """
    usage_export_location = compute_v1.UsageExportLocation()
    usage_export_location.bucket_name = bucket_name
    usage_export_location.report_name_prefix = report_name_prefix

    if not report_name_prefix:
        # Sending an empty value for report_name_prefix results in the
        # next usage report being generated with the default prefix value
        # "usage_gce". (ref: https://cloud.google.com/compute/docs/reference/rest/v1/projects/setUsageExportBucket)
        print(
            "Setting report_name_prefix to empty value causes the report "
            "to have the default prefix of `usage_gce`."
        )

    projects_client = compute_v1.ProjectsClient()
    operation = projects_client.set_usage_export_bucket(
        project=project_id, usage_export_location_resource=usage_export_location
    )

    wait_for_extended_operation(operation, "setting GCE usage bucket")

Per saperne di più, consulta la documentazione di riferimento dell'API per projects.setUsageExportBucket

Scaricare i report sull'esportazione dell'utilizzo

Dopo aver iniziato a ricevere i report sull'utilizzo nel tuo bucket, scaricali come faresti con altri oggetti da Cloud Storage. Per ulteriori informazioni, consulta Scaricare gli oggetti.

Metriche supportate

I report sull'utilizzo giornaliero forniscono informazioni sull'utilizzo delle seguenti risorse:

  • Macchine virtuali
  • Dischi permanenti
  • Immagini
  • Snapshot
  • Indirizzi IP statici
  • Bilanciatori del carico
  • Prenotazioni

Ogni risorsa è descritta utilizzando le seguenti metriche:

Nome metrica Proprietà metrica
Data report
  • Tipo di metrica: stringa
  • Descrizione: la data di utilizzo.
  • Esempio: 2019-08-15
MeasurementId
  • Tipo di metrica: stringa
  • Descrizione: l'ID del tipo di risorsa misurata.
    Ad esempio, VmimageN2StandardCore_Uswest2 per rappresentare un n2-standard nel tipo di macchina us-west2.
  • Esempio: com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
  • Esempio: com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
Quantità
  • Tipo di metrica: numero intero
  • Descrizione: la quantità di utilizzo per la data specificata.
  • Esempio: 86400
Unità
  • Tipo di metrica: stringa
  • Descrizione: il tipo di unità, ad esempio conteggio, secondi, ore e così via.
  • Esempio: secondi
URI risorsa
  • Tipo di metrica: stringa
  • Descrizione: l'URI della risorsa specificata.
  • Esempio: https://compute.googleapis.com/compute/v1/projects/<project‑id>/zones/<zone>/instances/<instance>
ID risorsa
  • Tipo di metrica: numero intero
  • Descrizione: un ID numerico che identifica la risorsa specifica.
  • Esempio: 16557630484925648021
Località
  • Tipo di metrica: stringa
  • Descrizione: la posizione della risorsa. Il nome di una zona o regione oppure GLOBAL per le risorse globali.
  • Esempio: us-central1-a

Un esempio di voce nel report è il seguente:

Data report MeasurementId Quantità Unità URI risorsa ID risorsa Località
02/13/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 degli accessi

Quando attivi la funzionalità di esportazione dell'utilizzo per un bucket Cloud Storage, Compute Engine si aggiunge automaticamente al bucket con accesso in scrittura per generare 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 di utilizzo nel bucket Cloud Storage specificato.

Puoi identificare che Compute Engine ha accesso a un bucket se visualizza la seguente identità aggiunta al criterio IAM del bucket:

cloud-cluster-analytics-export@google.com

Qualsiasi utente che è proprietario del progetto ha accesso completo al bucket Cloud Storage. Altri utenti, come autori e lettori, hanno diversi gradi di accesso al bucket. Per informazioni su IAM per un bucket, consulta IAM per Cloud Storage.

Se disattivi la funzionalità di esportazione dell'utilizzo, Compute Engine rimuove automaticamente l'accesso in scrittura da Compute Engine al bucket. Se modifichi le autorizzazioni per l'account cloud-cluster-analytics-export@google.com e poi disattivi la funzionalità di esportazione dell'utilizzo, Compute Engine disattiva la funzionalità, ma non rimuove l'account dall'elenco di accesso del progetto. Se vuoi, puoi scegliere di rimuovere l'account manualmente.

Verificare se i report sull'utilizzo sono attivi

Puoi controllare le impostazioni di esportazione dei dati sull'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      |                                                    |
+-------------------------+----------------------------------------------------+

Disattivare i report sull'utilizzo

Quando disattivi i report sull'utilizzo, Compute Engine rimuove automaticamente l'accesso in scrittura di Compute Engine al tuo bucket Cloud Storage e interrompe l'invio di nuovi report.

Console

  1. Vai alla pagina Impostazioni Compute Engine.

    Vai a Impostazioni Compute Engine.

  2. Deseleziona la casella Abilita esportazione dell'utilizzo per disattivare l'esportazione dell'utilizzo.

gcloud

In gcloud compute, disattiva la funzionalità di esportazione dell'utilizzo eseguendo il comando gcloud compute project-info set-usage-bucket con il flag --no-bucket:

gcloud compute project-info set-usage-bucket --no-bucket

Python

Per disattivare le esportazioni di utilizzo, utilizza il metodo set_usage_export_bucket() nella raccolta Projects con usage_export_location_resource impostato su None. Il seguente esempio utilizza le librerie client di Cloud per Python:

from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1




def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def disable_usage_export(project_id: str) -> None:
    """
    Disable Compute Engine usage export bucket for the Cloud Project.

    Args:
        project_id: project ID or project number of the project to update.
    """
    projects_client = compute_v1.ProjectsClient()

    # Setting `usage_export_location_resource` to an
    # empty object will disable the usage report generation.
    operation = projects_client.set_usage_export_bucket(
        project=project_id, usage_export_location_resource={}
    )

    wait_for_extended_operation(operation, "disabling GCE usage bucket")

Passaggi successivi