Skip to content

Metrics Dictionary Guide

This page is the canonical field reference for all event families exported by the collector. Use it to build queries, design dashboards, and troubleshoot data issues.

Log sourcePurposeTypical use
MSTeams_CallRecords_CallMetadataCall-level summaryCall volume, type, and overall health
MSTeams_CallRecords_StreamDetailsStream-level qualityTroubleshoot jitter, RTT, packet loss
MSTeams_CallRecords_PSTNPSTN activityTelephony usage and call details
MSTeams_CallRecords_DirectRoutingDirect Routing activitySIP/routing troubleshooting
MSTeams_CallRecords_AutoAttendantAuto attendant usageVoice workflow visibility
MSTeams_CallRecords_CallQueueCall queue usageQueue behavior monitoring
MSTeams_ServiceAnnouncementMicrosoft incidentsCorrelate degradations with official incidents
MSTeams_RemoteCollectionHealthRemote collection status (extension)Verify extension-based agent health
MSTeams_CollectionHealthCollector statusVerify ingestion health
FieldTypeExampleMeaningUsed in dashboards
call.idstring550e8400-e29b-41d4-a716-446655440000Unique call identifierCalls, Call Overview
typestringcallCall type enumOverview, Calls
callHealthstringpoorHigh-level call quality status (good/poor/bad)Overview, Calls
startDateTimedatetime2026-05-22T14:30:00ZCall start timeAll dashboards
timestampdatetime2026-05-22T14:35:00ZRecord ingestion timestampAll dashboards
callerobject{ "upn": "...", "displayName": "..." }Caller identityUsers
calleeobject{ "upn": "...", "displayName": "..." }Callee identityUsers
durationSecondsnumber320Call duration in secondsCall Overview, Overview
mediaPathsarray["audio", "video"]Media modalities usedCalls
FieldTypeExampleMeaningUsed in dashboards
call.idstring550e8400-...Parent call identifierCall Overview
mediaLabelstringmain-audioStream media labelCall Overview
streamDirectionstringcallerToCalleeDirectional flow (callerToCallee/calleeToCaller)Stream analysis
streamHealthstringgoodStream-level qualityStream analysis
averageRoundTripTimeMsnumber45.2Average RTT in millisecondsQuality widgets
averageJitterMsnumber12.5Average jitter in millisecondsQuality widgets
averagePacketLossRatePercentnumber1.8Average packet loss percentageQuality widgets
averageVideoFrameLossPercentagenumber0.5Video frame loss percentageVideo quality
averageVideoFrameRatenumber29.97Video frame rate in fpsVideo quality
startDateTimedatetime2026-05-22T14:30:00ZStream start timeCall Overview
FieldTypeExampleMeaningUsed in dashboards
call.idstring...Unique call identifierCalls
callerNumberstring+1-555-0123Calling party phone numberPSTN
calleeNumberstring+1-555-0456Called party phone numberPSTN
callDurationSecondsnumber180PSTN call durationPSTN
startDateTimedatetime...PSTN call start timePSTN
FieldTypeExampleMeaningUsed in dashboards
call.idstring...Unique call identifierDirect Routing
sipResponseCodenumber200SIP response codeDirect Routing
startDateTimedatetime...SIP call start timeDirect Routing
FieldTypeExampleMeaningUsed in dashboards
call.idstring...Unique call identifierAuto Attendant
startDateTimedatetime...Call start timeAuto Attendant
FieldTypeExampleMeaningUsed in dashboards
call.idstring...Unique call identifierCall Queue
startDateTimedatetime...Call start timeCall Queue
FieldTypeExampleMeaningUsed in dashboards
titlestringTeams - Call quality degradedIncident titleIssues
statusstringserviceDegradationIncident status enumIssues
startDateTimedatetime...Incident start timeIssues
lastUpdateddatetime...Last update timestampIssues
FieldTypeExampleMeaningUsed in dashboards
collectionCycleIdstring...Unique cycle identifierCollector health
cycleStartTimedatetime...Collection cycle startCollector health
cycleEndTimedatetime...Collection cycle endCollector health
recordCountnumber1500Number of records collectedCollector health
exportSuccessbooleantrueExport status summaryCollector health

These dimensions are used across dashboards for filtering and grouping:

DimensionDescriptionApplies to
call.idUnique call identifierAll call-related dashboards
typeCall type (call, pstn, directRouting, etc.)Overview, Calls
callHealthOverall call quality (good/poor/bad)Overview, Calls, Call Overview
startDateTimeEvent start time (used for time-based queries)All dashboards
timestampRecord ingestion timestampAll dashboards
mediaLabelStream identifier (main-audio, main-video, etc.)Call Overview, Stream analysis
streamDirectionDirectional flow (callerToCallee/calleeToCaller)Stream analysis
streamHealthStream quality levelStream analysis
MetricSource familyDescription
averageRoundTripTimeMsStreamDetailsNetwork latency between endpoints
averageJitterMsStreamDetailsJitter (delay variation) in milliseconds
averagePacketLossRatePercentStreamDetailsPercentage of lost packets
averageVideoFrameLossPercentageStreamDetailsVideo frame loss rate
averageVideoFrameRateStreamDetailsVideo frames per second

If dashboard quality drops while MSTeams_ServiceAnnouncement shows an active incident, investigate Microsoft-side impact before changing local configuration.