Skip to main content

Microsoft 365 application connector

Virtana Service Observability provides a ready-made connector for your Microsoft Teams, Microsoft OneDrive, Microsoft Exchange, and Microsoft SharePoint cloud applications. After you set up the Microsoft 365 application connector, you can monitor metrics for your Microsoft applications.

Before you begin

Virtana Service Observability uses the Microsoft Graph API to gain access to your Microsoft 365 applications. To enable access, first register a Microsoft 365 application in the Microsoft identity platform. To add a new Microsoft 365 credential in Virtana Service Observability, see Add Microsoft 365 credentials.

For the Microsoft application connector to access data in Microsoft Graph, you must grant it the permissions it needs. For a list of the Microsoft Graph permissions required for the connector, see Required Microsoft Graph permissions.

Set up a Microsoft 365 application connector

Note

Your account must be assigned the Manager role to create and manage connectors.

  1. Log in to Virtana Service Observability as a user with the Manager role, and then open the ADMIN > Connectors page. Click ADD CONNECTOR.

    add-connector-button.png
  2. On the SELECT CONNECTOR TYPE dialog box, click the card of the Microsoft application you want to connect to. The ADD CONNECTOR dialog box opens.

    When you select a specific Microsoft application, the ADD CONNECTOR dialog box is customized for that application. In the following example, Microsoft OneDrive is the selected application.

    MS-OneDrive-add-connector-db.png
  3. In the Microsoft <application> details section, add the following information about your application:

    1. In the Microsoft <application> Name field, enter a unique name for your application connector.

      The name you choose is used as the source name for the data that Virtana Service Observability collects.

    2. (Optional) In the Description field, enter text to associate with your Microsoft 365 instance.

    3. Keep the Connector type as the Microsoft application you are connecting to.

    4. (Optional) In the Tags field, enter one or more terms to associate with your Microsoft 365 instance.

  4. In the Microsoft <application> configurations section, add the connection information.

    1. In the Microsoft Tenant ID field, enter the tenant ID as displayed in the Essentials section on the home page of your Microsoft 365 app registration.

      ms-overview.png
    2. In the Credential list, select an existing credential or create a new one.

      When you choose Create new credential, the dialog box expands to include fields for creating a new credential for Microsoft 365.

      m365-add-credential.png

      For more information about creating a new credential, see Add Microsoft 365 credentials.

  5. (Optional) Click TEST to test your configuration before saving. A success or error message appears.

  6. Click SAVE.

To view the metrics Virtana Service Observability collects, copy a template or create a new dashboard.

Microsoft 365 application metric data

View the metrics for Microsoft 365 connectors in the following tables. Microsoft 365 connector metrics include metrics for the Teams, Exchange Online, OneDrive, and SharePoint applications.

Microsoft Teams

Microsoft Teams connector metrics include metrics for tenants, groups, and users.

Tenant metrics

Microsoft Teams tenant metrics include the following:

Metric

Units

Description

m365.active.users

Users

Total number of active users

m365.api.response.code

Status code

Graph API response status code

m365.api.response.time

Milliseconds

Graph API latency response time

m365.exchange.active.users

Users

Total number of active Exchange users

m365.exchange.inactive.users

Users

Total number of inactive Exchange users

m365.groups.mailbox.storage.size

Bytes

Total storage size of groups mailbox

m365.groups.site.storage.size

Bytes

Total storage size of groups sites

m365.office365.active.users

Users

Total number of active Office365 users

m365.office365.inactive.users

Users

Total number of inactive Office365 users

m365.onedrive.drivequota.deleted

Bytes

Total space consumed by files in the OneDrive recycle bin

m365.onedrive.drivequota.filecount

Files

Total number of OneDrive files

m365.onedrive.drivequota.remaining

Bytes

Total space remaining before reaching the OneDrive quota limit

m365.onedrive.active.users

Users

Total number of active OneDrive users

m365.onedrive.inactive.users

Users

Total number of inactive OneDrive users

m365.sharepoint.active.users

Users

Total number of active SharePoint users

m365.sharepoint.inactive.users

Users

Total number of inactive SharePoint users

m365.skype.business.active.users

Users

Total number of active Skype Business users

m365.skype.business.inactive.users

Users

Total number of inactive Skype Business users

m365.teams.active.users

Users

Total number of active Teams users

m365.teams.inactive.users

Users

Total number of inactive Teams users

m365.total.channel.files.folders

Integer

Total channel files and folders

m365.total.channel.messages

Messages

Total channel messages

m365.total.channel.tabs

Channel tabs

Total channel tabs

m365.total.channel.users

Users

Total channel users

m365.total.groups

Groups

Total number of groups

m365.total.users

Users

Total number of users

Group metrics

Microsoft Teams group metrics include the following:

Metric

Units

Description

m365.private.chat.messages

Messages

Total number of private chat messages

m365.teams.calls

Calls

Total number of calls made in Teams

m365.teams.chat.messages

Messages

Total number of chat messages in Teams

m365.teams.device.usage.android

Devices

Total number of Android devices usage in Teams

m365.teams.device.usage.iOS

Devices

Total number of iOS devices usage in Teams

m365.teams.device.usage.mac

Devices

Total number of Mac devices usage in Teams

m365.teams.device.usage.web

Devices

Total number of web device usages in Teams

m365.teams.device.usage.windows

Devices

Total number of Windows devices usage in Teams

m365.teams.device.usage.windows.phone

Devices

Total number of Windows phone usage in Teams

m365.teams.group.total.users

Users

Total number of users in Teams group

m365.teams.meetings

Meetings

Total number of Teams meetings

m365.teams.total.channels

Channels

Total channels in Teams

m365.teams.total.users

Users

Total users in Teams

m365.teams.user.calls

Calls

Total Teams users calls

m365.teams.users.api.response.code

Status code

Teams users Graph API response status code

m365.teams.users.api.response.time

Milliseconds

Teams users API response time latency

User metrics

Microsoft Teams user metrics include the following:

Metric

Units

Description

m365.teams.user.adhoc.meetings.attended

Meetings

Total Team ad-hoc meetings attended

m365.teams.user.adhoc.meetings.organized

Meetings

Total Team ad-hoc meetings organized

m365.teams.user.audio.duration

Seconds

Total audio duration

m365.teams.user.calls.average.audio.degradation

Percent

Average audio degradation during calls

m365.teams.user.calls.average.audio.network.jitter

Time

Average audio network jitter during calls

m365.teams.user.calls.average.bandwidth

Time

Average bandwidth consumed during calls

m365.teams.user.calls.average.jitter

Time

Average jitter during calls

m365.teams.user.calls.average.packet.loss.rate

Percent

Average packet loss rate during calls

m365.teams.user.calls.average.roundtrip.time

Time

Average network propagation round-trip time

m365.teams.user.calls.duration

Time

Total duration of calls

m365.teams.user.calls.maximum.audio.network.jitter

Time

Maximum audio network jitter over 20-second windows during a call

m365.teams.user.calls.maximum.jitter

Time

Maximum jitter during a call

m365.teams.user.calls.maximum.packet.loss.rate

Percent

Maximum packet loss rate during a call

m365.teams.user.calls.maximum.roundtrip.time

Time

Maximum network propagation round-trip time

m365.teams.user.chat.messages

Messages

Total Teams chat messages

m365.teams.user.meetings

Meetings

Total Teams meetings

m365.teams.user.meetings.attended

Meetings

Total Teams meetings attended

m365.teams.user.meetings.organized

Meetings

Total Teams meetings organized

m365.teams.user.private.chat.messages

Chats

Total private chats

m365.teams.user.scheduled.one.time.meetings.attended

Meetings

Total scheduled one-time meetings attended

m365.teams.user.scheduled.one.time.meetings.organized

Meetings

Total scheduled one-time meetings organized

m365.teams.user.scheduled.recurring.meetings.attended

Meetings

Total scheduled recurring meetings attended

m365.teams.user.scheduled.recurring.meetings.organized

Meetings

Total scheduled recurring meetings attended

m365.teams.user.screen.share.duration

Seconds

Total share screen duration

m365.teams.user.video.duration

Seconds

Total video duration

Microsoft Exchange Online

Microsoft Exchange Online connector metrics include the following:

Metric

Units

Description

m365.exchange.user.send.count

Messages

Email messages sent by user

m365.exchange.user.receive.count

Messages

Email messages received by user

m365.exchange.user.read.count

Messages

Email messages read by user

m365.exchange.user.meeting.created.count

Meetings

Meetings created by user

m365.exchange.user.meeting.interacted.count

Meetings

Meeting interactions by user

m365.exchange.user.assigned.products.count

Products

Products assigned to user

Microsoft OneDrive

Microsoft OneDrive connector metrics include the following:

Metric

Units

Description

m365.onedrive.total.files.count

Files

Total number of files for tenant

m365.onedrive.total.active.files.count

Files

Total number of active files for tenant

m365.onedrive.total.storage.used.inbytes

Bytes

Total storage used at tenant level

m365.onedrive.total.storage.allocated.inbytes

Bytes

Total allocated storage for tenant

m365.onedrive.user.files.count

Files

Current user’s file count

m365.onedrive.user.active.files.count

Files

Current user’s active file count

m365.onedrive.user.storage.used.inbytes

Bytes

Storage used by user

m365.onedrive.user.storage.allocated.inbytes

Bytes

Storage allocated to user

Microsoft SharePoint

Microsoft SharePoint connector metrics include the following:

Metric

Units

Description

m365.sharepoint.user.viewedOredited.file.count

Files

Viewed or edited files by user

m365.sharepoint.user.synced.file.count

Files

Synced files by user

m365.sharepoint.user.sharedInternally.file.count

Files

Files shared internally by user

m365.sharepoint.user.sharedExternally.file.count

Files

Files shared externally by user

m365.sharepoint.user.visited.page.count

Pages

Pages visited by user

m365.sharepoint.assigned.products.count

Products

Products assigned to user