Udostępnij za pośrednictwem

class Diagnostics::Logging::MemoryLogger

  • Artykuł

Klasa ze statycznymi metodami kontrolowania logowania zestawu SDK do buforu w pamięci. Włączenie rejestrowania podczas uruchamiania scenariusza zestawu Speech SDK zawiera szczegółowe informacje z podstawowych składników natywnych zestawu SDK. Jeśli zgłosisz problem do firmy Microsoft, może zostać wyświetlony monit o podanie dzienników, aby pomóc firmie Microsoft zdiagnozować problem. Aplikacja nie powinna być zależna od określonych ciągów dziennika, ponieważ może ulec zmianie z jednej wersji zestawu SDK na inną bez powiadomienia. MemoryLogger jest przeznaczony dla przypadku, w którym chcesz uzyskać dostęp do dzienników, które zostały podjęte w krótkim czasie, zanim wystąpi nieoczekiwane zdarzenie. Jeśli na przykład korzystasz z rozpoznawania mowy, możesz chcieć zrzucić dziennik pamięci po otrzymaniu zdarzenia wskazującego, że rozpoznawanie zostało anulowane z powodu błędu. Rozmiar buforu pamięci jest stały na poziomie 2 MB i nie można go zmienić. Jest to bufor "pierścień", czyli nowe ciągi dziennika zapisane zastąp najstarsze w buforze. Dodano w wersji 1.20.0.

Rejestrowanie pamięci to szeroka konstrukcja procesu. Oznacza to, że jeśli (na przykład) masz wiele obiektów rozpoznawania mowy działających równolegle, będzie jeden bufor pamięci zawierający przeplatane dzienniki ze wszystkich rozpoznających. Nie można pobrać oddzielnych dzienników dla każdego rozpoznawania.

Elementy członkowskie

Rozpocznij

Składnia: public inline static void Start ( );

Rozpoczyna logowanie się do wewnętrznego buforu pamięci.

Stop

Składnia: public inline static void Stop ( );

Zatrzymuje logowanie się do wewnętrznego buforu pamięci.

SetFilters

Składnia: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Ustawia lub czyści filtry rejestrowania pamięci. Po ustawieniu filtrów rejestrator pamięci zostanie zaktualizowany tylko przy użyciu ciągów dziennika zawierających co najmniej jeden z ciągów określonych przez filtry. Dopasowanie uwzględnia wielkość liter.

Parametry

  • filters Opcjonalne. Filtry do użycia lub pusta lista do usunięcia poprzednio ustawionych filtrów.

Zrzutu

Składnia: public inline static void Dump ( const SPXSTRING & filePath );

Zapisuje zawartość całego buforu pamięci do określonego pliku. Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Parametry

  • filePath Ścieżka do pliku dziennika na dysku lokalnym.

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

Zrzutu

Składnia: public inline static void Dump ( std::ostream & outStream );

Zapisuje zawartość całego buforu pamięci do obiektu, który implementuje element std::ostream. Na przykład std::cout (dla danych wyjściowych konsoli). Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Parametry

  • outStream std::ostream, do zapisu.

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

Zrzutu

Składnia: public inline static std::vector< std::string > Dump ( );

Zwraca zawartość całego buforu pamięci jako wektor ciągów. Nie blokuje on innych wątków zestawu SDK w celu kontynuowania logowania się do buforu.

Zwraca

Wektor z zawartością buforu pamięci skopiowany do niego.

Nie powoduje to zresetowania (wyczyść) buforu pamięci.

SetLevel

Składnia: public inline static void SetLevel ( Level level );

Ustawia poziom komunikatów do przechwycenia przez rejestrator.

Parametry

  • level Maksymalny poziom szczegółowości przechwytywany przez rejestrator.