Detectar suas notificações do Pub/Sub

Exemplo de arquitetura de referência

Diagrama de um exemplo que usa notificações programáticas de alertas de orçamento para automatizar uma resposta de controle de custos.
Figura 1: um exemplo de uso de alertas de orçamento para automatizar respostas de controle de custos usando o Pub/Sub para notificações programáticas e as funções do Cloud Run para automatizar uma resposta.

Este documento explica como ouvir as notificações de orçamento programático se inscrevendo no seu tópico do Pub/Sub com gatilhos da função do Cloud Run. Sem um assinante, o Pub/Sub descarta as mensagens publicadas e não é possível recuperá-las mais tarde. Neste documento, você vai aprender a concluir as seguintes tarefas:

  1. Crie uma função do Cloud Run que detecta notificações.
  2. Acessar eventos da função do Cloud Run.
  3. Teste uma função do Cloud Run.

Antes de começar

Antes de começar, faça o seguinte:

  1. Criar um orçamento
  2. Configurar notificações programáticas

Criar uma função do Cloud Run

Para criar uma função do Cloud Run, siga estas etapas:

  1. No console do Google Cloud, acesse a página das funções do Cloud Run.

    Acessar as funções do Cloud Run

  2. Clique em CRIAR FUNÇÃO e insira um nome de função que seja significativo para a notificação de orçamento.

  3. Selecione a região em que as funções do Cloud Run serão executadas. Não é possível editar essa configuração depois de implantar a função.

  4. Em Tipo de gatilho, selecione Cloud Pub/Sub.

  5. Selecione o tópico do Cloud Pub/Sub que você configurou no seu orçamento.

  6. Edite as configurações de ambiente de execução, build, conexões e segurança conforme necessário e clique em Próxima.

  7. Escreva o código usando o editor inline ou faça upload de um arquivo que informe à função como processar as notificações.

    Confira os exemplos de código a seguir:

    Para detalhes sobre as notificações que seu código vai receber, consulte Formato de notificação.

  8. Defina o Ponto de entrada como a função correta a ser executada:

  9. Clique em IMPLANTAR.

Conferir eventos da função do Cloud Run

Depois de implantar a função do Cloud Run, clique em LOGS para conferir os registros das invocações da função.

Testar uma função do Cloud Run

À medida que as notificações são enviadas ao Pub/Sub, os assinantes recebem as mensagens. Para testar uma notificação de amostra e garantir que a função está funcionando como esperado, publique uma mensagem no Pub/Sub com o seguinte objeto como corpo da mensagem:

{
    "budgetDisplayName": "name-of-budget",
    "alertThresholdExceeded": 1.0,
    "costAmount": 100.01,
    "costIntervalStart": "2019-01-01T00:00:00Z",
    "budgetAmount": 100.00,
    "budgetAmountType": "SPECIFIED_AMOUNT",
    "currencyCode": "USD"
}

Você também pode adicionar atributos de mensagem, como o ID da conta de faturamento. Para mais informações, consulte Formato de notificação.

A seguir

Para saber mais sobre como usar notificações programáticas, consulte os seguintes exemplos de respostas de controle de custos programático: