Partager via

Schéma du journal des séries chronologiques des statistiques des médias client d’appels

  • Article

Le journal appeler des statistiques de média client fournit des informations côté client sur les flux multimédias entre les participants individuels impliqués dans un appel. Ces journaux sont actuellement en préversion limitée et fournissent des données de série chronologique détaillées sur les flux multimédias audio, vidéo et de partage d’écran entre les participants avec un intervalle d’agrégation par défaut de 10 secondes. Les journaux contiennent des informations de série chronologique granulaires sur le type de flux multimédia, la direction, le codec ainsi que les propriétés à débit binaire (par exemple, max, min, moyenne).

Ce journal fournit des informations plus détaillées que le journal de diagnostic des appels pour comprendre la qualité des flux multimédias entre les participants. Il peut être utilisé pour visualiser et examiner les problèmes de qualité pour vos appels via les diagnostics d’appel pour votre ressource Azure Communication Services. En savoir plus sur les diagnostics d’appel

Comment utiliser les journaux d’appels

Nous vous recommandons de collecter tous les journaux d’appels disponibles dans une ressource Log Analytics afin de pouvoir surveiller votre utilisation des appels et d’améliorer la qualité des appels, et pour pouvoir recevoir de nouveaux journaux d’Azure Communication Services dès qu’ils sont publiés.

Vous pouvez utiliser deux outils principaux pour surveiller vos appels et améliorer leur qualité.

Nous vous recommandons d’utiliser les tableaux de bord Tableau de bord des insights vocaux et vidéo pour démarrer des investigations de qualité et d’utiliser les diagnostics d’appels si nécessaire pour explorer des appels individuels quand vous avez besoin de détails précis.

Concepts de données

Important

Vous devez collecter les journaux si vous souhaitez les analyser. Pour plus d’informations, consultez Comment stocker les journaux ?

Azure ne stocke pas les données de vos journaux d’appels, sauf si vous activez ces paramètres de diagnostic spécifiques. Vos données d’appels ne sont pas disponibles rétroactivement. Vous accumulez des données une fois les paramètres de diagnostic créés.

Définitions des données

Schéma du journal des séries chronologiques des statistiques des médias client d’appels

Ce tableau décrit chaque propriété.

Propriété Description
OperationName Opération associée à l’enregistrement de journal.
CallId ID unique pour un appel. Il identifie les événements corrélés de tous les participants et points de terminaison qui se connectent pendant un appel, et vous pouvez l’utiliser pour joindre les données de différents journaux. Il est similaire au correlationId dans le journal de résumé des appels et le journal de diagnostic des appels.
CallClientTimeStamp Timestamp lorsque les statistiques multimédias sont enregistrées.
MetricName Nom des statistiques multimédias, par exemple Bitrate, JitterInMs, PacketsPerSecond, etc.
Count Le nombre de points de données échantillonnés à un timestamp donné.
Sum La somme des valeurs de métriques de tous les points de données échantillonnés.
Average La valeur métrique moyenne des points de données échantillonnés. Moyenne = Somme/Nombre.
Minimum Le minimum des valeurs de métriques de tous les points de données échantillonnés.
Maximum Le maximum des valeurs de métriques de tous les points de données échantillonnés.
MediaStreamDirection La direction du flux multimédia. Il peut s’agir de send ou de receive.
MediaStreamType Le type du flux multimédia. Il peut s’agir de video, audio ou screen.
MediaStreamCodec Codec utilisé pour encoder/décoder le flux multimédia, tel que H264, OPUS, VP8, etc.
ParticipantId ID unique généré pour représenter chaque point de terminaison dans l’appel.
ClientInstanceId ID unique représentant l’objet Client d’appel créé dans le Kit de développement logiciel (SDK) Calling.
EndpointId L’identifiant unique qui représente chaque point de terminaison connecté à l’appel. L’EndpointId peut persister pour le même utilisateur sur plusieurs appels (callIds) pour les clients natifs, mais est unique pour chaque appel lorsque le client est un navigateur web. L’EndpointId n’est actuellement pas instrumenté dans ce journal. Lorsqu’il est implémenté, il correspond aux valeurs dans les journaux CallSummary/Diagnostics.
RemoteParticipantId L’identifiant unique qui représente le point de terminaison distant dans le flux multimédia. Par exemple, un utilisateur peut afficher plusieurs flux vidéo pour les autres utilisateurs dans le même appel. Chaque flux vidéo a un autre RemoteParticipantId.
RemoteEndpointId Identique à EndpointId, mais représente l’utilisateur du côté distant du flux.
MediaStreamId L’identifiant unique qui représente chaque flux multimédia dans l’appel. L’MediaStreamId n’est pas instrumenté dans les clients pour le moment. Lorsqu’il est implémenté, il correspond à la colonne streamId dans les journaux CallDiagnostics.
AggregationIntervalSeconds Intervalle de temps pour l’agrégation des statistiques multimédias. Actuellement dans le Kit de développement logiciel (SDK) Calling, les mesures multimédias sont échantillonnées toutes les secondes, et lorsque nous les rapportons dans le journal, nous agrégeons tous les échantillons toutes les 10 secondes. Ainsi, chaque ligne de ce tableau compte au maximum 10 points d’échantillonnage.

Exemples de données pour différents types d’appels

Journaux des statistiques des médias client d’appels pour les appels P2P et de groupe

Pour le journal des séries chronologiques des statistiques du client d’appels, il n’existe aucune différence entre les scénarios d’appels P2P et de groupe. Le nombre de journaux dépend des opérations du SDK et de la durée des appels. Le code suivant est un exemple générique montrant le schéma de ces journaux d’activité.

Appeler le journal des séries chronologiques des statistiques des médias client

Voici un exemple de journal des séries chronologiques de statistiques multimédias. Il montre la métrique de Gigue du participant pour recevoir un flux audio à un timestamp spécifique.

"properties": {
    "TenantId":                     "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":                "2024-01-10T07:36:51.771Z",
    "OperationName":                "CallClientMediaStatsTimeSeries" ,  
    "CallId":                       "92d800c4-abde-40be-91e9-3814ee786b19", 
    "CallClientTimeStamp":          "2024-01-09T15:07:56.066Z",
    "MetricName":                   "JitterInMs",
    "Count":                        "2",
    "Sum":                          "34",
    "Average":                      "17",
    "Minimum":                      "10",
    "Maximum":                      "25",
    "MediaStreamDirection":         "recv",
    "MediaStreamType":              "audio",
    "MediaStreamCodec":             "OPUS",
    "ParticipantId":                "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
     "ClientInstanceId":            "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "AggregationIntervalSeconds":   "10",
    "Type":                         "ACSCallClientMediaStatsTimeSeries"
}

Chaque participant peut avoir de nombreuses métriques de statistiques multimédias différentes pour un appel. Vous pouvez exécuter la requête suivante dans Log Analytics dans le Portail Azure pour afficher toutes les mesures possibles dans ce journal :

ACSCallClientMediaStatsTimeSeries | distinct MetricName

Forum aux questions

Comment stocker les journaux ?

La section suivante décrit cette exigence.

Les journaux Azure Communication Services ne sont pas stockés dans votre compte Azure par défaut. Vous devez donc commencer à les stocker pour que les outils comme le Tableau de bord des insights vocaux et vidéo et les diagnostics d’appels fonctionnent. Pour collecter les journaux des appels, vous devez activer un paramètre de diagnostic qui dirige les données d’appel vers un espace de travail Log Analytics.

Les données ne sont pas stockées rétroactivement, par conséquent vous commencez à capturer les journaux des appels uniquement après avoir configuré le paramètre de diagnostic.

Pour ajouter des paramètres de diagnostic à votre ressource, suivez les instructions de Activer les journaux via des paramètres de diagnostic dans Azure Monitor. Nous vous recommandons de collecter tous les journaux initialement. Une fois que vous avez compris les fonctionnalités d’Azure Monitor, déterminez les journaux que vous voulez conserver et pendant combien de temps. Quand vous ajoutez votre paramètre de diagnostic, vous êtes invité à sélectionner des journaux. Pour collecter tous les journaux, sélectionnez allLogs.

Le volume de vos données, leur conservation et leur utilisation dans Log Analytics au sein d’Azure Monitor sont facturés via les compteurs de données Azure existants. Nous vous recommandons d’analyser vos stratégies d’utilisation et de conservation des données pour des considérations de coût si nécessaire. Pour plus d’informations, consultez Contrôler les coûts.

Si vous avez plusieurs ID de ressource Azure Communications Services, vous devez activer ces paramètres pour chaque ID de ressource.

Étapes suivantes