Condividi tramite

Informazioni di riferimento sulle impostazioni dei log di diagnostica: Gestione API

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

Questo riferimento descrive le impostazioni per la registrazione della diagnostica API da un'istanza di Gestione API. Per abilitare la registrazione delle richieste API, vedere le indicazioni seguenti:

Nota

Alcune impostazioni, se indicate, si applicano solo alla registrazione ad Application Insights.

Impostazione Tipo Descrizione
Abilitare boolean Specifica se la registrazione di questa API è abilitata.

La registrazione può essere abilitata per tutte le API o per una singola API. Le impostazioni per una singola API sostituiscono le impostazioni per tutte le API, se abilitate.
Destinazione Logger di Azure Application Insights Specifica il logger da usare per la registrazione di Application Insights.
Sampling (%) (Campionamento - %) decimale Valori compresi tra 0 e 100 (percentuale).
Specifica la percentuale di richieste registrate. Un campionamento pari allo 0% indica che verranno registrate zero richieste, mentre un campionamento del 100% indica che verranno registrate tutte le richieste. Valore predefinito: 100

Per gli effetti sulle prestazioni della registrazione di Application Insights, vedere Implicazioni sulle prestazioni e campionamento dei log.
Always log errors (Registra sempre gli errori) boolean Se questa impostazione è abilitata, vengono registrati tutti gli errori, indipendentemente dall'impostazione Campionamento .
Indirizzo IP del client di log boolean Se questa impostazione è abilitata, viene registrato l'indirizzo IP del client per le richieste API.
Livello di dettaglio Specifica il livello di dettaglio dei log e indica se vengono registrate tracce personalizzate configurate nei criteri di traccia .

* Errore - richieste non riuscite e tracce personalizzate di gravità error
* Informazioni - richieste non riuscite e con esito positivo e tracce personalizzate di gravità error e information
* Dettagliato : richieste non riuscite e riuscite e tracce personalizzate di gravità error, informatione verbose

Informazioni predefinite:
Protocollo di correlazione Specifica il protocollo usato per correlare i dati di telemetria inviati da più componenti ad Application Insights. Impostazione predefinita: Legacy

Per informazioni, vedere Correlazione dei dati di telemetria in Application Insights.
Intestazioni da registrare list Specifica le intestazioni registrate per le richieste e le risposte. Impostazione predefinita: non vengono registrate intestazioni.
Numero di byte di payload (corpo) da registrare integer Specifica il numero di byte iniziali del corpo della richiesta front-end o back-end o del corpo della risposta registrato. Massimo: 8.192. Predefinito: 0
Richiesta front-end Specifica se e come vengono registrate le richieste front-end (richieste in ingresso al gateway Gestione API).

Se questa impostazione è abilitata, specificare Intestazioni da registrare, Numero di byte di payload da registrare o entrambi.
Risposta front-end Specifica se e come vengono registrate le risposte front-end (risposte in uscita dal gateway Gestione API).

Se questa impostazione è abilitata, specificare Intestazioni da registrare, Numero di byte di payload da registrare o entrambi.
Richieste back-end Specifica se e come vengono registrate le richieste back-end (richieste in uscita dal gateway Gestione API).

Se questa impostazione è abilitata, specificare Intestazioni da registrare, Numero di byte di payload da registrare o entrambi.
Risposta back-end Specifica se e come vengono registrate le risposte back-end (risposte in ingresso al gateway Gestione API).

Se questa impostazione è abilitata, specificare Intestazioni da registrare, Numero di byte di payload da registrare o entrambi.

Importante

Se abilitata, i payload di richiesta o risposta registrati possono raggiungere 8.192 byte. Gestione API applica anche un limite di 32 kB per una voce di log di diagnostica inviata a Monitoraggio di Azure, che include i payload e altri attributi, ad esempio codici di stato, intestazioni e timestamp. Se le dimensioni combinate degli attributi superano i 32 kB, Gestione API taglia la voce rimuovendo tutto il contenuto del corpo e della traccia.

Passaggi successivi

  • Per altre informazioni, vedere le informazioni di riferimento per l'entità Diagnostic nell'API REST Gestione API.
  • Usare i criteri di traccia per aggiungere tracce personalizzate ai dati di telemetria di Application Insights, ai log delle risorse o alla traccia delle richieste.