Microsoft Teams
The Microsoft Teams app provides out-of-the-box dashboards to monitor users, teams, channels and permission changes.
Log types
The Teams app provides visibility into the logging that Microsoft exposes in the Office 365 Audit Logs for Microsoft Teams. Logged events are grouped into the following categories:
- User Sessions
- Teams
- Channels
- Users and Roles
For more information, see Microsoft’s list of Teams Activities.
Sample log messages
"CreationTime":"2020-10-30T14:00:51",
"Id":"e40689dc-7ea9-4f75-8fdd-8c3c9f9bf647",
"Operation":"TeamCreated",
"OrganizationId":"984e32e5-f98a-4600-aa32-27c3f948abe3",
"RecordType":25,
"UserKey":"d9d7d5ac-4d64-43df-8205-fa6f46388fcb",
"UserType":0,
"Version":1,
"Workload":"MicrosoftTeams",
"UserId":"email@domain.com",
"TeamGuid":"19:caac0ef5091e431aa45a6b6ec4a6723a@thread.tacv2",
"TeamName":"My Team"
Sample queries
_sourceCategory="O365/General"
| json "Workload", "Operation" , "UserId" as workload, operation, email
| where workload = "MicrosoftTeams"
| count by operation
Collecting logs
This section has instructions for collecting logs for the Sumo App for Teams.
Collection process overview
To collect logs for Microsoft Teams, please configure an Office 365 Audit Source. The Teams logs will be present in the “Office 365 General Logs” context. Note, that if you are already collecting logs for Office 365, you can simply make note of the source category configured for the aforementioned context.
Installing the Microsoft Teams App
This section shows you how to install the Sumo Logic App for Microsoft Teams.
To install the app:
- Select App Catalog.
- In the 🔎 Search Apps field, run a search for your desired app, then select it.
- Click Install App.
note
Sometimes this button says Add Integration.
- On the next configuration page, under Select Data Source for your App, complete the following fields:
- Data Source. Select one of the following options:
- Choose Source Category and select a source category from the list; or
- Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. For example,
_sourceCategory=MyCategory
.
- Folder Name. You can retain the existing name or enter a custom name of your choice for the app.
- All Folders (optional). The default location is the Personal folder in your Library. If desired, you can choose a different location and/or click New Folder to add it to a new folder.
- Data Source. Select one of the following options:
- Click Next.
- Look for the dialog confirming that your app was installed successfully.
Post-installation
Once your app is installed, it will appear in your Personal folder or the folder that you specified. From here, you can share it with other users in your organization. Dashboard panels will automatically start to fill with data matching the time range query received since you created the panel. Results won't be available immediately, but within about 20 minutes, you'll see completed graphs and maps.
Viewing Microsoft Teams Dashboards
Overview
The Teams - Overview dashboard provides an at-a-glance view of the state of your Teams environment in terms of user sessions, teams and channel activity, and user role changes
Use this dashboard to:
- Identify user sessions relative to their locations.
- Report the top users creating teams and channels.
- Identify the top team bots and channels connectors being used.
- Report on the top users and objects relative to role changes.
User Sessions
The Teams - User Sessions dashboard provides an in depth view of the user logins and related statistics in your Teams environment
Use this dashboard to:
- Identify user sessions relative to their locations and compare login statistics over time.
- Understand the client platforms and versions that are being used.
- Report on login IP addresses correlated to potential threats via Crowdstrike.
Team Statistics
The Teams - Team Statistics dashboard offers complete details on the Team activity occurring in your organization.
Use this dashboard to:
- Gain insight into teams being added and removed.
- Understand the team setting changes.
- Keep track of the team Bots being installed.
Channel Statistics
The Teams - Channel Statistics dashboard offers complete visibility into the Channel activity occurring in your Teams.
Use this dashboard to:
- Gain insight into the channels being added and removed.
- Understand the channel settings being modified.
- Monitor channel tab activity.
- Monitor and report on channel connectors being added and removed.
User and Role Changes
The Teams - User and Role Changes dashboard provides insight on the user and role changes being applied in your environment.
Use this dashboard to:
- Report on the users making role changes and the top object types being affected.
- Understand how members are being added, removed, and changed by object name.