MS Teams Observability - Grafana Application

The MS Teams Observability Grafana Application provides ready-to-use visualizations to monitor Microsoft Teams inside Grafana.

Installed in a Grafana environment, the application provides operational visibility into Microsoft Teams activity and quality using telemetry collected by the agent and stored in a Loki datasource. It helps organizations monitor collaboration experience, investigate service degradations, analyze call quality, and support operational troubleshooting workflows across engineering, operations, and support teams.

The application is designed to work with the Microsoft Teams Observability Agent, which collects and forwards the data used by the dashboards and investigation views.

The application also supports a Demo Mode with built-in sample data, allowing evaluation, testing, or demonstrations without requiring a live collector connection.

Requirements

• Grafana >= 12.3.0
• A Loki datasource configured in the Grafana instance, containing the logs emitted by the Microsoft Teams Observability Agent (Live Mode only)
• The Microsoft Teams Observability Agent deployed against the target tenant (Live Mode only)

Demo Mode has no runtime dependencies and can be used immediately after installation.

Getting Started

Installation

The application can be installed from the Grafana plugin catalog or by uploading the application ZIP package manually through the Grafana CLI.

Once installed, enable the app from Administration -> Plugins -> MS Teams Observability -> Enable.

First use

The app ships with Demo Mode enabled by default - open any of its pages and you can explore the full UI with built-in sample data, with no configuration required.

To switch to Live Mode:

1. Open the Configuration page of the app.
2. Select the Loki datasource that receives telemetry from the Teams Observability Agent.
3. Toggle Demo Mode off.

The Test button in the plugin configuration reports the current mode and confirms that a Loki datasource is wired up when Live Mode is active.

Features

The application provides several views addressing different operational needs:

Home

High-level observability cockpit for Microsoft Teams, showing a 7-day summary of call activity and quality with KPI cards, call health distribution, and platform distribution.

Calls

Searchable and filterable list of recorded Microsoft Teams calls, used to locate calls quickly, investigate quality problems, and navigate to a detailed call analysis view.

Call Overview

Detailed analysis of a single Microsoft Teams call, including participants, locations, quality indicators, stream-level metrics, timeline data, and optional AI-generated root cause analysis.

Users

Per-user analytics across the Microsoft Teams environment, including identity, call statistics, network information, device details, and recent activity.

Sites

Aggregated analysis of call quality and network performance by geographic location and subnet, helping identify localised degradations and network-related patterns.

Issues

Displays Microsoft service health incidents affecting the tenant, including active and recently resolved issues, to help correlate degradations with known Microsoft outages.

Configuration

Central configuration area for the application, including license management, demo mode toggle, Loki datasource selection, feature status, Microsoft configuration, domain filters, and permissions.

Operating Modes

The application supports two operating modes:

• Demo Mode - uses built-in sample data and can be used immediately after installation
• Live Mode - uses real tenant data sent by the collector and stored in the configured Loki datasource

This makes it possible to evaluate the UI and workflows before switching to production data.

Related Components

Teams Observability Agent

Collector project used to send Microsoft Teams observability data to Loki:

• Phenisys/microsoft-teams-observability

Support

Issues and feature requests can be submitted by opening a GitHub Issue on the plugin repository.