Delen via

class Diagnostics::Logging::FileLogger

  • Artikel

Klasse met statische methoden voor het beheren van op bestanden gebaseerde SDK-logboekregistratie. Het inschakelen van logboekregistratie tijdens het uitvoeren van uw Speech SDK-scenario biedt gedetailleerde informatie over de belangrijkste systeemeigen onderdelen van de SDK. Als u een probleem aan Microsoft meldt, wordt u mogelijk gevraagd om logboeken op te geven om Microsoft te helpen bij het vaststellen van het probleem. Uw toepassing mag niet afhankelijk zijn van bepaalde logboektekenreeksen, omdat deze zonder kennisgeving kunnen worden gewijzigd van de ene SDK-release naar de andere. FileLogger is de eenvoudigste oplossing voor logboekregistratie en geschikt voor het diagnosticeren van de meeste problemen op het apparaat bij het uitvoeren van de Speech SDK. Toegevoegd in versie 1.20.0.

Logboekregistratie van bestanden is een procesbrede constructie. Dit betekent dat als er (bijvoorbeeld) meerdere spraakherkenningsobjecten parallel worden uitgevoerd, er één logboekbestand is met interleaved logboekregels van alle recognizers. U kunt geen afzonderlijk logboekbestand voor elke herkenningsfunctie ophalen.

Leden

Starten

Syntaxis: public inline static void Start ( const std::string & filePath , bool append );

Hiermee wordt de logboekregistratie naar een bestand gestart.

Parameters

  • filePath Pad naar een logboekbestand op lokale schijf

  • append Optionele. Indien waar, wordt toegevoegd aan het bestaande logboekbestand. Indien onwaar, maakt u een nieuw logboekbestand

Houd er rekening mee dat elke schrijfbewerking naar het bestand onmiddellijk wordt gevolgd door een flush naar schijf. Voor normaal gebruik (bijvoorbeeld één Spraakherkenningsserver en een SSD (Solid State Drive)) zou dit geen prestatieproblemen moeten veroorzaken. Het is echter mogelijk dat u bestandslogboekregistratie wilt voorkomen wanneer u veel Speech SDK-herkenningsservers of andere SDK-objecten tegelijk uitvoert. Gebruik in plaats daarvan MemoryLogger of EventLogger.

Stoppen

Syntaxis: public inline static void Stop ( );

Stopt de logboekregistratie bij een bestand.

Deze aanroep is optioneel. Als logboekregistratie is gestart, wordt het logboekbestand geschreven wanneer het proces normaal bestaat.

SetFilters

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

Hiermee worden de filters ingesteld of gewist die van toepassing zijn op logboekregistratie van bestanden. Zodra filters zijn ingesteld, wordt de callback alleen aangeroepen als de logboektekenreeks ten minste een van de tekenreeksen bevat die door de filters zijn opgegeven. De overeenkomst is hoofdlettergevoelig.

Parameters

  • filters Optionele. Te gebruiken filters of een lege lijst om eerder ingestelde filters te verwijderen.

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.

Parameters

  • level Het maximale detailniveau dat door de logger moet worden vastgelegd.