Skip to content
MS Teams Observability

License Estimation

Licensing is based on the maximum number of distinct users observed over the last 30 days. A 10% tolerance is recommended to absorb natural fluctuations.

Estimation Formula

Section titled “Estimation Formula”

Use this baseline formula:

required_license_users = ceil(max_distinct_users_30d * 1.10)

Example:

  • Maximum users seen in last 30 days: 2,500
  • With tolerance: ceil(2500 * 1.10) = 2,750
  • Choose the next available license tier at or above this value.

Get User Activity from Microsoft Graph

Section titled “Get User Activity from Microsoft Graph”

Use the Teams activity report endpoint:

  1. Request the pre-authenticated report URL:

    Terminal window
    curl "https://graph.microsoft.com/v1.0/reports/getTeamsUserActivityUserCounts(period='D180')" \
      -H "Authorization: Bearer ${access_token}"

    Expect an HTTP 302 response with a Location header.

  2. Download the report from the Location URL:

    Terminal window
    curl "https://reports.office.com/data/download/<report-id>" -o teams-user-activity.csv

  3. Calculate the maximum daily user count over your chosen window (at least 30 days).

Section titled “Recommended Sizing Workflow”
  1. Run the report on D180 to capture seasonal peaks.
  2. Compute max users for 30, 90, and 180-day windows.
  3. Use the highest relevant value for your contract period.
  4. Add 10% headroom.
  5. Re-check quarterly or after major organizational changes.