Skip to content
MS Teams Observability MS Teams Observability

Plugin Installation

The MS Teams Observability plugin is published on the Grafana Plugin Catalog. The plugin ID is phenisys-msteamsobservability-app.

Requirements:

  • Supported Grafana instance
  • A Loki datasource (self-hosted or Grafana Cloud) receiving MS Teams logs
  • For GeoIP features (Call Map): the optional Subnet Location datasource

Install from Plugin Catalog

Section titled “Install from Plugin Catalog”
  1. In your Grafana instance, go to Administration → Plugins and data → Plugins.
  2. Search for “Microsoft Teams Observability”.
  3. Click Install.
  4. After installation, the app appears in the sidebar under Apps → Microsoft Teams Observability.
Section titled “Plugin Catalog Link”

Use the official plugin listing: phenisys-msteamsobservability-app.

Configure the Datasources

Section titled “Configure the Datasources”

After installation, two datasources are registered:

MS Teams Observability Datasource

Section titled “MS Teams Observability Datasource”

This is the primary datasource. It connects to your Loki instance to query MS Teams logs.

FieldDescription
Loki URLThe base URL of your Loki instance (e.g., https://logs-prod-xxx.grafana.net)
Tenant IDGrafana Cloud tenant ID (required for Grafana Cloud Loki)
AuthenticationBasic auth credentials or API token
Service NameThe OTel service_name used by the collector (default: msteams-callrecords)
TimeoutQuery timeout in seconds
  1. Go to Connections → Data Sources → MS Teams Observability Datasource.
  2. Fill in the connection details from the table above.
  3. Click Save & test.

Subnet Location Datasource (Optional)

Section titled “Subnet Location Datasource (Optional)”

This datasource powers the GeoIP enrichment on the Call Map. It maps IP addresses to geographic locations using ip-api.com.

  1. Go to Connections → Data Sources → Subnet Location Datasource.
  2. Enable the datasource if you want GeoIP features on the Call Overview map.
  3. The datasource uses the public ip-api.com service (free tier, no API key required).

Verify Installation

Section titled “Verify Installation”
  1. Open Apps → Microsoft Teams Observability in the sidebar.
  2. The Home page should load with your Loki data (or show demo data if no collector is configured).
  3. Check that calls appear on the Calls page.
  4. If using GeoIP: verify the Call Overview map shows participant locations.