Partilhar via

Tutorial: Monitorizar as APIs publicadas

  • Artigo

APLICA-SE A: Todas as camadas de gerenciamento de API

Com o Azure Monitor, pode visualizar, consultar, encaminhar, arquivar e tomar medidas relativamente a métricas ou registos provenientes do serviço Gestão de API do Azure.

Nota

Atualmente, esse recurso não está disponível em espaços de trabalho.

Neste tutorial, irá aprender a:

  • Ver métricas da API
  • Configurar uma regra de alerta
  • Ver registos de atividades
  • Habilitar e exibir logs de recursos

Nota

O Gerenciamento de API suporta uma variedade de ferramentas adicionais para observar APIs, incluindo análises internas e integração com o Application Insights. Mais informações

Pré-requisitos

Ver métricas das APIs

O Gerenciamento de API emite métricas a cada minuto, oferecendo visibilidade quase em tempo real do estado e da integridade de suas APIs. A seguir estão as métricas usadas com mais frequência. Para obter uma lista de todas as métricas disponíveis, veja Métricas suportadas.

  • Capacidade - ajuda você a tomar decisões sobre upgrade/downgrade de seus serviços de Gerenciamento de API. A métrica é emitida por minuto e reflete a capacidade estimada do gateway no momento do relatório. A métrica varia de 0 a 100 calculada com base em recursos de gateway, como utilização de CPU e memória e outros fatores.

    Gorjeta

    Nas camadas de serviço v2, o Gerenciamento de API substituiu a métrica de capacidade por métricas separadas de utilização de CPU e memória. Essas métricas também podem ser usadas para decisões de dimensionamento e solução de problemas. Mais informações

  • Solicitações - ajuda você a analisar o tráfego de API que passa pelos serviços de Gerenciamento de API. A métrica é emitida por minuto e informa o número de solicitações de gateway com dimensões. Filtre solicitações por códigos de resposta, local, nome do host e erros.

Importante

As seguintes métricas foram desativadas: Total de solicitações de gateway, solicitações de gateway bem-sucedidas, solicitações de gateway não autorizadas, solicitações de gateway com falha, outras solicitações de gateway. Migre para a métrica Solicitações, que fornece funcionalidade muito semelhante.

Captura de tela da visão geral de métricas no gerenciamento de API

Para aceder a métricas:

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API. Na página Visão geral, na guia Monitor, revise as principais métricas de suas APIs.

  2. Para investigar métricas em detalhes, selecione Monitoramento>de métricas no menu à esquerda.

    Captura de tela do item Métricas no menu Monitoramento no portal.

  3. Na lista suspensa, selecione as métricas em que você está interessado. Por exemplo, Solicitações.

  4. O gráfico mostra o número total de chamadas à API. Ajuste o intervalo de tempo para se concentrar em períodos de interesse.

  5. Você pode filtrar o gráfico usando as dimensões da métrica Solicitações . Por exemplo, selecione Adicionar filtro, selecione Categoria de código de resposta de back-end, insira 500 como o valor. O gráfico mostra o número de solicitações com falha no back-end da API.

Configurar uma regra de alerta

Você pode receber alertas com base em métricas e registros de atividades. No Azure Monitor, configure uma regra de alerta para executar uma ação quando ela for acionada. As ações comuns incluem:

  • Enviar uma notificação por e-mail
  • Chamar um webhook
  • Invocar uma Aplicação Lógica do Azure

Para configurar uma regra de alerta de exemplo com base em uma métrica de solicitação:

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Monitoramento>de alertas no menu à esquerda.

    Captura de tela da opção Alertas no menu Monitoramento no portal.

  3. Selecione + Criar>regra de alerta.

  4. Na guia Condição:

    1. Em Nome do sinal, selecione Solicitações.
    2. Em Lógica de alerta, revise ou modifique os valores padrão do alerta. Por exemplo, atualize o Limite estático, que é o número de ocorrências após o qual o alerta deve ser acionado.
    3. Em Dividir por dimensões, em Nome da dimensão, selecione Categoria do Código de Resposta do Gateway.
    4. Em Valores de dimensão, selecione 4xx, para erros de cliente, como solicitações não autorizadas ou inválidas. Se o valor da dimensão não aparecer, selecione Adicionar valor personalizado e insira 4xx.
    5. Em Quando avaliar, aceite as configurações padrão ou selecione outras configurações para definir a frequência de execução da regra. Selecione Seguinte.

    Captura de tela da configuração da lógica de alerta no portal.

  5. Na guia Ações, selecione ou crie um ou mais grupos de ações para notificar os usuários sobre o alerta e executar uma ação. Por exemplo, crie um novo grupo de ações para enviar um e-mail de notificação para .admin@contoso.com Para obter etapas detalhadas, consulte Criar e gerenciar grupos de ação no portal do Azure.

    Captura de tela da configuração de notificações para novo grupo de ações no portal.

  6. Na guia Detalhes de Criar uma regra de alerta, insira um nome e uma descrição da regra de alerta e selecione o nível de gravidade.

  7. Opcionalmente, configure as configurações restantes. Em seguida, no separador Rever + criar , selecione Criar.

  8. Opcionalmente, teste a regra de alerta usando um cliente HTTP para simular uma solicitação que dispara o alerta. Por exemplo, execute o seguinte comando em um terminal, substituindo o nome do host do Gerenciamento de API pelo nome do host da sua instância de Gerenciamento de API:

    curl GET https://contoso.azure-api.net/non-existent-endpoint HTTP/1.1

    Um alerta é acionado com base no período de avaliação e ele enviará um e-mail para admin@contoso.com.

    Os alertas também aparecem na página Alertas da instância de Gerenciamento de API.

    Captura de ecrã de alertas no portal.

Registos de atividade

Os logs de atividades fornecem informações sobre as operações em seus serviços de Gerenciamento de API. Ao utilizar registos de atividades, pode determinar o "quê, quem e quando" de quaisquer operações de escrita (PUT, POST, DELETE) efetuadas nos seus serviços de Gestão de API.

Nota

Os logs de atividades não incluem operações de leitura (GET) ou operações executadas no portal do Azure.

Pode aceder aos registos de atividades no serviço de Gestão de API ou aceder aos registos de todos os recursos do Azure no Azure Monitor.

Captura de ecrã do registo de atividades no portal.

Para visualizar o registo de atividades:

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Registro de atividades.

    Captura de ecrã do item Registo de atividades no menu Monitorização no portal.

  3. Selecione o escopo de filtragem desejado e, em seguida, Aplicar.

Registos do recurso

Os logs de recursos (logs do Azure Monitor) fornecem informações detalhadas sobre operações e erros de Gerenciamento de API que são importantes para fins de auditoria e solução de problemas. Quando habilitados por meio de uma configuração de diagnóstico, os logs coletam informações sobre as solicitações de API recebidas e processadas pelo gateway de Gerenciamento de API.

Nota

A camada Consumo não oferece suporte à coleta de logs de recursos.

Para configurar logs de recursos:

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Configurações de diagnóstico de monitoramento>.

    Captura de tela do item Configurações de diagnóstico no menu Monitoramento no portal.

  3. Selecione +Adicionar definição de diagnóstico.

  4. Selecione os logs ou métricas que deseja coletar.

    Você tem várias opções sobre para onde enviar os logs e métricas. Por exemplo, arquive logs de recursos juntamente com métricas em uma conta de armazenamento, transmita-os para um hub de eventos ou envie-os para um espaço de trabalho do Log Analytics.

    Gorjeta

    Se você selecionar um espaço de trabalho do Log Analytics, poderá optar por armazenar os dados na tabela ApiManagementGatewayLogs específica do recurso ou armazenar na tabela geral AzureDiagnostics. Recomendamos que utilize a tabela específica do recurso para destinos de registo que a suportem. Mais informações

  5. Depois de configurar os detalhes para o(s) destino(s) do log, selecione Salvar.

Nota

Adicionar um objeto de configuração de diagnóstico pode resultar em uma falha se a propriedade MinApiVersion do seu serviço de Gerenciamento de API estiver definida como qualquer versão de API superior a 2022-09-01-preview.

Para obter mais informações, consulte Criar configurações de diagnóstico para enviar logs e métricas da plataforma para destinos diferentes.

Exibir logs e métricas no Azure Monitor

Se você habilitar a coleta de logs ou métricas em um espaço de trabalho do Log Analytics, poderá levar alguns minutos para que os dados apareçam no Azure Monitor.

Para visualizar os dados:

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Logs no menu à esquerda.

    Captura de tela do item Logs no menu Monitoramento no portal.

  3. Execute consultas para exibir os dados. Várias consultas de exemplo são fornecidas ou executam as suas próprias. Por exemplo, a consulta a seguir recupera as 24 horas mais recentes de dados da tabela ApiManagementGatewayLogs:

    ApiManagementGatewayLogs
| where TimeGenerated > ago(1d)

    Captura de tela da consulta da tabela ApiManagementGatewayLogs no portal.

Para obter mais informações sobre como usar logs de recursos para o Gerenciamento de API, consulte:

Modificar as configurações de log da API

Por padrão, quando você cria uma configuração de diagnóstico para habilitar a coleta de logs de recursos, o registro em log é habilitado para todas as APIs, com configurações padrão. Você pode ajustar as configurações de log para todas as APIs ou substituí-las para APIs individuais. Por exemplo, ajuste a taxa de amostragem ou a detalhamento dos dados, habilite o registro de cabeçalhos ou cargas úteis de solicitação ou resposta ou desabilite o registro em log para algumas APIs.

Para obter detalhes sobre as configurações de log, consulte Referência de configurações de log de diagnóstico.

Para definir as configurações de log para todas as APIs:

  1. No menu esquerdo da sua instância de Gerenciamento de API, selecione APIs>APIs>Todas as APIs.
  2. Selecione a guia Configurações na barra superior.
  3. Role para baixo até a seção Logs de Diagnóstico e selecione a guia Azure Monitor .
  4. Revise as configurações e faça alterações, se necessário. Selecione Guardar.

Para definir as configurações de log para uma API específica:

  1. No menu esquerdo da instância de Gerenciamento de API, selecione APIs de APIs> e, em seguida, o nome da API.
  2. Selecione a guia Configurações na barra superior.
  3. Role para baixo até a seção Logs de Diagnóstico e selecione a guia Azure Monitor .
  4. Revise as configurações e faça alterações, se necessário. Selecione Guardar.

Importante

Se habilitada, as cargas úteis de solicitação ou resposta registradas podem ter até 8.192 bytes. O Gerenciamento de API também impõe um limite de 32 KB para uma entrada de log de diagnóstico enviada ao Azure Monitor, que inclui as cargas úteis e outros atributos, como códigos de status, cabeçalhos e carimbos de data/hora. Se o tamanho combinado dos atributos exceder 32 KB, o Gerenciamento de API cortará a entrada removendo todo o conteúdo de corpo e rastreamento.

Próximos passos

Neste tutorial, ficou a saber como:

  • Ver métricas da API
  • Configurar uma regra de alerta
  • Ver registos de atividades
  • Habilitar e exibir logs de recursos

Avance para o tutorial seguinte:

Rastrear chamadas