O Compute Engine permite exportar relatórios detalhados do uso do Compute Engine para um bucket do Cloud Storage usando o recurso de exportação de uso. Os relatórios de uso fornecem informações sobre a vida útil dos seus recursos. Por exemplo, você pode ver quantas instâncias de VM em seu projeto estão executando um tipo de máquina n2-standard-4
e há quanto tempo cada instância está em execução. Você também pode analisar o espaço de armazenamento de um disco permanente e informações sobre outros recursos do Compute Engine.
Os relatórios de uso não fornecem informações de faturamento ou atividades, como informações sobre solicitações de API. Para informações de faturamento, consulte o recurso Exportar dados do Cloud Billing para o BigQuery . Para um registro das atividades administrativas e acessos dentro do seuGoogle Cloud recursos, consulte Logs de auditoria .
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
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
-
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.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
Relatórios de uso diário
Esses relatórios são entregues diariamente e incluem dados de uso do dia anterior. Cada relatório é um arquivo separado que contém dados do último período. Os dados nesses relatórios são imutáveis, o que significa que o Compute Engine não atualiza nem reescreve o arquivo de log se houver imprecisões. Em vez disso, os dados são corrigidos no próximo novo relatório entregue ao bucket.
Os relatórios de uso diário têm o seguinte formato de nome:
<bucket>/<reportprefix><numeric_projectid><YYYYMMDD>.csv
Relatório cumulativo mensal
Um único relatório cumulativo mensal é entregue diariamente, contendo dados de uso mensal desse projeto até, mas não incluindo, aquele dia. O relatório de utilização mensal é substituído todos os dias por novos dados que refletem a utilização mensal de recursos até essa data. Existe apenas um arquivo de dados de uso mensal por projeto, por mês.
Os relatórios cumulativos mensais têm o seguinte formato de nome:
<bucket>/<reportprefix><numeric_projectid><YYYYMM>.csv
Os arquivos de relatório diário e mensal são muito semelhantes, exceto pela diferença no formato de data, onde os relatórios cumulativos mensais são datados usando o ano e o mês (
YYYYMM
) e os relatórios de uso diário são datados usando o ano, o mês e a data (YYYYMMDD
).- Você já deve ter criado um bucket para armazenar logs de uso.
O bucket do Cloud Storage onde você gostaria que seus relatórios fossem entregues.
Você pode selecionar qualquer bucket do Cloud Storage do qual você seja proprietário, incluindo buckets de projetos diferentes. Esse bucket deve existir antes que você possa começar a exportar relatórios e você deve ter acesso de proprietário ao bucket. O Cloud Storage cobra pelo uso, portanto, você deve revisar os preços do Cloud Storage para obter informações sobre como você pode incorrer em cobranças pelo serviço.
Qualquer usuário que tenha acesso de leitura ao bucket do Cloud Storage pode visualizar os relatórios de uso no bucket. Qualquer usuário que tenha acesso de gravação ao bucket pode criar, visualizar e modificar arquivos existentes no bucket. Para obter mais informações, consulte a seção Controle de acesso .
O prefixo do relatório para seus arquivos.
Você pode especificar o prefixo do relatório a ser usado em seus relatórios de uso. Seus relatórios de uso terão nomes de arquivos que contêm esse prefixo. Por exemplo, especificar "my-cool-project-report" como prefixo do relatório resulta em um nome de arquivo semelhante ao formato
my-cool-project-report_1234567890_20131230.csv
. Se você não especificar um prefixo de relatório, o prefixo padrãousage_gce
será usado.Acesse a página Configurações do Compute Engine .
Marque a caixa Habilitar exportação de uso .
Preencha o campo solicitando um nome de bucket . Opcionalmente, forneça um prefixo de relatório . Se você deixar o prefixo do relatório vazio, o prefixo padrão
usage_gce
será usado. Todos os relatórios de uso entregues ao bucket são nomeados com esse prefixo.Clique em Salvar .
-
BUCKET_NAME
é o nome de um bucket existente para receber os relatórios de uso. O nome deve estar no formatogs:// bucket-name
ouhttps://storage.googleapis.com/ bucket-name
. O usuário que executa este comando deve ser proprietário do bucket. -
PREFIX
é o prefixo opcional para os nomes dos relatórios de uso. Se não for especificado, o prefixo padrão seráusage_gce
. - Máquinas virtuais
- Discos permanentes
- Imagens
- Instantâneos
- Endereços IP estáticos
- Balanceadores de carga
- Reservas
- Tipo de métrica: string
- Descrição: A data do uso.
- Exemplo: 15/08/2019
- Tipo de métrica: string
- Descrição: O ID do tipo de recurso que está sendo medido.
Por exemplo,VmimageN2StandardCore_Uswest2
para representar um tipo de máquinan2-standard
emus-west2
. - Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
- Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- Tipo de métrica: inteiro
- Descrição: A quantidade de uso para a data especificada.
- Exemplo: 86400
- Tipo de métrica: string
- Descrição: O tipo de unidade, como contagem, segundos ou horas.
- Exemplo: segundos
- Tipo de métrica: string
- Descrição: O URI do recurso especificado.
- Exemplo:
https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-n2-vm
- Tipo de métrica: inteiro
- Descrição: um ID numérico que identifica o recurso específico.
- Exemplo: 16557630484925648021
- Tipo de métrica: string
- Descrição: A localização do recurso. Um nome de zona ou região ou
GLOBAL
para recursos globais. - Exemplo:
us-central1-a
Acesse a página Configurações do Compute Engine .
Desmarque a caixa Habilitar exportação de uso para desabilitar a exportação de uso.
- Ative o recurso Exportar dados do Cloud Billing para o BigQuery para visualizar seus registros de faturamento.
- Acompanhe a atividade no seu projeto usando os registros de auditoria do Cloud .
- Saiba mais sobre os intervalos do Cloud Storage .
- Use a calculadora de preços para obter um preço estimado.
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
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
-
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.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
Relatórios de uso diário
Esses relatórios são entregues diariamente e incluem dados de uso do dia anterior. Cada relatório é um arquivo separado que contém dados do último período. Os dados nesses relatórios são imutáveis, o que significa que o Compute Engine não atualiza nem reescreve o arquivo de log se houver imprecisões. Em vez disso, os dados são corrigidos no próximo novo relatório entregue ao bucket.
Os relatórios de uso diário têm o seguinte formato de nome:
<bucket>/<reportprefix><numeric_projectid><YYYYMMDD>.csv
Relatório cumulativo mensal
Um único relatório cumulativo mensal é entregue diariamente, contendo dados de uso mensal desse projeto até, mas não incluindo, aquele dia. O relatório de utilização mensal é substituído todos os dias por novos dados que refletem a utilização mensal de recursos até essa data. Existe apenas um arquivo de dados de uso mensal por projeto, por mês.
Os relatórios cumulativos mensais têm o seguinte formato de nome:
<bucket>/<reportprefix><numeric_projectid><YYYYMM>.csv
Os arquivos de relatório diário e mensal são muito semelhantes, exceto pela diferença no formato de data, onde os relatórios cumulativos mensais são datados usando o ano e o mês (
YYYYMM
) e os relatórios de uso diário são datados usando o ano, o mês e a data (YYYYMMDD
).- Você já deve ter criado um bucket para armazenar logs de uso.
O bucket do Cloud Storage onde você gostaria que seus relatórios fossem entregues.
Você pode selecionar qualquer bucket do Cloud Storage do qual você seja proprietário, incluindo buckets de projetos diferentes. Esse bucket deve existir antes que você possa começar a exportar relatórios e você deve ter acesso de proprietário ao bucket. O Cloud Storage cobra pelo uso, portanto, você deve revisar os preços do Cloud Storage para obter informações sobre como você pode incorrer em cobranças pelo serviço.
Qualquer usuário que tenha acesso de leitura ao bucket do Cloud Storage pode visualizar os relatórios de uso no bucket. Qualquer usuário que tenha acesso de gravação ao bucket pode criar, visualizar e modificar arquivos existentes no bucket. Para obter mais informações, consulte a seção Controle de acesso .
O prefixo do relatório para seus arquivos.
Você pode especificar o prefixo do relatório a ser usado em seus relatórios de uso. Seus relatórios de uso terão nomes de arquivos que contêm esse prefixo. Por exemplo, especificar "my-cool-project-report" como prefixo do relatório resulta em um nome de arquivo semelhante ao formato
my-cool-project-report_1234567890_20131230.csv
. Se você não especificar um prefixo de relatório, o prefixo padrãousage_gce
será usado.Acesse a página Configurações do Compute Engine .
Marque a caixa Habilitar exportação de uso .
Preencha o campo solicitando um nome de bucket . Opcionalmente, forneça um prefixo de relatório . Se você deixar o prefixo do relatório vazio, o prefixo padrão
usage_gce
será usado. Todos os relatórios de uso entregues ao bucket são nomeados com esse prefixo.Clique em Salvar .
-
BUCKET_NAME
é o nome de um bucket existente para receber os relatórios de uso. O nome deve estar no formatogs:// bucket-name
ouhttps://storage.googleapis.com/ bucket-name
. O usuário que executa este comando deve ser proprietário do bucket. -
PREFIX
é o prefixo opcional para os nomes dos relatórios de uso. Se não for especificado, o prefixo padrão seráusage_gce
. - Máquinas virtuais
- Discos permanentes
- Imagens
- Instantâneos
- Endereços IP estáticos
- Balanceadores de carga
- Reservas
- Tipo de métrica: string
- Descrição: A data do uso.
- Exemplo: 15/08/2019
- Tipo de métrica: string
- Descrição: O ID do tipo de recurso que está sendo medido.
Por exemplo,VmimageN2StandardCore_Uswest2
para representar um tipo de máquinan2-standard
emus-west2
. - Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
- Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- Tipo de métrica: inteiro
- Descrição: A quantidade de uso para a data especificada.
- Exemplo: 86400
- Tipo de métrica: string
- Descrição: O tipo de unidade, como contagem, segundos ou horas.
- Exemplo: segundos
- Tipo de métrica: string
- Descrição: O URI do recurso especificado.
- Exemplo:
https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-n2-vm
- Tipo de métrica: inteiro
- Descrição: um ID numérico que identifica o recurso específico.
- Exemplo: 16557630484925648021
- Tipo de métrica: string
- Descrição: A localização do recurso. Um nome de zona ou região ou
GLOBAL
para recursos globais. - Exemplo:
us-central1-a
Acesse a página Configurações do Compute Engine .
Desmarque a caixa Habilitar exportação de uso para desabilitar a exportação de uso.
- Ative o recurso Exportar dados do Cloud Billing para o BigQuery para visualizar seus registros de faturamento.
- Acompanhe a atividade no seu projeto usando os registros de auditoria do Cloud .
- Saiba mais sobre os intervalos do Cloud Storage .
- Use a calculadora de preços para obter um preço estimado.
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Visão geral
Quando você ativa relatórios de uso, o Compute Engine fornece dois tipos de relatórios para o bucket do Cloud Storage especificado:
Todos os relatórios de uso são entregues em formato de valores separados por vírgula (CSV) e os arquivos de relatório de uso são prefixados usando
<report_prefix>
. O<report_prefix>
é um valor customizável escolhido pelo usuário. Se você não especificar um prefixo de relatório, o prefixousage_gce
será usado por padrão. Todos os horários são fornecidos no horário do Pacífico (PST).Pré-requisitos
Antes de começar a usar a exportação de uso do Compute Engine:
Configurando a exportação de uso
Quando você ativa o recurso de exportação de uso pela primeira vez, o primeiro relatório é enviado no dia seguinte, detalhando o uso do dia anterior. Depois, você recebe relatórios em intervalos de 24 horas.
Ao ativar esse recurso, você deve definir duas propriedades:
Depois de decidir sobre essas duas propriedades, você poderá ativar o recurso de exportação de uso das seguintes maneiras:
Console
gcloud
Use o comando
gcloud compute project-info set-usage-bucket
para ativar este recurso:gcloud compute project-info set-usage-bucket --bucket BUCKET_NAME --prefix PREFIX
Substitua o seguinte:
Pitão
Para habilitar exportações de uso, use o método
set_usage_export_bucket()
na coleçãoProjects
. O exemplo a seguir usa as bibliotecas de cliente do Cloud para Python:Para obter mais informações, consulte a documentação de referência REST para
projects.setUsageExportBucket
Fazendo download de relatórios de exportação de uso
Depois de começar a receber relatórios de uso no bucket, faça download dos relatórios como faria com outros objetos do Cloud Storage. Para obter mais informações, consulte Baixar objetos .
Métricas suportadas
Os relatórios de uso diário fornecem informações de uso sobre os seguintes recursos:
Cada recurso é descrito usando as seguintes métricas:
Nome da métrica Propriedades métricas Data do relatório ID de medição Quantidade Unidade URI do recurso ID do recurso Localização Um exemplo de entrada no relatório seria semelhante ao seguinte:
Data do relatório ID de medição Quantidade Unidade URI do recurso ID do recurso Localização 13/02/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 segundos https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a Controle de acesso
Quando você ativa o recurso de exportação de uso para um bucket do Cloud Storage, o Compute Engine se adiciona automaticamente ao bucket com acesso de gravação para fornecer relatórios de uso. Enquanto o Compute Engine tiver acesso ao bucket e o recurso de exportação de uso estiver ativado, o Compute Engine continuará exportando relatórios de uso para o bucket especificado do Cloud Storage.
Você poderá identificar que o Compute Engine tem acesso a um bucket se vir a seguinte identidade adicionada à política do IAM do bucket:
cloud-cluster-analytics-export@google.com
Qualquer usuário proprietário do projeto tem acesso total ao intervalo do Cloud Storage. Outros usuários, como escritores e leitores, têm diferentes graus de acesso ao bucket. Para saber mais sobre o IAM para um bucket, leia IAM para Cloud Storage .
Se você desativar o recurso de exportação de uso, o Compute Engine removerá automaticamente o acesso de gravação do Compute Engine para o bucket. Se você modificar as permissões na conta
cloud-cluster-analytics-export@google.com
e desativar o recurso de exportação de uso, o Compute Engine desativará o recurso de exportação de uso, mas não removerá a conta da lista de acesso do projeto. Você pode remover a conta manualmente.Verificando se os relatórios de uso estão ativados
Você pode verificar as configurações de exportação de uso de um projeto obtendo informações sobre o projeto:
gcloud compute project-info describe
Procure o 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 | | +-------------------------+----------------------------------------------------+
Desativando relatórios de uso
Quando você desativa os relatórios de uso, o Compute Engine remove automaticamente o acesso de gravação do Compute Engine ao bucket do Cloud Storage e interrompe o envio de novos relatórios.
Console
gcloud
Desative o recurso de exportação de uso usando o comando
gcloud compute project-info set-usage-bucket
com a sinalização--no-bucket
:gcloud compute project-info set-usage-bucket --no-bucket
Pitão
Para desativar as exportações de uso, use o método
set_usage_export_bucket()
na coleçãoProjects
comusage_export_location_resource
definido comoNone
. O exemplo a seguir usa as bibliotecas de cliente do Cloud para Python:O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Visão geral
Quando você ativa relatórios de uso, o Compute Engine fornece dois tipos de relatórios para o bucket do Cloud Storage especificado:
Todos os relatórios de uso são entregues em formato de valores separados por vírgula (CSV) e os arquivos de relatório de uso são prefixados usando
<report_prefix>
. O<report_prefix>
é um valor customizável escolhido pelo usuário. Se você não especificar um prefixo de relatório, o prefixousage_gce
será usado por padrão. Todos os horários são fornecidos no horário do Pacífico (PST).Pré-requisitos
Antes de começar a usar a exportação de uso do Compute Engine:
Configurando a exportação de uso
Quando você ativa o recurso de exportação de uso pela primeira vez, o primeiro relatório é enviado no dia seguinte, detalhando o uso do dia anterior. Depois, você recebe relatórios em intervalos de 24 horas.
Ao ativar esse recurso, você deve definir duas propriedades:
Depois de decidir sobre essas duas propriedades, você poderá ativar o recurso de exportação de uso das seguintes maneiras:
Console
gcloud
Use o comando
gcloud compute project-info set-usage-bucket
para ativar este recurso:gcloud compute project-info set-usage-bucket --bucket BUCKET_NAME --prefix PREFIX
Substitua o seguinte:
Pitão
Para habilitar exportações de uso, use o método
set_usage_export_bucket()
na coleçãoProjects
. O exemplo a seguir usa as bibliotecas de cliente do Cloud para Python:Para obter mais informações, consulte a documentação de referência REST para
projects.setUsageExportBucket
Fazendo download de relatórios de exportação de uso
Depois de começar a receber relatórios de uso no bucket, faça download dos relatórios como faria com outros objetos do Cloud Storage. Para obter mais informações, consulte Baixar objetos .
Métricas suportadas
Os relatórios de uso diário fornecem informações de uso sobre os seguintes recursos:
Cada recurso é descrito usando as seguintes métricas:
Nome da métrica Propriedades métricas Data do relatório ID de medição Quantidade Unidade URI do recurso ID do recurso Localização Um exemplo de entrada no relatório seria semelhante ao seguinte:
Data do relatório ID de medição Quantidade Unidade URI do recurso ID do recurso Localização 13/02/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 segundos https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a Controle de acesso
Quando você ativa o recurso de exportação de uso para um bucket do Cloud Storage, o Compute Engine se adiciona automaticamente ao bucket com acesso de gravação para fornecer relatórios de uso. Enquanto o Compute Engine tiver acesso ao bucket e o recurso de exportação de uso estiver ativado, o Compute Engine continuará exportando relatórios de uso para o bucket especificado do Cloud Storage.
Você poderá identificar que o Compute Engine tem acesso a um bucket se vir a seguinte identidade adicionada à política do IAM do bucket:
cloud-cluster-analytics-export@google.com
Qualquer usuário proprietário do projeto tem acesso total ao intervalo do Cloud Storage. Outros usuários, como escritores e leitores, têm diferentes graus de acesso ao bucket. Para saber mais sobre o IAM para um bucket, leia IAM para Cloud Storage .
Se você desativar o recurso de exportação de uso, o Compute Engine removerá automaticamente o acesso de gravação do Compute Engine para o bucket. Se você modificar as permissões na conta
cloud-cluster-analytics-export@google.com
e desativar o recurso de exportação de uso, o Compute Engine desativará o recurso de exportação de uso, mas não removerá a conta da lista de acesso do projeto. Você pode remover a conta manualmente.Verificando se os relatórios de uso estão ativados
Você pode verificar as configurações de exportação de uso de um projeto obtendo informações sobre o projeto:
gcloud compute project-info describe
Procure o 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 | | +-------------------------+----------------------------------------------------+
Desativando relatórios de uso
Quando você desativa os relatórios de uso, o Compute Engine remove automaticamente o acesso de gravação do Compute Engine ao bucket do Cloud Storage e interrompe o envio de novos relatórios.
Console
gcloud
Desative o recurso de exportação de uso usando o comando
gcloud compute project-info set-usage-bucket
com a sinalização--no-bucket
:gcloud compute project-info set-usage-bucket --no-bucket
Pitão
Para desabilitar as exportações de uso, use o método
set_usage_export_bucket()
na coleçãoProjects
comusage_export_location_resource
definido comoNone
. O exemplo a seguir usa as bibliotecas de cliente do Cloud para Python:O que vem a seguir
O Compute Engine permite exportar relatórios detalhados do uso do Compute Engine para um bucket do Cloud Storage usando o recurso de exportação de uso. Os relatórios de uso fornecem informações sobre a vida útil dos seus recursos. Por exemplo, você pode ver quantas instâncias de VM em seu projeto estão executando um tipo de máquina
n2-standard-4
e há quanto tempo cada instância está em execução. Você também pode analisar o espaço de armazenamento de um disco permanente e informações sobre outros recursos do Compute Engine.Os relatórios de uso não fornecem informações de faturamento ou atividades, como informações sobre solicitações de API. Para informações de faturamento, consulte o recurso Exportar dados do Cloud Billing para o BigQuery . Para um registro das atividades administrativas e acessos dentro do seuGoogle Cloud recursos, consulte Logs de auditoria .
Antes de começar
-