次の方法で共有

クラス Diagnostics::Logging::FileLogger

  • [アーティクル]

ファイルベースの SDK ログ記録を制御するための静的メソッドを持つクラス。 Speech SDK シナリオの実行中にログ記録を有効にすると、SDK のコア ネイティブ コンポーネントから詳細情報が提供されます。 Microsoft に問題を報告した場合は、Microsoft が問題を診断するのに役立つログを提供するように求められる場合があります。 アプリケーションは特定のログ文字列に依存しないようにする必要があります。これは、SDK リリース間で予告なしに変更される可能性があるためです。 FileLogger は最も簡単なログ記録ソリューションであり、Speech SDK の実行時にデバイス上のほとんどの問題を診断するのに適しています。 バージョン 1.20.0 で追加されました。

ファイル ログは、プロセス全体のコンストラクトです。 つまり、(たとえば) 複数の音声認識エンジン オブジェクトが並列で実行されている場合、すべての認識エンジンのインターリーブログ行を含む 1 つのログ ファイルが存在します。 認識エンジンごとに個別のログ ファイルを取得することはできません。

メンバー

開始

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

ファイルへのログ記録を開始します。

パラメーター

  • filePath ローカル ディスク上のログ ファイルへのパス

  • append 省略可能。 true の場合は、既存のログ ファイルに を追加します。 false の場合は、新しいログ ファイルを作成します

ファイルに対する各書き込み操作の直後に、ディスクへのフラッシュが実行されることに注意してください。 一般的な使用 (たとえば、1 つの Speech Recognizer とソリッド ステート ドライブ (SSD)) の場合、パフォーマンスの問題は発生しません。 ただし、多数の Speech SDK 認識エンジンまたは他の SDK オブジェクトを同時に実行する場合は、ファイル のログ記録を避けたい場合があります。 代わりに MemoryLogger または EventLogger を使用してください。

Stop

構文: public inline static void Stop ( );

ファイルへのログ記録を停止します。

この呼び出しは省略可能です。 ログ記録が開始されると、プロセスが正常に存在するときにログ ファイルが書き込まれます。

SetFilters

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

ファイル ログに適用されるフィルターを設定またはクリアします。 フィルターが設定されると、ログ文字列にフィルターで指定された文字列の少なくとも 1 つが含まれている場合にのみ、コールバックが呼び出されます。 一致では大文字と小文字が区別されます。

パラメーター

  • filters 省略可能。 使用するフィルター、または以前に設定したフィルターを削除する空のリスト。

SetLevel

構文: public inline static void SetLevel ( Level level );

ロガーによってキャプチャされるメッセージのレベルを設定します。

パラメーター

  • level ロガーによってキャプチャされる最大詳細レベル。