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

  • Artigo

APLICA-SE A: Developer | Prémio

Este artigo fornece detalhes para 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 aproveita a conexão de saída para enviar telemetria ao Azure, se configurado para 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 telemetry.metrics.cloud chave no ConfigMap da implantação do gateway. Abaixo está um detalhamento das configurações disponíveis:

Campo Predefinido Description
telemetry.metrics.cloud true Permite o registo através do Azure Monitor. O valor pode ser true, false.

Aqui está um exemplo de configuração:

    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étrico Description
Pedidos Número de solicitações de API no período
Duração dos pedidos de gateway Número de milissegundos a partir do momento em que o gateway recebeu o pedido até ao momento em que a resposta é enviada integralmente
Duração das solicitações de back-end Número de milissegundos despendidos na E/S de back-end global (ligar, enviar e receber bytes)

Registos

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

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

Próximos passos