Configurar logs e métricas de nuvem para gateway auto-hospedado de Gerenciamento de API do Azure

APLICA-SE A: Desenvolvedor | Premium

Este artigo fornece detalhes sobre como configurar métricas e logs de nuvem para o gateway auto-hospedado.

O gateway auto-hospedado deve ser associado a um serviço de gerenciamento de API e requer conectividade TCP/IP de saída para o Azure na porta 443. O gateway utiliza a conexão de saída para enviar telemetria para o Azure, se configurado para fazer isso.

Métricas

Por padrão, o gateway auto-hospedado emite várias métricas por meio do Azure Monitor, o mesmo que o gateway gerenciado na nuvem.

O recurso pode ser habilitado ou desabilitado usando a chave telemetry.metrics.cloud no ConfigMap da implantação do gateway. Veja abaixo um detalhamento das configurações disponíveis:

Campo	Padrão	Descrição
telemetry.metrics.cloud	true	Habilita os logs no Azure Monitor. O valor pode ser true, false.

Veja uma configuração de exemplo:

    apiVersion: v1
    kind: ConfigMap
    metadata:
        name: contoso-gateway-environment
    data:
        config.service.endpoint: "<contoso-gateway-management-endpoint>"
        telemetry.metrics.cloud: "true"

Atualmente, o gateway auto-hospedado emite as seguintes métricas por meio do Azure Monitor:

Métrica	Descrição
Requests	Número de solicitações de API no período
Duração de solicitações de gateway	Número de milissegundos do momento em que o gateway recebeu a solicitação até o momento em que a resposta foi enviada por completo
Duração de Solicitações de back-end	Número de milissegundos gastos na E/S do back-end no total (conectando, enviando e recebendo bytes)

Logs

Atualmente, o gateway auto-hospedado não envia logs de diagnóstico para a nuvem. No entanto, é possível configurar e manter os logs localmente onde o gateway auto-hospedado está implantado.

Se um gateway for implantado Serviço de Kubernetes do Azure, você poderá habilitar o Azure Monitor para contêineres para coletar logs de seus contêineres e exibi-los na Análise de Logs.

Próximas etapas

• Para saber mais sobre as funcionalidades de observabilidade dos gateways do Gerenciamento de API do Azure.
• Para saber mais sobre o gateway auto-hospedado, confira a Visão geral do gateway auto-hospedado do Gerenciamento de API do Azure
• Saiba mais sobre como configurar e persistir logs localmente