次の方法で共有


Teams で監視とトラブルシューティングを行うログ ファイルを構成する

クライアントによって自動的に生成されるログ ファイルには 3 種類あります。これは、Teams の監視とトラブルシューティングを支援するために利用できます。

この記事では、これらのログとその使用方法について説明します。 特定の問題のトラブルシューティングについては、「 Teams のトラブルシューティング」を参照してください。

Microsoft Teams Rooms デバイスからログを収集する方法については、「 デバイス ログのダウンロード」を参照してください。

サポートに問い合わせる方法については、「 サポートを受ける」を参照してください。

注意

この記事では、 デバッグ ログ (Web ログとも呼ばれます) という用語は、トラブルシューティングに使用されるログを指します。 ただし、これらのログに対して生成されるファイルには、名前に 診断ログ という用語が含まれます。

ログの概要

問題が発生したらすぐにログを収集することが重要です。

Microsoft サポートでサポート リクエストを作成する場合、サポート エンジニアはデバッグ ログを必要とします。 サポート要求を作成する前にデバッグ ログを手元に置くと、Microsoft は問題のトラブルシューティングをすばやく開始できます。 メディア ログまたは デスクトップ ログは、Microsoft から要求された場合にのみ必要です。

ログ収集

デバッグ/Web ログ、デスクトップ ログ、およびメディア ログは、 MSTeams Diagnostics ログという名前の 1 つのフォルダー <ローカルの日付と時刻> ダウンロード ディレクトリに配置されます。 このフォルダーは、Microsoft サポートでサポート リクエストを開いたときに圧縮および共有できます。 フォルダーには、デスクトップ、会議 (メディア)、デバッグ (Web) 用のフォルダーが含まれます。

  • Windows のログを収集するには:
    • システム トレイの [Microsoft Teams] アイコンを選択し、[ サポート ファイルの収集] を選択します。
  • Mac 用のログを収集するには:
    • Microsoft Teamsで [ヘルプ] メニューを選択し、[ サポート ファイルの収集] を選択します。
  • Linux のログを収集するには:
    • システム トレイの [Microsoft Teams] アイコンを選択し、[ログの 取得] を選択します。

Windows と Linux: Ctrl + Alt + Shift + 1 Mac: Option + Command + Shift + 1 というキーボード ショートカットを使用してファイルを収集することもできます。

特定の会議またはライブ イベントで問題が発生した場合は、会議に URL を関連付けるのが役立ちます。 URL は、ログ内の正確な会議またはライブ イベントを特定するのに役立つ追加情報を提供します。 この情報は、会議の任意の参加者から、またはライブ イベントの発表者またはプロデューサーから収集できます。 この URL は、結合 URL の上にマウス ポインターを合わせ、[ ハイパーリンクのコピー] を選択することでキャプチャできます。

次の表は、さまざまなクライアントとその関連ログの概要を示しています。 収集される前に、ログ ファイルは Teams アプリ フォルダーに格納され、フォルダーの場所はクライアントとオペレーティング システムに固有です。

  • ウィンドウズ: %appdata%\Microsoft\Teams\
  • Mac: ~/Library/Application Support/Microsoft/Teams/
  • Linux: ~/.config/Microsoft/Microsoft Teams/
クライアント デバッグ 継続的デバッグ デスクトップ メディア
Web X - - -
Windows X X X X
Mac OSX X X X X
iOS - - - -
Android - - - -

サポートされるオペレーティング システムとブラウザーの完全なリストについては、「Microsoft Teams のクライアントを取得する」をご覧ください。

デバッグ ログ

デバッグ ログ (Web ログとも呼ばれます) は、Windows および Mac デスクトップ クライアント、およびブラウザー ベースのクライアントによって生成されます。 ログはテキストベースであり、下から上に読み取られます。 任意のテキスト ベースのエディターを使用して読み取ることができ、クライアントにログインするときに新しいログが作成されます。

デバッグ ログには次のデータ フローが表示されます。

  • ログイン
  • 中間層サービスへの接続要求
  • 通話/会話

継続的デバッグ ログ

継続的デバッグ ログ (継続的 Web ログとも呼ばれます) は、ログをメモリからファイル システムに継続的に自動的に転送することでログ データをキャプチャするのに役立つ機能です。 有効にすると、平均して 1 日分のログ データが使用可能になります。 ログは上から下に読み取られます。

コンピューターの Teams デスクトップでは、CPU が次の場合、継続的なデバッグ/Web ログ記録が既定で有効になります。

  • Intel Core i3 および Core i5 (第 10 世代以上)、Core i7 および Core i9 (任意の世代)、次のサフィックスを除く:U、Y、G1-G7、UE、UL、M、QM
  • Intel Xeon
  • AMD Ryzen 5、7、9、および TR シリーズ (U サフィックスを除く)
  • Apple Silicon

それ以外の場合は、既定でオフになります。

管理者の構成

エンド ユーザーの継続的なデバッグ/Web ログ記録を管理すると、特に問題が断続的な場合に、シームレスなトラブルシューティング エクスペリエンスが提供されます。 管理者は、TeamsMediaLoggingPolicy コマンドレットを使用して、ユーザーの継続的なデバッグ/Web ログ記録を有効および管理できます。

PowerShell コマンドレットの Grant-CsTeamsMediaLoggingPolicy に関するページを参照してください。

メディア ログ

メディア ログには、Teams 会議でのオーディオ、ビデオ、画面共有に関する診断データが含まれています。 これらは、呼び出し関連の問題にリンクされているサポート ケースに必要です。

注意

新しい Teams では、パフォーマンスの向上と最適化により、メディア ログが既定で有効になります。 メディア ログ記録のエンド ユーザーまたは管理者コントロールはありません。

クラシック Teams では、CPU が次の場合、コンピューターのメディア ログは既定でオンになります。

  • 任意の Apple M1
  • 任意の Intel Xeon
  • U、G7、M、MQ シリーズを除く任意の Intel i9
  • U、G7、M、MQ シリーズを除く第 6 世代以降の Intel i7

それ以外の場合は、既定でオフになります。 Teams 会議の診断データをログに記録するには、次の 2 つの方法があります。

  • 管理者の構成 - エンド ユーザーのメディア ログを管理できます
  • エンド ユーザーの構成 - エンド ユーザーがメディア ログを有効にすることができます

注意

メディア ログは、WebRTC ベースのプラットフォーム (最適化されたメディアを使用した Teams ブラウザー クライアントとクラシック Teams for VDI) では使用できません。 ブラウザー クライアントで追加の WebRTC ログを収集する手順については、「 ブラウザー ログと Teams のトレース 」を参照してください。 Teams for VDI を使用する場合に WebRTC ログを収集する手順については、 VDI プロバイダーにお問い合わせください。

管理者の構成

エンド ユーザーのメディア ログを管理すると、特に問題が断続的な場合に、シームレスなトラブルシューティング エクスペリエンスが提供されます。 管理者は、TeamsMediaLoggingPolicy コマンドレットを使用して、ユーザーのメディア ログを有効にして管理できます。

PowerShell コマンドレットの Grant-CsTeamsMediaLoggingPolicy に関するページを参照してください。

エンド ユーザーの構成

エンド ユーザーが Teams 会議の診断データをログに記録するには、Teams クライアントでオプションをオンにする必要があります。 [設定>全般] に移動し、[メディア ログ (オーディオ、ビデオ、画面共有の診断データ) を有効にする] チェック ボックスをオンにして、問題を再現します。

注意

ユーザーが Teams からサインアウトすると、メディア ログは既定にリセットされます。

デスクトップ ログ

デスクトップ ログ (ブートストラップ ログとも呼ばれます) には、デスクトップ クライアントとブラウザーの間で発生するログ データが含まれています。 メディア ログと同様に、これらのログは Microsoft から要求された場合にのみ必要です。 ログはテキストベースであり、トップダウン形式の任意のテキストベースのエディターを使用して読み取ることができます。

Teams のトラブルシューティング

Teams のブラウザー ログとトレース