klasse Diagnostische gegevens::Logboekregistratie::MemoryLogger

Klasse met statische methoden voor het beheren van SDK-logboekregistratie in een in-memory buffer. Het inschakelen van logboekregistratie tijdens het uitvoeren van uw Speech SDK-scenario bevat gedetailleerde informatie over de kernonderdelen van de SDK. Als u een probleem aan Microsoft rapporteert, wordt u mogelijk gevraagd logboeken op te geven om Microsoft te helpen het probleem te diagnosticeren. Uw toepassing mag niet afhankelijk zijn van bepaalde logboektekenreeksen, omdat deze zonder kennisgeving kunnen worden gewijzigd van de ene SDK-release naar een andere. MemoryLogger is ontworpen voor het geval u toegang wilt krijgen tot logboeken die in de korte duur zijn genomen voordat er een onverwachte gebeurtenis plaatsvindt. Als u bijvoorbeeld een Speech Recognizer uitvoert, kunt u de MemoryLogger dumpen nadat een gebeurtenis is ontvangen die aangeeft dat de herkenning is geannuleerd vanwege een fout. De grootte van de geheugenbuffer is vastgesteld op 2 MB en kan niet worden gewijzigd. Dit is een ringbuffer, dat wil gezegd, nieuwe logboektekenreeksen die zijn geschreven, vervangen de oudste in de buffer. Toegevoegd in versie 1.20.0.

Logboekregistratie van geheugen is een procesbrede constructie. Dat betekent dat als er (bijvoorbeeld) meerdere spraakherkenningsobjecten parallel worden uitgevoerd, er één geheugenbuffer met interleaved logboeken van alle recognizers bevat. U kunt geen afzonderlijke logboeken voor elke recognizer ophalen.

Leden

Beginnen

Syntaxis: public inline static void Start ( );

Begint met aanmelden bij de interne geheugenbuffer.

Stoppen

Syntaxis: public inline static void Stop ( );

Stopt met aanmelden bij de interne geheugenbuffer.

SetFilters

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

Hiermee worden filters voor logboekregistratie van geheugen ingesteld of gewist. Zodra filters zijn ingesteld, wordt de geheugenlogger alleen bijgewerkt met logboektekenreeksen die ten minste één van de tekenreeksen bevatten die door de filters zijn opgegeven. De overeenkomst is hoofdlettergevoelig.

Parameterwaarden

• filters Optioneel. Filters die moeten worden gebruikt of een lege lijst om eerder ingestelde filters te verwijderen.

Stortplaats

Syntaxis: public inline static void Dump ( const SPXSTRING & filePath );

Hiermee schrijft u de inhoud van de volledige geheugenbuffer naar het opgegeven bestand. Er wordt niet voorkomen dat andere SDK-threads zich blijven aanmelden bij de buffer.

Parameterwaarden

• filePath pad naar een logboekbestand op de lokale schijf.

Hiermee wordt de geheugenbuffer niet opnieuw ingesteld (gewist).

Stortplaats

Syntaxis: public inline static void Dump ( std::ostream & outStream );

Hiermee schrijft u de inhoud van de hele geheugenbuffer naar een object dat std::ostream implementeert. Bijvoorbeeld std::cout (voor console-uitvoer). Er wordt niet voorkomen dat andere SDK-threads zich blijven aanmelden bij de buffer.

Parameterwaarden

• outStream std::ostream-object waarnaar moet worden geschreven.

Hiermee wordt de geheugenbuffer niet opnieuw ingesteld (gewist).

Stortplaats

Syntaxis: public inline static std::vector< std::string > Dump ( );

Retourneert de inhoud van de hele geheugenbuffer als een vector van tekenreeksen. Er wordt niet voorkomen dat andere SDK-threads zich blijven aanmelden bij de buffer.

Retouren

Een vector met de inhoud van de geheugenbuffer die erin is gekopieerd.

Hiermee wordt de geheugenbuffer niet opnieuw ingesteld (gewist).

SetLevel

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

Hiermee stelt u het niveau in van de berichten die moeten worden vastgelegd door de logboekregistratie.

Parameterwaarden

• level Maximale detailniveau dat door de logger moet worden vastgelegd.