【Teams】レポート機能の概要

はじめに

Microsoft Teams のレポート機能の概要についてまとめてみました。

Teams のレポート機能

Teams ではチームやユーザーの利用状況に関する多数のレポートが用意されています。

(参考：Microsoft Teams の分析とレポート)
https://learn.microsoft.com/ja-jp/microsoftteams/teams-analytics-and-reports/teams-reporting-reference

閲覧に必要なロール

レポートの閲覧には以下のようなロールが必要です。

• Teams 管理者
• グローバル閲覧者

レポートの確認方法

1. Teams 管理センターから [分析 & レポート] - [使用状況レポート] をクリックします
   [レポートを選択] のプルダウンから確認したいレポートを選択します
   
2. [日付の範囲] から期間を選択し、[レポートを実行] をクリックします
   
3. レポートが表示されます
   

ID や名前がマスキングされている場合

Microsoft 365 管理センターの [組織設定]-[サービス]-[レポート] で [ユーザー、グループ、サイト名を隠蔽してすべてのレポートに表示する] の設定に ✅ が入っていると、レポート内のチームやユーザーがマスキングされて表示されます。

マスキングを解除したい場合には、この設定をオフにします。

(参考：ユーザー固有のデータを匿名にする)
https://learn.microsoft.com/ja-jp/microsoftteams/teams-analytics-and-reports/teams-reporting-reference#make-the-user-specific-data-anonymous

Graph API で情報を取得する方法

以下のようなレポートは Graph API からも取得することができます。

• チームのアクティビティ
• ユーザーのアクティビティ
• デバイスの使用状況

例としてチームのアクティビティレポートを Graph PowerShell で取得してみます。

※ Graph PowerShell のインストール方法については以下の記事にあります。

1. PowerShell で以下のコマンドを実行します

   Connect-MgGraph -Scopes "Reports.Read.All"
   

2. 管理者でサインインを行い、以下のダイアログで [承諾] をクリックします
   

3. 以下のコマンドでレポートを取得します

   # レポートの出力先フォルダを指定してください。
   $OutputFilePath = "C:\Temp\report.csv"
   # getTeamsTeamActivityDetail API の URI を指定します。
   # period='D30' で過去 30 日の期間を指定しています。
   $Uri = "/v1.0/reports/getTeamsTeamActivityDetail(period='D30')" 
   Invoke-MgGraphRequest -Method GET -Uri $Uri -OutputType PSObject -OutputFilePath $OutputFilePath
   

コマンドを実行すると、指定した場所に CSV ファイルでレポートが出力されます。

※ 出力されるレポートの例

Report Refresh Date,Team Id,Team Name,Last Activity Date,Team Type,Is Deleted,Report Period,Active Users,Active Channels,Channel Messages,Reactions,Meetings Organized,Post Messages,Reply Messages,Urgent Messages,Mentions,Guests,Active Shared Channels,Active External Users
2025-06-19,0739e6fd-7f39-4ef7-bbd2-be3e7830fd82,My Sample Team,2024-06-19,Public,True,30,0,0,0,0,0,0,0,0,0,0,0,0
...

(参考：reportRoot: getTeamsTeamActivityDetail)
https://learn.microsoft.com/ja-jp/graph/api/reportroot-getteamsteamactivitydetail?view=graph-rest-1.0&tabs=http

(参考：reportRoot: getTeamsUserActivityUserDetail)
https://learn.microsoft.com/ja-jp/graph/api/reportroot-getteamsuseractivityuserdetail?view=graph-rest-1.0&tabs=http

(参考：reportRoot: getTeamsDeviceUsageUserDetail)
https://learn.microsoft.com/ja-jp/graph/api/reportroot-getteamsdeviceusageuserdetail?view=graph-rest-1.0&tabs=http