Exemplos de alertas

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

O Apigee permite-lhe criar alertas complexos com base em várias condições. As secções seguintes apresentam exemplos de alertas:

Alerta de ausência de código de resposta 200 durante 5 minutos

O exemplo seguinte cria um alerta quando não existe um código de resposta 200 (pedido bem-sucedido) durante 5 minutos.

Para criar o alerta:

  1. Na Google Cloud consola, aceda à página Monitorização > Alertas > Políticas.

    Aceder a Criar política de alertas

  2. Clique em Selecionar uma métrica.
  3. Desmarque o botão Ativo.

    Nota: se não existirem dados de tráfego da API recentes na sua organização, a métrica no passo seguinte não é apresentada, a menos que esta opção seja desmarcada.

  4. Selecione uma métrica da seguinte forma:
    1. Copie e cole o seguinte no campo Selecione uma métrica: 
      apigee.googleapis.com/proxy/response_count
    2. Selecione Apigee Proxy.
    3. No painel apresentado à direita, selecione Proxy.
    4. No painel seguinte à direita, selecione Apigee proxy response count.
    5. Clique em Aplicar.
  5. Adicione um filtro para o código de resposta da seguinte forma:
    1. Clique em Adicionar filtro.
    2. Clique no campo Filtro e selecione response_code no menu pendente.
    3. No Comparador, selecione =.
    4. No campo Valor, escreva 200.
    5. Clique em Aplicar.

Configure o acionador do alerta

Para configurar o evento que aciona o alerta, clique primeiro em Configurar acionador no painel do lado esquerdo. Depois, siga estes passos:

  1. Em Tipo de condição, selecione Ausência de métrica.
  2. No campo Acionador de alerta, selecione Qualquer série cronológica viola.
  3. No campo Tempo de ausência de métricas, selecione 5 min.
  4. Opcionalmente, no campo Nome da condição, introduza um nome para a condição.

Com estas definições, é acionado um alerta quando o proxy não recebe um código de resposta 200 durante 5 minutos.

Clique em Seguinte para abrir o painel Configurar notificações e finalizar alerta.

Configure uma notificação para o alerta

No painel Configurar notificações e finalizar alerta, pode configurar uma notificação que é enviada quando um alerta é acionado. Para isso:

  1. Clique no campo Canais de notificação. Se já tiver criado um canal para a notificação, como um endereço de email ou um número de SMS, pode selecioná-lo em Canais de notificação.

    Caso contrário, tem de adicionar um canal selecionando Gerir canais de notificação. É aberto o painel Canais de notificação, onde pode adicionar um ou mais canais. Consulte o artigo Faça a gestão dos canais de notificações para mais informações. Quando terminar, regresse ao painel Configure as notificações e finalize o alerta.

    Nota: pode ter de clicar no botão de atualização junto a Gerir canais de notificação para apresentar um novo canal depois de o criar.

    Depois de selecionar um ou mais canais de notificação, clique em OK.

  2. No campo Documentação, pode adicionar uma mensagem que vai ser enviada com a notificação. Por exemplo, a mensagem pode descrever o motivo do alerta e conter links para documentação que explica como responder ao mesmo.
  3. Clique em Seguinte para rever os detalhes do alerta. Se estiver satisfeito com as mesmas, clique em Criar política para criar a política de alerta.

Alerta de pico de tráfego

As secções seguintes mostram como criar um alerta que é acionado quando o número de pedidos de API num período de 1 minuto excede 3600.

Para criar o alerta:

  1. Na Google Cloud consola, aceda à página Monitorização > Alertas > Políticas.

    Aceder a Criar política de alertas

  2. Clique em Selecionar uma métrica.
  3. Desmarque o botão Ativo.

    Nota: se não existirem dados de tráfego da API recentes na sua organização, a métrica no passo seguinte não é apresentada, a menos que esta opção seja desmarcada.

  4. Selecione uma métrica da seguinte forma:
    1. Copie e cole o seguinte no campo Selecione uma métrica: 
      apigee.googleapis.com/proxy/request_count
    2. Selecione Apigee Proxy.
    3. No painel apresentado à direita, selecione Proxy.
    4. No painel seguinte à direita, selecione Apigee proxy request count.
    5. Clique em Aplicar.
  5. No painel Transformar dados:
    • Em Em cada intervalo temporal:
      • No campo Janela dinâmica, selecione 1 min.
      • Na função de janela dinâmica, selecione taxa.
    • Em Em intervalos temporais, em Agregação de intervalos temporais, selecione soma.

Configure o acionador do alerta

Para configurar o evento que aciona o alerta, clique primeiro em Configurar acionador no painel do lado esquerdo. Depois, siga estes passos:

  1. Em Tipo de condição, selecione Limite.
  2. No campo Acionador de alerta, selecione Qualquer série cronológica viola.
  3. No campo Posição do limite, selecione Acima do limite.
  4. No campo Valor do limite, introduza 60.

O motivo pelo qual definiu o Valor do limite como 60 (em vez de 3600) é que as unidades do Valor do limite são por segundo. Assim, se este limite for mantido durante 1 minuto, haverá, pelo menos, 3600 pedidos nesse período.

Com estas definições, é acionado um alerta quando o número total de pedidos num período de 1 minuto excede 3600.

Clique em Seguinte para abrir o painel Configurar notificações e finalizar alerta e seguir os passos em Configure uma notificação para o alerta.

Alerta de latência

Os exemplos seguintes mostram como criar um alerta que é acionado quando o percentil 95 das latências médias nas respostas, em intervalos de 10 minutos, é superior a 600 ms.

Crie o alerta através do Apigee ou do Apigee Hybrid v1.12

Para criar o alerta através do Apigee:

  1. Na Google Cloud consola, aceda à página Monitorização > Alertas > Políticas.

    Aceder a Criar política de alertas

  2. Clique em Selecionar uma métrica.
  3. Desmarque o botão Ativo.

    Nota: se não existirem dados de tráfego da API recentes na sua organização, a métrica no passo seguinte não é apresentada, a menos que esta opção esteja desmarcada.

  4. Selecione uma métrica da seguinte forma:
    1. Copie e cole o seguinte no campo Selecione uma métrica: 
      apigee.googleapis.com/proxy/latencies
    2. Selecione Apigee Proxy.
    3. No painel apresentado à direita, selecione Proxy.
    4. No painel seguinte à direita, selecione Latências do proxy do Apigee.
    5. Clique em Aplicar.
  5. No painel Transformar dados, em Em cada série cronológica:
    • No campo Janela contínua, selecione 10 min.
    • No campo Função de janela móvel, introduza 95.º percentil.

Consulte Crie o acionador do alerta para configurar o evento que aciona o alerta.

Crie o alerta com o Apigee Hybrid v1.10 ou v1.11

Para criar o alerta com o Apigee Hybrid v1.10 ou v1.11:

  1. Na Google Cloud consola, aceda à página Monitorização > Alertas > Políticas.

    Aceder a Criar política de alertas

  2. Clique em Selecionar uma métrica.
  3. Desmarque o botão Ativo.

    Nota: se não existirem dados de tráfego da API recentes na sua organização, a métrica no passo seguinte não é apresentada, a menos que esta opção esteja desmarcada.

  4. Selecione uma métrica da seguinte forma:
    1. Copie e cole o seguinte no campo Selecione uma métrica: 
      apigee.googleapis.com/proxyv2/latencies_percentile
    2. Selecione Proxy do Apigee (v2).
    3. No painel apresentado à direita, selecione Proxyv2.
    4. No painel seguinte à direita, selecione Percentil das latências de resposta do proxy do Apigee.
    5. Clique em Aplicar.

  5. Adicione um filtro da seguinte forma:

    1. Clique em Adicionar um filtro.
    2. Clique no campo Filtro e selecione percentil no menu pendente.
    3. No Comparador, selecione =.
    4. No campo Valor, escreva 95.
    5. Clique em Aplicar.
  6. No painel Transformar dados, em Em cada série cronológica:
    • No campo Janela contínua, selecione 10 min.
    • No campo Função de janela móvel, introduza média.

Consulte Crie o acionador do alerta para configurar o evento que aciona o alerta.

Configure o acionador do alerta

Para configurar o evento que aciona o alerta, clique primeiro em Configurar acionador no painel do lado esquerdo. Depois, siga estes passos:

  1. Em Tipo de condição, selecione Limite.
  2. No campo Acionador de alerta, selecione Qualquer série cronológica viola.
  3. No campo Posição do limite, selecione Acima do limite.
  4. No campo Valor do limite, introduza 600.

Com estas definições, é acionado um alerta quando o percentil 95 das latências está acima do limite de 600 ms.

Clique em Seguinte para abrir o painel Configurar notificações e finalizar alerta e seguir os passos em Configure uma notificação para o alerta.

Quando recebe uma notificação e clica no botão Ver no Apigee no email de notificação, o painel de controlo de investigação apresenta um gráfico de latência com o limite, semelhante ao exemplo apresentado: Selecione uma métrica.