Condividi tramite

Configurare metriche e log cloud per il gateway self-hosted di Gestione API di Azure

  • Articolo

SI APPLICA A: Sviluppatore | Premium

Questo articolo fornisce informazioni dettagliate sulla configurazione delle metriche e dei log cloud per il gateway self-hosted.

Il gateway self-hosted deve essere associato a un servizio di gestione API e richiede la connettività TCP/IP in uscita ad Azure sulla porta 443. Il gateway sfrutta la connessione in uscita per inviare dati di telemetria ad Azure, se configurati per farlo.

Metrica

Per impostazione predefinita, il gateway self-hosted genera una serie di metriche tramite Monitoraggio di Azure, come il gateway gestito nel cloud.

La funzionalità può essere abilitata o disabilitata usando la chiave telemetry.metrics.cloud in ConfigMap della distribuzione del gateway. Di seguito è riportata una suddivisione delle configurazioni disponibili:

Campo Default Descrizione
telemetry.metrics.cloud true Abilita la registrazione tramite Monitoraggio di Azure. Il valore può essere true, false.

Ecco una configurazione di esempio:

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

Attualmente il gateway self-hosted genera le metriche seguenti tramite Monitoraggio di Azure:

Metrico Descrizione
Richieste Numero di richieste API nel periodo
Durata delle richieste del gateway Numero di millisecondi dal momento in cui il gateway ha ricevuto la richiesta al momento dell'invio della risposta completa
Durata delle richieste back-end Numero di millisecondi impiegati complessivamente per l'I/O del back-end (connessione, invio e ricezione byte)

Registri

Il gateway self-hosted attualmente non invia log di diagnostica al cloud. Tuttavia, è possibile configurare e rendere persistenti i log in locale in cui viene distribuito il gateway self-hosted.

Se un gateway viene distribuito in servizio Azure Kubernetes, è possibile abilitare Monitoraggio di Azure per contenitori per raccogliere i log dai contenitori e visualizzarli in Log Analytics.

Passaggi successivi