Prerequisites

Before deploying the collector, ensure you have the following in place.

Azure / Microsoft 365

• A Microsoft 365 tenant with Teams calling activity.
• An Azure account with rights to create app registrations in Microsoft Entra ID.
• Rights to grant admin consent for Microsoft Graph application permissions.

Minimum Graph permissions:

• CallRecords.Read.All
• Reports.Read.All
• ServiceHealth.Read.All

See Collector Azure Permissions for the canonical setup and full permission details.

Collector Host

• Linux (recommended) or Windows server.
• Outbound network access to:
  • graph.microsoft.com
  • login.microsoftonline.com
  • reportsncu.office.com (Microsoft Graph report download redirect)
  • Your backend endpoint (Dynatrace, Splunk, Grafana Cloud, Datadog, or another OTLP-compatible target)
• Sufficient CPU and memory for your call volume.

Tip

The collector does not need to run on ActiveGate or Dynatrace components. Any host with the required network access and resources is suitable.

Note

For national cloud deployments (GCC High, DoD, China), Microsoft Entra ID and Graph endpoints differ from global defaults. Set cloud_deployment in your configuration. See Collector Configuration.

Backend Access

Choose one or more output targets.

Dynatrace

This connector requires Dynatrace SaaS with Grail enabled. Full prerequisites: Dynatrace Prerequisites.

Splunk

• Splunk instance (Search Head) with admin access.
• Ability to create HTTP Event Collector (HEC) inputs and indexes.

OTLP-compatible platforms (Grafana, Datadog, etc.)

• A reachable OTLP logs endpoint.
• Platform credentials configured as OTLP headers.
• Typical endpoints:
  • https://otlp-gateway.grafana.net/otlp/v1/logs
  • https://otlp.datadoghq.com/v1/logs

See OTLP Collector Connection for endpoint and header examples.

License

A valid MS Teams Observability license is required to activate Live mode. For license request and format details, see License.