Definir orçamentos e alertas de orçamento

Crie orçamentos para monitorar todas as cobranças do Google Cloud em um único lugar e evite surpresas em sua conta. Depois de definir um valor de orçamento, configure as regras de alerta usadas para acionar notificações. Desse modo, você acompanha os gastos considerando seu orçamento.

É possível aplicar alertas de orçamento a uma Conta de faturamento do Cloud ou a um ou mais projetos e produtos. Também é possível determinar o orçamento com base em um valor específico ou em comparação aos gastos do mês anterior. Quando os custos (reais ou previstos) excedem uma porcentagem do seu orçamento, com base nas regras definidas, os e-mails de alerta são enviados aos administradores e usuários na Conta de faturamento do Cloud de destino. Ou seja, cada usuário recebe um papel de faturamento de roles/billing.admin ou roles/billing.user.

Permissões necessárias para gerenciar orçamentos

Para criar, modificar ou excluir orçamentos da sua Conta de faturamento do Cloud, você precisa ser o administrador da conta de faturamento.

Especificamente para executar essas tarefas, você precisa ter as seguintes permissões na Conta de faturamento do Cloud:

  • billing.budgets.create para criar um orçamento
  • billing.budgets.update para modificar um orçamento atual
  • billing.budgets.delete para excluir um orçamento

Se você for Visualizador da conta de faturamento, poderá visualizar orçamentos configurados na sua Conta de faturamento do Cloud, mas não adicionar, editar ou excluir orçamentos.

Criar um orçamento

O valor do orçamento definido é usado para calcular os limites que acionam o envio de e-mails e notificações de alerta. O orçamento não define um limite fixo de gastos.

Para criar um orçamento:

  1. Faça login no Console do Google Cloud.

    Fazer login no Console do Cloud

  2. Abra o Menu de navegação () do console e selecione Faturamento.

    Se você tiver mais de uma Conta de faturamento do Cloud, siga um destes procedimentos:

    • Para gerenciar o Faturamento do Cloud para o projeto atual, selecione Ir para a conta de faturamento vinculada.
    • Para localizar outra Conta de faturamento do Cloud, selecione Gerenciar contas de faturamento e escolha aquela em que você quer definir um orçamento.
  3. No menu de navegação de faturamento, selecione Orçamentos e alertas.

  4. Clique em CRIAR ORÇAMENTO.

  5. No campo Nome, insira um nome para o orçamento.

  6. Defina o Escopo do orçamento e clique em Próximo.

    Sobre o escopo do orçamento:

    O orçamento pode ser aplicado a toda a conta do Cloud Billing ou ser concentrado em um conjunto específico de recursos.

    1. Se você for um revendedor e sua Conta de faturamento do Cloud tiver subcontas, no campo Subcontas, selecione uma ou mais subcontas em que você quer aplicar o alerta de orçamento. Para aplicar o alerta de orçamento a todas as subcontas na Conta de faturamento do Cloud, escolha Selecionar tudo.
    2. No campo Projetos, selecione um ou mais projetos em que você quer aplicar o alerta de orçamento. Para aplicar o alerta de orçamento a todos os projetos na Conta de faturamento do Cloud, escolha Selecionar tudo.
    3. No campo Produtos, selecione um ou mais produtos em que você quer aplicar o alerta de orçamento. Para aplicar o alerta de orçamento a todos os produtos na Conta de faturamento do Cloud, escolha Selecionar tudo.
    4. No campo Rótulos, selecione um rótulo Chave e Valor em que você quer aplicar o alerta de orçamento. É possível aplicar apenas um rótulo por orçamento. Saiba mais sobre como criar e gerenciar rótulos de recursos.

  7. Defina um Valor de orçamento mensal e clique em Próximo.

    Sobre o valor do orçamento:

    1. Selecione o Tipo de orçamento:

      • Para definir um valor fixo de comparação do gasto mensal, escolha Valor especificado e insira o valor no campo Valor desejado.
      • Para segmentar um valor que é atualizado mensalmente com base no gasto do mês anterior, escolha Gasto do mês passado. Se você selecionar essa opção, o Valor desejado será atualizado automaticamente.
    2. Se preferir, ative Incluir créditos no custo.

      • Quando você inclui créditos no custo, o gasto é calculado como o custo total menos os créditos aplicáveis. Os créditos podem incluir descontos por uso, promoções e/ou concessões para usar o Google Cloud.
      • Se você quiser aplicar o valor do orçamento aos custos de uso do Google Cloud antes de aplicar qualquer crédito, desmarque essa opção.
  8. Defina as Ações do orçamento:

    • Definir regras de limite de alerta

      A finalidade básica da criação de orçamento é acionar o envio de e-mails quando um limite for atingido. Esses e-mails são enviados aos administradores e usuários do faturamento com base nas regras de limite definidas aqui.

      Para mais informações, siga para a próxima seção: Definir, editar ou remover regras de limite de alerta de orçamento.

    • Gerenciar notificações

      Além de usar as regras de limite para enviar um e-mail, é possível usá-las para acionar uma ação programática, como encaminhar mensagens de orçamento a outras mídias (como Slack) e automatizar tarefas de gerenciamento de custos, por exemplo, desativar o faturamento em um projeto quando ele exceder seu orçamento.

      Use as notificações do Pub/Sub para receber atualizações de gastos referentes a esse orçamento de modo programático.

      • Para gerenciar notificações de modo programático, conecte um tópico do Pub/Sub a esse orçamento.

      Para mais informações sobre esse recurso, consulte Gerenciar notificações programáticas.

  9. Para salvar o orçamento, clique em Concluir.

Definir, editar ou remover regras de limite de alertas de orçamento

O objetivo de criar um orçamento é que você possa ativar notificações de alerta que serão enviadas aos administradores do faturamento e aos usuários da conta de faturamento quando os custos excederem um percentual do orçamento ou um valor especificado. Depois de criar um orçamento, defina as regras de limite de alertas de orçamento. A quantidade de alertas pode ser acionada por custos reais* acumulados durante o período do orçamento ou por custos previstos (custos estimados calculados até o final do período do orçamento atual).

Para definir, editar ou remover regras de limite de alerta de orçamento:

  1. Se necessário, crie um orçamento conforme descrito anteriormente.
    Se preferir, modifique os alertas em um orçamento atual e abra o orçamento a ser atualizado:

    1. Faça login no Console do Google Cloud.

      Fazer login no Console do Cloud

    2. Abra o Menu de navegação () do console e selecione Faturamento.

      Se você tiver mais de uma Conta de faturamento do Cloud, siga um destes procedimentos:

      • Para gerenciar o Faturamento do Cloud para o projeto atual, selecione Ir para a conta de faturamento vinculada.
      • Para localizar outra Conta de faturamento do Cloud, selecione Gerenciar contas de faturamento e escolha aquela que tem os orçamentos que você quer gerenciar.
    3. No menu de navegação de faturamento, selecione Orçamentos e alertas e clique no nome do orçamento que você quer atualizar com as regras de limite de alerta.

  2. Role até a seção Ações da página Editar orçamento.

    • Quando você cria um orçamento pela primeira vez, os limites de alertas padrão são 50%, 90% e 100% do valor do orçamento, calculados em relação ao gasto real.
    • É possível modificar as porcentagens ou o valor especificado e o tipo de gasto, além de adicionar ou remover regras de limite de alerta.
  3. Em Porcentagem do orçamento, digite a porcentagem do orçamento que acionará o alerta. O valor de despesas correspondente será preenchido automaticamente. Como alternativa, insira o valor e a porcentagem será calculada para você.

  4. Em Acionador ativado, selecione gasto Real ou Previsto.

    • As regras de custo Real enviam notificações quando o custo acumulado durante o período de orçamento excede o valor limite. Por exemplo, se você definir um alerta de gasto real de 50% para um orçamento de US$ 100, receberá uma notificação de alerta quando gastar US$ 50 durante o período de orçamento.
    • As regras de custo Previsto enviam notificações quando o custo previsto (calculado no final do período de orçamento atual) excede o valor limite. Por exemplo, se você definir um alerta de gasto previsto de 110% para um orçamento de US$ 100, receberá uma notificação de alerta quando gastar mais de US$ 110 até o final do período de orçamento.
  5. Para adicionar mais regras de limite de alerta, clique em Adicionar limite próximo à lista de regras de limite de alerta atuais.

  6. Para remover uma regra de limite, clique em Excluir na linha que você quer remover.

  7. Para salvar as configurações de alertas de orçamento atuais, clique em Salvar.

Visualizar, editar ou excluir um orçamento

Para visualizar o status de todos os orçamentos ou editar ou excluir um orçamento:

  1. Faça login no Console do Google Cloud.

    Fazer login no Console do Cloud

  2. Abra o Menu de navegação () do console e selecione Faturamento.

    Se você tiver mais de uma Conta de faturamento do Cloud, siga um destes procedimentos:

    • Para gerenciar o Faturamento do Cloud para o projeto atual, selecione Ir para a conta de faturamento vinculada.
    • Para localizar outra Conta de faturamento do Cloud, selecione Gerenciar contas de faturamento e escolha aquela que tem os orçamentos que você quer gerenciar.
  3. No menu de navegação de faturamento, selecione Orçamentos e alertas para exibir uma lista de todos os orçamentos que foram criados em sua Conta de faturamento do Cloud.

    • As informações exibidas para cada orçamento incluem:

      • o nome do orçamento;
      • o tipo de orçamento, ou seja, se o valor do orçamento é um valor especificado ou baseado no gasto do mês anterior;
      • A que se aplica o alerta de orçamento, ou seja, uma conta de faturamento ou a um conjunto de projetos e produtos;
      • uma lista com as regras de limite de alertas para cada porcentagem do orçamento com uma regra vinculada;
      • e gasto e valor do orçamento, um indicador visual de como o gasto está acompanhando o orçamento.
    • Para excluir um orçamento, marque a caixa ao lado do nome do orçamento e clique em EXCLUIR.

    • Para editar um orçamento e as regras de limite de alertas, clique no nome do orçamento e modifique os campos que quiser. Para mais informações sobre o significado dos campos, consulte Criar um orçamento ou Definir, editar ou remover regras de limite de alerta de orçamento.

Gerenciar orçamentos de modo programático

Já disponível: com a versão Beta da API Cloud Billing Budget, é possível visualizar, criar e gerenciar orçamentos de modo programático em grande escala. Isso é útil principalmente ao criar um grande número de orçamentos na sua organização.

Gerenciar notificações programáticas

O comportamento padrão de um orçamento é enviar e-mails aos administradores e usuários na Conta de faturamento do Cloud de destino quando as regras de limite de alerta de orçamento acionam uma notificação.

No entanto, o e-mail nem sempre é a melhor maneira de se manter a par dos custos do Google Cloud, principalmente se o orçamento for crítico e urgente. É possível usar as notificações programáticas para encaminhar suas mensagens de orçamento a outras mídias e automatizar as tarefas de gerenciamento de custos.

Ative as notificações programáticas para receber mensagens do Pub/Sub com o status atual do seu orçamento.

Para mais informações, consulte Exemplos de notificação programática de orçamentos.

Para ativar notificações programáticas, siga estas etapas:

  1. Configure um tópico do Pub/Sub para o Faturamento do Cloud publicar seus alertas de orçamento. Se você já configurou um tópico do Pub/Sub de orçamentos, é possível reutilizá-lo em todos os orçamentos ou criar um tópico exclusivo para cada um.

    1. Acesse a página do Pub/Sub no Console do Google Cloud.

      Fazer login no Pub/Sub do Console do Cloud

    2. Selecione um projeto.

    3. Clique em Criar tópico.

    4. No campo ID do tópico, insira um nome de tópico e clique em Salvar.

  2. Abra o Menu de navegação () do console e clique em Faturamento.

    1. No menu de navegação de faturamento, clique em Orçamentos e alertas.
    2. Se necessário, crie um orçamento conforme descrito anteriormente. Se preferir, clique no nome de um orçamento para editá-lo. É possível também editar as regras de alerta dele.
    3. Na seção Ações, em Gerenciar notificações, selecione Conectar um tópico do Pub/Sub a este orçamento.
    4. No campo Projeto, clique em Selecionar um projeto e escolha um projeto para ver as notificações.
    5. Em Selecionar um tópico do Pub/Sub, escolha um tópico atual ou selecione Criar um tópico.
      1. Se estiver criando um novo tópico, em Nome, digite o nome e clique em Criar tópico.
      2. Depois de criado, o tópico será selecionado.
    6. Clique em Salvar.

Formato da notificação

As notificações enviadas ao tópico do Pub/Sub são compostas de duas partes:

  • Atributos: um conjunto de pares de chave-valor com a descrição do evento.
  • Dados: uma string que contém um objeto JSON com a descrição dos detalhes do alerta de orçamento.

Atributos

Os atributos são pares de chave-valor incluídos em todas as notificações enviadas pelo Faturamento do Cloud para seu tópico do Pub/Sub. As notificações sempre contêm o seguinte conjunto de pares de chave-valor, independentemente da carga útil.

Nome do atributo Exemplo Descrição
billingAccountId 01D4EE-079462-DFD6EC O identificador da Conta de faturamento do Cloud que detém o orçamento.
budgetId de72f49d-779b-4945-a127-4d6ce8def0bb O identificador do alerta de orçamento na Conta de faturamento do Cloud.
schemaVersion 1.0 A versão do esquema de notificações.

Dados

Para a versão do esquema 1.x, os detalhes do alerta de orçamento são retornados em uma string UTF-8 codificada em base64, que contém um objeto JSON com as seguintes propriedades:

Data Exemplo Descrição
budgetDisplayName "My Personal Budget" O nome legível atribuído ao orçamento.
alertThresholdExceeded 0.9 O limite máximo de alertas de custo real configurado foi excedido. O valor está em formato decimal (por exemplo, 0,9 é 90%). Essa chave não está presente quando o custo não excede um limite.
costAmount 140.321 O valor acumulado dos custos. O tipo de custo monitorado depende dos filtros e das configurações do orçamento.
costIntervalStart "2018-02-01T08:00:00Z"

O início do período de alerta do orçamento. O custo relatado inclui os custos de uso a partir dessa data. Atualmente, este é o primeiro dia do mês em que ocorreu o uso do orçamento.

budgetAmount 152.557 O montante atribuído ao orçamento.
budgetAmountType "SPECIFIED_AMOUNT" O tipo de valor do orçamento. Pode ser tanto "SPECIFIED_AMOUNT" (um valor fixo) ou "LAST_MONTH_COST" (custos do mês anterior).
currencyCode "USD" A moeda do alerta de orçamento. Todos os custos e valores orçamentários do alerta estão nessa moeda.

Garantias de entrega de notificações ao Pub/Sub

  • As notificações de orçamento serão enviadas várias vezes por dia com o status atual do seu orçamento.
  • Pode levar várias horas até que você receba a primeira notificação.
  • Se a Conta de faturamento do Cloud não for utilizada, nenhuma notificação será enviada.
  • Se houver falha na entrega devido a um erro de configuração do tópico do Pub/Sub, você não receberá uma notificação. Essa falha poderá ocorrer se o tópico do Pub/Sub não existir mais, o Faturamento do Cloud deixar de ter permissão para publicar no tópico do Pub/Sub ou se a cota for excedida.
  • O Pub/Sub somente garante a entrega pelo menos uma vez. É possível receber uma mensagem várias vezes, e as mensagens podem chegar fora de ordem.