Classe Diagnostics::Logging::EventLogger

  • Articolo

Classe con metodi statici per controllare la registrazione dell'SDK basata sul callback. L'attivazione della registrazione durante l'esecuzione dello scenario di Speech SDK fornisce informazioni dettagliate dai componenti nativi principali dell'SDK. Se si segnala un problema a Microsoft, potrebbe essere richiesto di fornire i log per consentire a Microsoft di diagnosticare il problema. L'applicazione non deve dipendere da stringhe di log specifiche, perché possono passare da una versione SDK a un'altra senza preavviso. Usare EventLogger quando si vuole ottenere l'accesso alle nuove stringhe di log non appena sono disponibili ed è necessario elaborarle ulteriormente. Ad esempio, l'integrazione dei log di Speech SDK con il sistema di raccolta di registrazione esistente. Aggiunta nella versione 1.20.0.

La registrazione eventi è un costrutto a livello di processo. Ciò significa che se, ad esempio, si dispone di più oggetti riconoscimento vocale in esecuzione in parallelo, è possibile registrare una sola funzione di callback per ricevere log interleaved da tutti i riconoscitori. Non è possibile registrare un callback separato per ogni sistema di riconoscimento.

Membri

SetCallback

Sintassi: public inline static void SetCallback ( CallbackFunction_Type callback );

Registrare una funzione di callback che verrà richiamata per ogni nuovo messaggio di log.

Parametri

  • callback funzione di callback da chiamare. Impostare un valore nullptr per arrestare il logger di eventi.

È possibile registrare una sola funzione di callback. Questa chiamata verrà eseguita su un thread di lavoro dell'SDK, quindi la stringa di log deve essere copiata da qualche parte per un'ulteriore elaborazione da un altro thread e la funzione deve restituire immediatamente. In questa funzione di callback non devono essere eseguite chiamate di rete o elaborazione elevate.

SetFilters

Sintassi: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Imposta o cancella i filtri per i callback. Una volta impostati i filtri, il callback verrà richiamato solo se la stringa di log contiene almeno una delle stringhe specificate dai filtri. La corrispondenza fa distinzione tra maiuscole e minuscole.

Parametri

  • filters Facoltativo. Filtri da usare o un elenco vuoto per cancellare i filtri impostati in precedenza

SetLevel

Sintassi: public inline static void SetLevel ( Level level );

Imposta il livello dei messaggi da acquisire dal logger.

Parametri

  • level Livello massimo di dettaglio da acquisire dal logger.

CallbackFunction_Type

Sintassi: typedef CallbackFunction_Type;