Visualizzazione dei rapporti di utilizzo

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 tue risorse. Ad esempio, puoi vedere quante istanze VM nel tuo progetto eseguono un tipo di macchina n2-standard-4 e per quanto tempo è stata in esecuzione ogni istanza. Puoi anche esaminare lo spazio di archiviazione di un disco permanente e le informazioni su altre funzionalità di Compute Engine.

I report sull'utilizzo non forniscono informazioni sulla fatturazione o sull'attività, ad esempio informazioni sulle richieste API. Per informazioni sulla fatturazione, consulta la funzionalità Esportare i dati di fatturazione Cloud in BigQuery. Per un registro delle attività e degli accessi amministrativi all'interno delle tue risorseGoogle Cloud , consulta gli audit log.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  Python

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

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

     gcloud init

  4. 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.

     If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

Panoramica

Quando abiliti i report di utilizzo, Compute Engine fornisce due tipi di report al bucket Cloud Storage che specifichi:

1. Report sull'utilizzo giornaliero

   Questi report vengono inviati giornalmente 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 o riscrive il file di 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>/<reportprefix><numeric_projectid><YYYYMMDD>.csv
    

2. Report raggruppato mensile

   Ogni giorno viene generato un unico report cumulativo mensile, che contiene i dati di utilizzo mensili per il progetto fino a quel 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. Esiste un solo file di dati di utilizzo mensile per progetto al mese.

   I report cumulativi mensili hanno il seguente formato del nome:

    <bucket>/<reportprefix><numeric_projectid><YYYYMM>.csv
    

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

Tutti i report sull'utilizzo vengono forniti in formato CSV (valori separati da virgola) e i file dei report sull'utilizzo hanno il prefisso <report_prefix>. <report_prefix> è un valore personalizzabile scelto dall'utente. Se non specifica un prefisso del report, viene utilizzato il prefisso usage_gce per impostazione predefinita. 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:

• Devi aver già creato un bucket per archiviare i log di utilizzo.

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 riporta i dettagli dell'utilizzo del giorno precedente. Successivamente, riceverai i report a intervalli di 24 ore.

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 di poter iniziare a esportare i report e devi disporre dell'accesso di proprietario al bucket. Cloud Storage addebita l'utilizzo, pertanto devi 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 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.

2. Il prefisso del report per i tuoi file.

   Puoi specificare il prefisso del report da utilizzare per i report sull'utilizzo. I report sull'utilizzo hanno quindi nomi 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 del 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:

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

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")

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 maggiori informazioni, vedi Scaricare 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:

Una voce di esempio nel report avrebbe il seguente aspetto:

Controllo degli accessi

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 di 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 vedi la seguente identità aggiunta alla policy IAM del bucket:

cloud-cluster-analytics-export@google.com

Qualsiasi utente proprietario del progetto ha accesso completo al bucket Cloud Storage. Altri utenti, come autori e lettori, hanno diversi livelli di accesso al bucket. Per scoprire di più 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à di esportazione dell'utilizzo, ma non rimuove l'account dall'elenco di accesso al progetto. Puoi rimuovere l'account manualmente.

Verifica dell'abilitazione dei report sull'utilizzo

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      |                                                    |
+-------------------------+----------------------------------------------------+

Disattivare i report sull'utilizzo

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

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

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

• Attiva la funzionalità di esportazione dei dati di fatturazione Cloud in BigQuery per visualizzare i log di fatturazione.
• Tieni traccia dell'attività nel tuo progetto utilizzando Cloud Audit Logs.
• Scopri di più sui bucket Cloud Storage.
• Utilizza il Calcolatore prezzi per ottenere una stima del prezzo.