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 receber notificações programáticas de orçamento inscrevendo-se no seu tópico do Pub/Sub com gatilhos de função do Cloud Run. Sem um assinante, o Pub/Sub descarta as mensagens publicadas, e não é possível recuperá-las depois. Neste documento, você vai aprender a concluir as seguintes tarefas:

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

Antes de começar

Antes de começar, conclua as seguintes tarefas:

  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 Google Cloud , acesse a página Funções do Cloud Run.

    Acessar as funções do Cloud Run

  2. Clique em CRIAR SERVIÇO.

  3. Selecione Usar um editor in-line para criar uma função.

  4. Insira um Nome do serviço que seja significativo para sua notificação de orçamento.

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

  6. Clique em Adicionar gatilho e selecione Cloud Pub/Sub.

  7. Se solicitado, ative as APIs necessárias.

  8. No painel Gatilho do Eventarc, conclua as etapas a seguir:

    1. Insira o nome de um acionador.
    2. Defina Tipo de acionador como Fontes do Google.
    3. Defina Provedor de eventos como Cloud Pub/Sub.
    4. Selecione o tópico do Cloud Pub/Sub que você configurou no seu orçamento.
    5. Selecione uma Região.
    6. Clique em Salvar acionador.

  9. Edite as configurações de Identity-Aware Proxy, Faturamento, Escalonamento de serviço, Ingresso e Contêineres, volume, rede, segurança conforme necessário e clique em Criar.

  10. Escreva o código usando o editor in-line ou faça upload de um arquivo que informe à função como processar notificações.

    Confira os exemplos a seguir para ver exemplos de código:

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

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

  12. Clique em IMPLANTAR.

Ver eventos da função do Cloud Run

Depois de implantar a função do Cloud Run, clique em REGISTROS para conferir os registros das invocações de 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 sua função esteja funcionando como esperado, publique uma mensagem no Pub/Sub com o seguinte objeto como o 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 da notificação.

A seguir

Para saber mais sobre como usar notificações programáticas, confira os exemplos a seguir de respostas programáticas de controle de custos: