Path: Grafana → Administration → Plugins → MS Teams Observability → Configuration
The Provisioning page exposes 6 configuration sections . Each section saves independently without page reload, and changes are synchronized live across the app. An error alert appears at the top if plugin settings cannot be synced.
Purpose: Configure the Microsoft Graph API connection for live call data retrieval . Required for live mode — without this, the app only works in demo mode.
Field Required Description Default Tenant ID Yes Your Azure AD tenant ID (GUID) None Client ID Yes Azure AD application (client) ID None Client Secret Yes Azure AD client secret (stored securely, masked in UI) None
Go to Azure Portal → App registrations → New registration .
Give it a name (e.g., MS Teams Observability).
Under Certificates & secrets , create a client secret .
Under API permissions , add Microsoft Graph → Application permissions → CallRecords.Read.All .
Click Grant admin consent .
Note the Tenant ID , Client ID , and Client secret .
Enter them in this panel and click Save .
Feature Without config With config Demo Mode ✅ Works ✅ Works Live Mode ❌ Not available ✅ Works Call Overview ✅ Works (no download) ✅ Works with download
Purpose: Configure the Loki datasource connection and toggle between Demo and Live mode.
Setting Required Description Default Demo Mode Yes Toggle between demo data (built-in JSON fixtures) and live mode (Loki queries) OnLoki Datasource UID Conditional The Grafana UID of the Loki datasource to query. Required when Demo Mode is Off . None
Go to Grafana → Connections → Data Sources .
Find your Loki datasource.
The UID is shown in the URL or in the datasource settings page (e.g., P208D7C6E71A2D3B4).
Situation Mode First-time evaluation Demo Mode No collector installed yet Demo Mode Collector is running and writing to Loki Live Mode (switch Demo Mode Off) Demos and presentations Demo Mode
Purpose: Filter the Sites view to internal users only . Only users with email addresses matching the configured domains appear in site-level analytics.
Setting Description Domain List Comma-separated list of email domains (e.g., @mycompany.com, @mycompany.fr)
External participants (guests, vendors) are common in your Teams calls
You want site analytics focused on internal users only
Setting Result Empty (no domains) All users included in Sites analytics One or more domains Only users with matching email domains are included
Purpose: Configure an optional URL template for linking IP addresses to your IP Address Management (IPAM) solution.
Setting Description Example Link Template URL containing {{ip}} placeholder https://ipam.company.com/ip/{{ip}}/details
When configured, IP addresses in the Network Diagnostics panels on the Call Overview page become clickable links, opening your IPAM system to that specific IP.
Purpose: Upload a CSV mapping of network subnets to geographic locations. This is required for the Sites page, which uses this mapping to aggregate call quality by location.
subnet,location,latitude,longitude
10.0.0.0/24,Paris Office,48.8566,2.3522
10.1.0.0/16,London Office,51.5074,-0.1278
Column Type Description subnetCIDR Network subnet (e.g., 10.64.0.0/24) locationString Human-readable location name latitudeNumber -90 to 90 longitudeNumber -180 to 180
The section supports full Create, Read, Update, Delete of subnet mappings:
Action Description Upload CSV Import a full set of mappings Add row Manually add a single subnet/location entry Edit Modify an existing mapping Delete Remove a mapping Unsaved changes indicatorAppears when mappings are modified before saving
First-time setup of the app — without subnet mappings, the Sites page shows no location data.Adding new offices or network segments.Network changes (new subnets, datacenter migrations).
Purpose: Enable or disable IP geolocation via ip-api.com for the Call Map .
Setting Description Default Enable GeoIP Toggle to enable/disable IP geolocation Off
You want the Call Map to show approximate geographic locations for participants based on their public IP addresses.
Your organization allows third-party API calls for geolocation.
Setting Call Map behavior GeoIP Off (default) Only site-mapped locations appear (from the Subnet Location CSV). Unmapped IPs show as “Unknown”. GeoIP On Public IPs are geolocated via ip-api.com. Unmapped IPs show approximate city-level locations.
