다음을 통해 공유

class Diagnostics::Logging::EventLogger

  • 아티클

콜백 기반 SDK 로깅을 제어하는 정적 메서드를 사용하는 클래스입니다. Speech SDK 시나리오를 실행하는 동안 로깅을 켜면 SDK의 핵심 네이티브 구성 요소에서 자세한 정보가 제공됩니다. Microsoft에 문제를 보고하는 경우 Microsoft에서 문제를 진단하는 데 도움이 되는 로그를 제공하라는 메시지가 표시될 수 있습니다. 애플리케이션은 예고 없이 한 SDK 릴리스에서 다른 SDK 릴리스로 변경될 수 있으므로 특정 로그 문자열에 종속되지 않아야 합니다. 새 로그 문자열을 사용할 수 있는 즉시 액세스하려는 경우 EventLogger를 사용하고 추가로 처리해야 합니다. 예를 들어 Speech SDK 로그를 기존 로깅 컬렉션 시스템과 통합합니다. 버전 1.20.0에 추가되었습니다.

이벤트 로깅은 프로세스 전체 구문입니다. 즉, 여러 음성 인식기 개체가 병렬로 실행되는 경우 모든 인식기에서 인터리브 로그를 수신하도록 하나의 콜백 함수만 등록할 수 있습니다. 각 인식기마다 별도의 콜백을 등록할 수 없습니다.

멤버

SetCallback

구문: public inline static void SetCallback ( CallbackFunction_Type callback );

각 새 로그 메시지에 대해 호출될 콜백 함수를 등록합니다.

매개 변수

  • callback 호출할 콜백 함수입니다. nullptr 값을 설정하여 이벤트 로거를 중지합니다.

하나의 콜백 함수만 등록할 수 있습니다. 이 호출은 SDK의 작업 스레드에서 발생하므로 다른 스레드에서 추가 처리를 위해 로그 문자열을 어딘가에 복사해야 하며 함수는 즉시 반환되어야 합니다. 이 콜백 함수에서는 과도한 처리 또는 네트워크 호출을 수행해서는 안 됩니다.

SetFilters

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

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

매개 변수

  • filters 선택 사항입니다. 사용할 필터 또는 이전에 설정한 필터를 지우는 빈 목록

SetLevel

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

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

매개 변수

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

CallbackFunction_Type

구문: typedef CallbackFunction_Type;