다음을 통해 공유

class Diagnostics::Logging::FileLogger

  • 아티클

파일 기반 SDK 로깅을 제어하는 정적 메서드를 사용하는 클래스입니다. Speech SDK 시나리오를 실행하는 동안 로깅을 켜면 SDK의 핵심 네이티브 구성 요소에서 자세한 정보가 제공됩니다. Microsoft에 문제를 보고하는 경우 Microsoft에서 문제를 진단하는 데 도움이 되는 로그를 제공하라는 메시지가 표시될 수 있습니다. 애플리케이션은 예고 없이 한 SDK 릴리스에서 다른 SDK 릴리스로 변경될 수 있으므로 특정 로그 문자열에 종속되지 않아야 합니다. FileLogger는 가장 간단한 로깅 솔루션이며 Speech SDK를 실행할 때 대부분의 디바이스 내 문제를 진단하는 데 적합합니다. 버전 1.20.0에 추가되었습니다.

파일 로깅은 프로세스 전체 구문입니다. 즉, (예를 들어) 여러 음성 인식기 개체가 병렬로 실행되는 경우 모든 인식기에서 인터리브된 로그 줄을 포함하는 하나의 로그 파일이 있습니다. 각 인식기마다 별도의 로그 파일을 가져올 수 없습니다.

멤버

시작

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

파일에 대한 로깅을 시작합니다.

매개 변수

  • filePath 로컬 디스크의 로그 파일 경로

  • append 선택 사항입니다. true이면 기존 로그 파일에 를 추가합니다. false이면 새 로그 파일을 만듭니다.

파일에 대한 각 쓰기 작업 뒤에 디스크에 대한 플러시가 즉시 수행됩니다. 일반적인 사용(예: Speech Recognizer 1개 및 SSD(반도체 드라이브))의 경우 성능 문제가 발생하지 않아야 합니다. 그러나 많은 Speech SDK 인식기 또는 다른 SDK 개체를 동시에 실행할 때 파일 로깅을 방지할 수 있습니다. 대신 MemoryLogger 또는 EventLogger를 사용합니다.

중지

구문: public inline static void Stop ( );

파일에 대한 로깅을 중지합니다.

이 호출은 선택 사항입니다. 로깅이 시작된 경우 프로세스가 정상적으로 존재할 때 로그 파일이 기록됩니다.

SetFilters

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

파일 로깅에 적용되는 필터를 설정하거나 지웁니다. 필터가 설정되면 로그 문자열에 필터에 지정된 문자열 중 하나 이상이 포함된 경우에만 콜백이 호출됩니다. 일치 항목은 대/소문자를 구분합니다.

매개 변수

  • filters 선택 사항입니다. 사용할 필터 또는 이전에 설정된 필터를 제거하기 위한 빈 목록입니다.

SetLevel

구문: public inline static void SetLevel ( Level level );

로거가 캡처할 메시지의 수준을 설정합니다.

매개 변수

  • level 로거에서 캡처할 최대 세부 정보 수준입니다.