Com o Compute Engine, é possível exportar relatórios detalhados do uso dessa plataforma para um bucket do Cloud Storage utilizando o recurso correspondente. Os relatórios de uso fornecem informações sobre a duração dos seus recursos. Por exemplo, é possível ver quantas instâncias de VM no
projeto estão executando um tipo de máquina n2-standard-4
e há quanto tempo cada
instância está em execução. Também é possível revisar o espaço de armazenamento de um disco permanente
e informações sobre outros recursos do Compute Engine.
Relatórios de uso não fornecem informações de faturamento nem de atividade, como informações sobre solicitações de API. Para ver informações de faturamento, consulte o recurso Exportação de faturamento. Para registros de atividades, consulte Registros de atividades.
Antes de começar
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
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
-
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.
Relatórios de uso diário
Esses relatórios são enviados diariamente e incluem dados de uso do dia anterior. Cada relatório é um arquivo separado que contém os dados do último período. Os dados nesses relatórios são imutáveis, o que significa que o Compute Engine não atualizará nem regravará o arquivo de registro em caso de imprecisões. Em vez disso, os dados serão corrigidos no próximo relatório novo que for enviado ao bucket.
Relatórios de uso diário têm o seguinte formato de nome:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv
Relatório cumulativo mensal
Um único relatório cumulativo mensal é enviado diariamente, contendo dados mensais de uso para o projeto até o dia, sem incluí-lo. O relatório de uso mensal é substituído a cada dia com novos dados que refletem o uso mensal de recursos até aquela data. Há apenas um arquivo de dados de uso mensal por projeto e por mês.
Relatórios cumulativos mensais têm o formato de nome a seguir:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv
Os arquivos de relatórios diário e mensal são muito parecidos, exceto pela diferença no formato da data. 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 o dia (YYYYMMDD
).- É preciso já ter criado um bucket para armazenar registros de uso.
O bucket do Google Cloud Storage para onde quer que os relatórios sejam enviados.
É possível selecionar qualquer bucket do Cloud Storage de que seja proprietário, incluindo buckets de projetos diferentes. Esse bucket deve existir antes que você possa começar a exportar relatórios. Além disso, você deve ter acesso de proprietário no bucket. O Cloud Storage cobra pelo uso, portanto, revise os preços do Cloud Storage para informações sobre como pode ser que você receba cobranças pelo serviço.
Qualquer usuário com acesso de leitura ao bucket do Cloud Storage pode visualizar os relatórios de uso contidos nele. Qualquer usuário com acesso de gravação ao bucket pode criar, ver e modificar os arquivos que estão nele. Para mais informações, consulte a seção Controle de acesso.
O prefixo de relatório dos arquivos.
Você pode especificar o prefixo de relatório para os seus relatórios de uso. Os relatórios de uso terão nomes de arquivo contendo esse prefixo. Por exemplo, especificar "my-cool-project-report" como o prefixo de relatório resulta em um nome de arquivo semelhante a
my-cool-project-report_1234567890_20131230.csv
. Se você não especificar um prefixo de relatório, será usado o prefixo padrãousage_gce
.Acesse a página Configurações do Compute Engine (em inglês)
Marque a caixa Ativar exportação de uso.
Preencha o campo que solicita um Nome do bucket. Se quiser, forneça um Prefixo do relatório. Se você não informar o prefixo de relatório, será usado o prefixo padrão
usage_gce
. Todos os relatórios de uso entregues ao bucket são nomeados com esse prefixo.Clique em Save.
[BUCKET_NAME]
é o nome de um bucket atual para receber os relatórios de uso. Precisa estar no formatogs://<bucket-name>
ouhttps://storage.googleapis.com/<bucket-name>
. O usuário que executa esse comando precisa ser um 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: 2019-08-15
- Tipo da métrica: string
-
Descrição: o ID do tipo de recurso que está sendo medido.
Por exemplo,VmimageN2StandardCore_Uswest2
para representar umn2-standard
no tipo de máquinaus-west2
. -
Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
-
Exemplo:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- Tipo da métrica: inteiro
- Descrição: a quantidade de uso na data especificada.
- Exemplo: 86400
- Tipo da métrica: string
- Descrição: o tipo de unidade, como contagem, segundos, horas e assim por diante.
- Exemplo: segundos
- Tipo de métrica: string
- Descrição: o URI do recurso especificado
- Exemplo:
https://compute.googleapis.com/compute/v1/projects/<project‑id>/zones/<zone>/instances/<instance>
- Tipo da 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. Pode ser o nome da zona ou da região, ou
GLOBAL
para recursos globais. - Exemplo:
us-central1-a
Acesse a página Configurações do Compute Engine (em inglês)
Desmarque a caixa Ativar exportação de uso para desativar essa função.
- Ative o recurso de exportação de faturamento para ver seus registros de faturamento.
- Acompanhe a atividade no seu projeto usando registros de atividades.
- Saiba mais sobre os buckets do Cloud Storage.
- Saiba mais sobre os preços do Compute Engine.
- Use a calculadora de preços para ter uma estimativa do preço.
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.
Informações gerais
Ao ativar os relatórios de uso, o Compute Engine envia dois tipos de relatórios para o bucket do Google Cloud Storage que você especificar:
Todos os relatórios de uso são enviados no formato de valores separados por vírgulas (CSV, na sigla em inglês, link em inglês), e os arquivos de relatório de uso recebem o prefixo
<report_prefix>
.<report_prefix>
é um valor personalizá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 indicados no horário do Pacífico (PST, na sigla em inglês).Pré-requisitos
Antes de começar a utilizar a exportação de uso do Compute Engine, faça o seguinte:
Como configurar a exportação de uso
Quando você ativar o recurso de exportação de uso, o primeiro relatório será enviado no dia seguinte detalhando o uso do dia anterior. Depois disso, você receberá relatórios em intervalos de 24 horas.
Para configurar o recurso de exportação de uso, ative-o na ferramenta
gcloud compute
Ao ativar esse recurso, você precisa definir duas propriedades:Depois de decidir sobre essas duas propriedades, você poderá ativar o recurso de exportação de uso das seguintes formas:
Console
gcloud
Em
gcloud compute
, use o comandogcloud compute project-info set-usage-bucket
para ativar este recurso:gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]
Em que:
Python
Para ativar as 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 mais informações, consulte a documentação de referência da API para
projects.setUsageExportBucket
.Como fazer o download de relatórios de exportação de uso
Após começar a receber relatórios de uso no bucket, faça download dos relatórios da maneira que faria com outros objetos do Cloud Storage. Para mais informações, consulte Como fazer o download de objetos.
Métricas compatíveis
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 da métrica Report Date MeasurementId Quantity Unit Resource URI ResourceId Location Este é um exemplo de entrada no relatório:
Report Date MeasurementId Quantity Unit Resource URI Resource ID Location 02/13/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 seconds https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a Controle de acesso
Ao ativar o recurso de exportação de uso para um bucket do Cloud Storage, o Compute Engine automaticamente adiciona a si mesmo ao bucket para enviar 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á a exportar relatórios de uso para o bucket especificado do Cloud Storage.
Para identificar que o Compute Engine tem acesso a um bucket, você verá a seguinte identidade adicionada à política de IAM do bucket:
cloud-cluster-analytics-export@google.com
Qualquer usuário que seja proprietário do projeto tem acesso completo ao bucket do Google Cloud Storage. Outros usuários, como gravadores e leitores, têm diferentes graus de acesso ao bucket. Para saber mais sobre o IAM para um bucket, leia IAM para o 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 no 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. Se você quiser, poderá remover a conta manualmente.
Como verificar se os relatórios de uso estão ativados
Você pode verificar as configurações de exportação de uso de um projeto nas informações dele:
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 | | +-------------------------+----------------------------------------------------+
Como desativar relatórios de uso
Ao desativar os relatórios de uso, o Compute Engine automaticamente remove o acesso de gravação do Compute Engine ao seu bucket do Cloud Storage e interrompe o envio de novos relatórios.
Console
gcloud
Em
gcloud compute
, para desativar o recurso de exportação de uso, execute o comandogcloud compute project-info set-usage-bucket
com a sinalização--no-bucket
:gcloud compute project-info set-usage-bucket --no-bucket
Python
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: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 2024-09-03 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 na tradução" },{ "type": "thumb-down", "id": "otherDown", "label":"Outro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de entender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Meu problema foi resolvido" },{ "type": "thumb-up", "id": "otherUp", "label":"Outro" }] -