class Diagnostics::Logging::FileLogger

  • Článek

Třída se statickými metodami pro řízení protokolování sady SDK založeného na souborech. Zapnutí protokolování při spuštění scénáře sady Speech SDK poskytuje podrobné informace ze základních nativních komponent sady SDK. Pokud microsoftu nahlásíte problém, můžete být požádáni o poskytnutí protokolů, které microsoftu pomůžou problém diagnostikovat. Vaše aplikace by neměla být závislá na konkrétních řetězcích protokolu, protože se můžou změnit z jedné verze sady SDK na jinou bez předchozího upozornění. FileLogger je nejjednodušší řešení protokolování, které je vhodné pro diagnostiku většiny problémů na zařízení při spuštění sady Speech SDK. Přidáno ve verzi 1.20.0.

Protokolování souborů je konstruktor pro celý proces. To znamená, že pokud (například) máte paralelně spuštěných více objektů rozpoznávání řeči, bude existovat jeden soubor protokolu obsahující řádky prokládání protokolů ze všech rozpoznávatelů. Pro každý rozpoznávatel nelze získat samostatný soubor protokolu.

Členové

Spustit

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

Spustí protokolování do souboru.

Parametry

  • filePath Cesta k souboru protokolu na místním disku

  • append Volitelné. Pokud je true, připojí se k existujícímu souboru protokolu. Pokud je false, vytvoří nový soubor protokolu.

Po každé operaci zápisu do souboru okamžitě následuje vyprázdnění na disk. U typického použití (např. jednoho rozpoznávání řeči a jednotky SSD)) by to nemělo způsobovat problémy s výkonem. Při souběžném spouštění mnoha rozpoznávání sady Speech SDK nebo jiných objektů sady SDK se však můžete chtít vyhnout protokolování souborů. Místo toho použijte MemoryLogger nebo EventLogger.

Zastavit

Syntaxe: public inline static void Stop ( );

Zastaví protokolování k souboru.

Toto volání je volitelné. Pokud se protokolování spustí, soubor protokolu se zapíše, když proces normálně existuje.

Nastavit filtry

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

Nastaví nebo vymaže filtry, které platí pro protokolování souborů. Po nastavení filtrů se zpětné volání vyvolá pouze v případě, že řetězec protokolu obsahuje alespoň jeden z řetězců určených filtry. Při shodě se rozlišují malá a velká písmena.

Parametry

  • filters Volitelné. Filtry, které chcete použít, nebo prázdný seznam pro odebrání dříve nastavených filtrů.

Nastavit úroveň

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

Nastaví úroveň zpráv, které mají být zaznamenány protokolovacím nástrojem.

Parametry

  • level Maximální úroveň podrobností, kterou protokolovací nástroj zachytí.