Share via

Logboeken voor spraakgesprekken en videogesprekken in Azure Communication Services

  • Artikel

Azure Communication Services biedt mogelijkheden voor logboekregistratie die u kunt gebruiken om uw Communication Services-oplossing te bewaken en fouten op te sporen. U configureert deze mogelijkheden via Azure Portal.

De inhoud in dit artikel verwijst naar logboeken die zijn ingeschakeld via Azure Monitor (zie ook veelgestelde vragen). Zie Logboekregistratie in diagnostische instellingen inschakelen om deze logboeken in te schakelen voor Communication Services.

Gegevensconcepten

De volgende algemene beschrijvingen van gegevensconcepten zijn specifiek voor spraakgesprekken en videogesprekken. Deze concepten zijn belangrijk om te controleren, zodat u inzicht krijgt in de betekenis van de gegevens die in de logboeken zijn vastgelegd.

Entiteiten en id's

Raak vertrouwd met de volgende termen:

  • Aanroep: Zoals vertegenwoordigd in de gegevens, is een aanroep een abstractie die wordt weergegeven door correlationId. Waarden voor correlationId elke aanroep zijn uniek en ze zijn tijdgebonden door callStartTime en callDuration.

  • Deelnemer: Deze entiteit vertegenwoordigt de verbinding tussen een eindpunt en de server. Een deelnemer (participantId) is alleen aanwezig wanneer de oproep een groepsgesprek is.

  • Eindpunt: dit is de meest unieke entiteit, vertegenwoordigd door endpointId. Elke aanroep is een gebeurtenis die gegevens van twee of meer eindpunten bevat. Eindpunten vertegenwoordigen de deelnemers in het gesprek.

    EndpointType geeft aan of het eindpunt een menselijke gebruiker (PSTN of VoIP), een bot of de server is die meerdere deelnemers binnen een gesprek beheert. Wanneer een endpointType waarde is "Server", krijgt het eindpunt geen unieke id toegewezen. U kunt analyseren endpointType en het aantal endpointId waarden om te bepalen hoeveel gebruikers en andere niet-menselijke deelnemers (bots en servers) deelnemen aan een gesprek.

    Systeemeigen SDK's voor Android en iOS gebruiken dezelfde endpointId waarde voor een gebruiker in meerdere aanroepen, zodat u inzicht krijgt in ervaringen in verschillende sessies. Dit proces verschilt van eindpunten op het web, die altijd een nieuwe endpointId waarde genereren voor elke nieuwe aanroep.

  • Stream: Dit is de meest gedetailleerde entiteit. Er is één stroom voor elke richting (inkomend of uitgaand) en mediaType waarde (bijvoorbeeldAudio).Video

Gegevensdefinities

Schema voor gebruikslogboek

Eigenschappen Beschrijving
Timestamp Het tijdstempel (UTC) van het moment waarop het logboek is gegenereerd.
Operation Name De bewerking die is gekoppeld aan de logboekrecord.
Operation Version De api-version waarde die is gekoppeld aan de bewerking, als de Operation Name bewerking is uitgevoerd via een API. Als er geen API overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van de bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
Category De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een resource kunt in- of uitschakelen. De eigenschappen die in de properties blob van een gebeurtenis worden weergegeven, zijn hetzelfde binnen een logboekcategorie en resourcetype.
Correlation ID De id voor gecorreleerde gebeurtenissen. U kunt deze gebruiken om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren.
Properties Andere gegevens die van toepassing zijn op verschillende modi van Communication Services.
Record ID De unieke id voor een gebruiksrecord.
Usage Type De gebruiksmodus (bijvoorbeeld Chat, PSTN of NAT).
Unit Type Het type eenheid waarop het gebruik is gebaseerd voor een gebruiksmodus (bijvoorbeeld minuten, megabytes of berichten).
Quantity Het aantal eenheden dat is gebruikt of verbruikt voor deze record.

Schema voor aanroepsamenvattingslogboek

Het logboek van het gespreksoverzicht bevat gegevens om u te helpen de belangrijkste eigenschappen van alle aanroepen te identificeren. Er wordt een ander oproepoverzichtslogboek gemaakt voor elke participantId waarde (endpointId in het geval van peer-to-peer-aanroepen [P2P]) in de aanroep.

Belangrijk

De gegevens van deelnemers in het overzichtslogboek van de oproep variëren op basis van de tenant van de deelnemer. De SDK-versie en de versie van het besturingssysteem worden redacted als de deelnemer zich niet binnen dezelfde tenant (ook wel cross-tenant genoemd) bevindt als de Communication Services-resource. Deelnemers aan meerdere tenants worden geclassificeerd als externe gebruikers die zijn uitgenodigd door een resourcetenant om deel te nemen aan en samen te werken tijdens een gesprek.

Eigenschappen Beschrijving
time Het tijdstempel (UTC) van het moment waarop het logboek is gegenereerd.
operationName De bewerking die is gekoppeld aan de logboekrecord.
operationVersion De api-version waarde die is gekoppeld aan de bewerking, als de operationName bewerking is uitgevoerd via een API. Als er geen API overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van de bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
category De logboekcategorie van de gebeurtenis. Deze eigenschap is de granulariteit waarmee u logboeken voor een resource kunt in- of uitschakelen. De eigenschappen die in de properties blob van een gebeurtenis worden weergegeven, zijn hetzelfde binnen een logboekcategorie en resourcetype.
correlationId De unieke id voor een oproep. Het identificeert gecorreleerde gebeurtenissen van alle deelnemers en eindpunten die verbinding maken tijdens één gesprek en u kunt deze gebruiken om gegevens uit verschillende logboeken samen te voegen. Als u ooit een ondersteuningsaanvraag met Microsoft moet openen, kunt u de correlationId waarde gebruiken om eenvoudig de oproep te identificeren die u wilt oplossen.
identifier De unieke id voor de gebruiker. De identiteit kan een Azure Communication Services-gebruiker, een Microsoft Entra-gebruikers-id, een anonieme gebruikers-id van Teams of een Teams-bot-id zijn. U kunt deze id gebruiken om gebruikers gebeurtenissen in logboeken te correleren.
callStartTime Een tijdstempel voor het begin van de aanroep, op basis van de eerste poging tot verbinding vanaf een eindpunt.
callDuration De duur van het gesprek, uitgedrukt in seconden. Deze is gebaseerd op de eerste poging tot verbinding en het einde van de laatste verbinding tussen twee eindpunten.
callType Het type gesprek. Het bevat een "P2P" of "Group". Een "P2P" aanroep is een directe 1:1-verbinding tussen slechts twee, niet-servereindpunten. Een "Group" aanroep is een aanroep met meer dan twee eindpunten of wordt gemaakt als "Group" aanroep vóór de verbinding.
teamsThreadId De thread-id van Teams. Deze id is alleen relevant wanneer de oproep is georganiseerd als een Teams-vergadering. Het vertegenwoordigt vervolgens het gebruiksscenario van interoperabiliteit tussen Microsoft Teams en Azure Communication Services.

Deze id wordt weergegeven in operationele logboeken. U kunt deze id ook ophalen via de Chat-API's.
participantId De id die wordt gegenereerd om de tweerichtingsverbinding tussen een "Participant" eindpunt (endpointType = "Server") en de server weer te geven. Wanneer callType = "P2P"er een directe verbinding tussen twee eindpunten is en er geen participantId waarde wordt gegenereerd.
participantStartTime Het tijdstempel voor het begin van de eerste verbindingspoging van de deelnemer.
participantDuration De duur van elke deelnemerverbinding in seconden, van participantStartTime tot het tijdstempel waarop de verbinding is beëindigd.
participantEndReason De reden voor het einde van een deelnemerverbinding. Het bevat aanroepende SDK-foutcodes die de SDK verzendt (indien relevant) voor elke participantId waarde.
endpointId De unieke id die elk eindpunt vertegenwoordigt dat is verbonden met de aanroep, waarbij endpointType het eindpunttype wordt gedefinieerd. Wanneer de waarde isnull, is de verbonden entiteit de Communication Services-server ( = endpointType"Server").

De endpointId waarde kan soms behouden blijven voor dezelfde gebruiker voor meerdere aanroepen (correlationId) voor systeemeigen clients. Het aantal endpointId waarden bepaalt het aantal aanroepoverzichtslogboeken. Er wordt een afzonderlijk samenvattingslogboek gemaakt voor elke endpointId waarde.
endpointType Deze waarde beschrijft de eigenschappen van elk eindpunt dat is verbonden met de aanroep. Het kan bevatten"Server", "VOIP", "PSTN", of "BOT""Unknown".
sdkVersion De versietekenreeks voor de COMMUNICATION Services Calling SDK-versie die elk relevant eindpunt gebruikt (bijvoorbeeld "1.1.00.20212500").
osVersion Een tekenreeks die het besturingssysteem en de versie van elk eindpuntapparaat vertegenwoordigt.
participantTenantId De id van de Microsoft-tenant die is gekoppeld aan de identiteit van de deelnemer. De tenant kan de Azure-tenant zijn die eigenaar is van de Azure Communication Services-resource of de Microsoft-tenant van een M365-identiteit. Dit veld wordt gebruikt om redaction tussen tenants te begeleiden.
participantType Beschrijving van de deelnemer als combinatie van de client (Azure Communication Services of Teams) en de identiteit ervan (Azure Communication Services of Microsoft 365). Mogelijke waarden zijn: Azure Communication Services (Azure Communication Services identity and Azure Communication Services SDK), Teams (Teams identity and Teams client), Azure Communication Services as Teams external user (Azure Communication Services identity and Azure Communication Services SDK in Teams call or meeting), Azure Communication Services as Microsoft 365 user (M365 identity and Azure Communication Services client), en Teams Voice Apps.
pstnPartcipantCallType Het vertegenwoordigt het type en de richting van PSTN-deelnemers, waaronder noodoproepen, directe routering, overdracht, doorsturen, enzovoort.

Schema voor diagnostisch logboek aanroepen

Diagnostische logboeken aanroepen bieden belangrijke informatie over de eindpunten en de mediaoverdrachten voor elke deelnemer. Ze bieden ook metingen waarmee u inzicht krijgt in kwaliteitsproblemen.

Voor elk eindpunt binnen een oproep wordt een afzonderlijk diagnostisch logboek voor gesprekken gemaakt voor uitgaande mediastreams (bijvoorbeeld audio of video) tussen eindpunten. In een P2P-aanroep bevat elk logboek gegevens die betrekking hebben op elk van de uitgaande streams die aan elk eindpunt zijn gekoppeld. In groepsaanroepen participantId fungeert als een sleutel-id om de gerelateerde uitgaande logboeken toe te voegen aan een afzonderlijke deelnemerverbinding. Diagnostische logboeken aanroepen blijven intact en zijn hetzelfde, ongeacht de tenant van de deelnemer.

Notitie

In dit artikel bevinden P2P- en groepsoproepen zich standaard binnen dezelfde tenant voor alle oproepscenario's die meerdere tenants zijn. Ze worden dienovereenkomstig opgegeven in het hele artikel.

Eigenschappen Beschrijving
operationName De bewerking die is gekoppeld aan de logboekrecord.
operationVersion De api-version waarde die is gekoppeld aan de bewerking, als de operationName bewerking is uitgevoerd via een API. Als er geen API overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van de bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
category De logboekcategorie van de gebeurtenis. Deze eigenschap is de granulariteit waarmee u logboeken voor een resource kunt in- of uitschakelen. De eigenschappen die in de properties blob van een gebeurtenis worden weergegeven, zijn hetzelfde binnen een logboekcategorie en resourcetype.
correlationId De unieke id voor een oproep. Het identificeert gecorreleerde gebeurtenissen van alle deelnemers en eindpunten die verbinding maken tijdens één gesprek. Als u ooit een ondersteuningsaanvraag met Microsoft moet openen, kunt u de correlationId waarde gebruiken om eenvoudig de oproep te identificeren die u wilt oplossen.
participantId De id die wordt gegenereerd om de tweerichtingsverbinding tussen een "Participant" eindpunt (endpointType = "Server") en de server weer te geven. Wanneer callType = "P2P"er een directe verbinding tussen twee eindpunten is en er geen participantId waarde wordt gegenereerd.
identifier De unieke id voor de gebruiker. De identiteit kan een Azure Communication Services-gebruiker, een Microsoft Entra-gebruikers-id, een Teams-object-id of een Teams-bot-id zijn. U kunt deze id gebruiken om gebruikers gebeurtenissen in logboeken te correleren.
endpointId De unieke id die elk eindpunt vertegenwoordigt dat is verbonden met de aanroep, waarbij endpointType het eindpunttype wordt gedefinieerd. Wanneer de waarde is null, is de verbonden entiteit de Communication Services-server. EndpointId kan blijven bestaan voor dezelfde gebruiker in meerdere aanroepen (correlationId) voor systeemeigen clients, maar is uniek voor elke aanroep wanneer de client een webbrowser is.
endpointType De waarde die de eigenschappen van elk endpointId exemplaar beschrijft. Het kan bevatten"Server", "VOIP", , "PSTN", "BOT", "Voicemail"of "Anonymous""Unknown".
mediaType De tekenreekswaarde die het type media beschrijft dat wordt verzonden tussen eindpunten binnen elke stream. Mogelijke waarden zijn "Audio", , "Video"( "VBSS" videogebasd scherm delen) en "AppSharing".
streamId Een niet-uniek geheel getal waarmee mediaTypeu stromen van dezelfde participantId waarde uniek kunt identificeren.
transportType De tekenreekswaarde die het netwerktransportprotocol voor elke participantId waarde beschrijft. Het kan bevatten "UDP", "TCP"of "Unrecognized". "Unrecognized" geeft aan dat het systeem niet kon bepalen of het transporttype TCP of UDP was.
roundTripTimeAvg De gemiddelde tijd die nodig is om binnen een periode een IP-pakket van het ene eindpunt naar het participantDuration andere op te halen. Deze netwerkdoorgiftevertraging is gerelateerd aan de fysieke afstand tussen de twee punten, de snelheid van het licht en eventuele overhead die de verschillende routers tussendoor innemen.

De latentie wordt gemeten als eenrichtingstijd of retourtijd (RTT). De waarde uitgedrukt in milliseconden. Een RTT groter dan 500 ms heeft een negatieve invloed op de gesprekskwaliteit.
roundTripTimeMax De maximale RTT (in milliseconden) gemeten voor het bereiken van mediastream tijdens een periode in een participantDuration groepsgesprek of tijdens een callDuration periode in een P2P-aanroep.
jitterAvg De gemiddelde wijziging in vertraging tussen opeenvolgende pakketten. Azure Communication Services kan zich aanpassen aan bepaalde niveaus van jitter via buffering. Wanneer de jitter de buffering overschrijdt, wat ongeveer langer jitterAvg is dan 30 ms, treedt er waarschijnlijk een negatieve invloed op de kwaliteit op. De pakketten die op verschillende snelheden binnenkomen, zorgen ervoor dat de stem van een spreker robot klinkt.

Deze metrische waarde wordt gemeten voor elke mediastroom gedurende de participantDuration periode in een groepsgesprek of gedurende de callDuration periode in een P2P-aanroep.
jitterMax De maximale jitter-waarde gemeten tussen pakketten voor elke mediastroom. Bursts in netwerkomstandigheden kunnen problemen veroorzaken in de verkeersstroom voor audio/video.
packetLossRateAvg Het gemiddelde percentage pakketten dat verloren gaat. Pakketverlies is rechtstreeks van invloed op de audiokwaliteit. Kleine, individuele verloren pakketten hebben bijna geen impact, terwijl back-to-back burst-verliezen audio volledig uitknippen. De pakketten die worden verwijderd en niet op hun beoogde bestemming aankomen, veroorzaken hiaten in de media. Deze situatie resulteert in gemiste lettergrepen en woorden, samen met hakkende video en delen.

Een pakketverlies van meer dan 10% (0,1) heeft waarschijnlijk een negatieve invloed op de kwaliteit. Deze metrische waarde wordt gemeten voor elke mediastroom gedurende de participantDuration periode in een groepsgesprek of gedurende de callDuration periode in een P2P-aanroep.
packetLossRateMax Deze waarde vertegenwoordigt de maximale percentage pakketverlies (percentage) voor elke mediastroom gedurende de participantDuration periode in een groepsgesprek of gedurende de callDuration periode in een P2P-aanroep. Bursts in netwerkomstandigheden kunnen problemen veroorzaken in de verkeersstroom voor audio/video.
JitterBufferSizeAvg De gemiddelde grootte van jitterbuffer gedurende de duur van elke mediastream. Een jitter-buffer is een gedeeld gegevensgebied waar spraakpakketten kunnen worden verzameld, opgeslagen en naar de spraakprocessor kunnen worden verzonden met gelijkmatig verdeelde intervallen. Jitter-buffer wordt gebruikt om de effecten van jitter tegen te gaan.

Jitter-buffers kunnen statisch of dynamisch zijn. Statische jitterbuffers worden ingesteld op een vaste grootte, terwijl dynamische jitterbuffers hun grootte kunnen aanpassen op basis van netwerkomstandigheden. Het doel van de jitterbuffer is om de gebruiker een soepele en ononderbroken stroom van audio- en videogegevens te bieden.

In de web-SDK is deze 'JitterBufferSizeAvg' de gemiddelde waarde van de 'jitterBufferDelay' tijdens de aanroep, is de 'jitterBufferDelay' de duur van een audiovoorbeeld of een videoframe dat in de jitterbuffer blijft.

Normaal gesproken veroorzaakt 'JitterBufferSizeAvg' waarde groter dan 200 ms, een negatieve invloed op de kwaliteit.
JitterBufferSizeMax De maximale jitterbuffergrootte gemeten tijdens de duur van elke mediastream.

Normaal gesproken wanneer deze waarde groter is dan 200 ms, heeft dit een negatieve invloed op de kwaliteit.
HealedDataRatioAvg Het gemiddelde percentage verloren of beschadigde gegevenspakketten dat is gereconstrueerd of hersteld door de genezer gedurende de duur van de audiostream. Herstelde gegevensverhouding is een meting van de effectiviteit van foutcorrectietechnieken die worden gebruikt in VoIP-systemen.

Wanneer deze waarde groter is dan 0,1 (10%), beschouwen we de stream als slechte kwaliteit.
HealedDataRatioMax De maximale herstelde gegevensverhouding gemeten tijdens de duur van elke mediastream.

Wanneer deze waarde groter is dan 0,1 (10%), beschouwen we de stream als slechte kwaliteit.
VideoFrameRateAvg Het gemiddelde aantal videoframes dat per seconde wordt verzonden tijdens een video-/screenharing-oproep. De videoframesnelheid kan van invloed zijn op de kwaliteit en gladheid van de videostream, met hogere framesnelheden in het algemeen tot vloeiendere en meer vloeiende bewegingen. De standaardframesnelheid voor WebRTC-video is doorgaans 30 frames per seconde (fps), hoewel dit kan variëren, afhankelijk van de specifieke implementatie- en netwerkvoorwaarden.

De kwaliteit van de stream wordt als slecht beschouwd wanneer deze waarde kleiner is dan 7 voor de videostream of minder dan 1 voor schermen.
RecvResolutionHeight Het gemiddelde van de verticale grootte van de binnenkomende videostream die wordt verzonden tijdens een video-/schermgesprek. Het wordt gemeten in pixels en is een van de factoren die de algehele resolutie en kwaliteit van de videostream bepalen. De gebruikte specifieke oplossing kan afhankelijk zijn van de mogelijkheden van de apparaten en netwerkvoorwaarden die betrokken zijn bij de aanroep.

De kwaliteit van de stream wordt als slecht beschouwd wanneer deze waarde kleiner is dan 240 voor videostream of minder dan 768 voor screenharingstreams.
RecvFreezeDurationPerMinuteInMs De gemiddelde duur van blokkeren in milliseconden per minuut voor binnenkomende video-/schermenstroom. Blokkeren wordt meestal veroorzaakt door een slechte netwerkconditie en kan de kwaliteit van de stream verminderen.

De streamkwaliteit wordt als slecht beschouwd wanneer deze waarde groter is dan 6.000 ms voor videostream, of groter dan 25.000 ms voor screenharing stream.

Logboekschema voor clientbewerkingen aanroepen

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Het logboek voor oproepclientbewerkingen biedt informatie aan de clientzijde over de aanroepende eindpunten en deelnemers die betrokken zijn bij een gesprek. Deze logboeken zijn momenteel in preview en tonen clientgebeurtenissen die zijn opgetreden in een oproep en welke acties een klant mogelijk heeft uitgevoerd tijdens een oproep.

Dit logboek bevat gedetailleerde informatie over acties die worden uitgevoerd tijdens een oproep en kan worden gebruikt om oproepproblemen te visualiseren en te onderzoeken met behulp van diagnostische gegevens over oproepen voor uw Azure Communication Services-resource. Meer informatie over diagnostische oproepen

Eigenschappen Beschrijving
CallClientTimeStamp De tijdstempel voor wanneer de bewerking is uitgevoerd op de SDK in UTC.
OperationName De naam van de bewerking die is geactiveerd voor de aanroepende SDK.
CallId De unieke id voor een oproep. Het identificeert gecorreleerde gebeurtenissen van alle deelnemers en eindpunten die verbinding maken tijdens één gesprek en u kunt deze gebruiken om gegevens uit verschillende logboeken samen te voegen. Het is vergelijkbaar met de correlationId in het logboek van het gespreksoverzicht en het diagnostische logboek voor aanroepen.
ParticipantId De unieke id voor elk oproepbeen (in groepsgesprekken) of gespreksdeelnemer (in peer-to-peer-oproepen). Deze id is het belangrijkste correlatiepunt tussen de logboeken CallSummary, CallDiagnostic, CallClientOperations en CallClientMediaStats.
OperationType Clientbewerking aanroepen.
OperationId Een unieke GGUID die een SDK-bewerking identificeert.
DurationMs De tijd die nodig is voor een aanroepende SDK-bewerking mislukt of geslaagd.
ResultType Veld met een beschrijving van het slagen of mislukken van een bewerking.
ResultSignature HTTP zoals fout- of succescode (200, 500).
SdkVersion De versie van de aanroepende SDK die wordt gebruikt.
UserAgent De standaardtekenreeks van de gebruikersagent op basis van de browser of de SDK voor het aanroepen van platformen wordt gebruikt.
ClientInstanceId Een unieke GGUID die het CallClient-object identificeert.
EndpointId De unieke id die elk eindpunt vertegenwoordigt dat is verbonden met de aanroep, waarbij endpointType het eindpunttype definieert. Wanneer de waarde null is, is de verbonden entiteit de Communication Services-server (endpointType = "Server").

De endpointId-waarde kan soms behouden blijven voor dezelfde gebruiker in meerdere aanroepen (correlationId) voor systeemeigen clients. Het aantal endpointId-waarden bepaalt het aantal aanroepoverzichtslogboeken. Er wordt een afzonderlijk samenvattingslogboek gemaakt voor elke endpointId-waarde.
OperationPayload Een dynamische nettolading die varieert op basis van de bewerking die specifiekere bewerkingsgegevens biedt.

Tijdreekslogboekschema voor clientmediastatistieken aanroepen

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Het tijdreekslogboek voor aanroepclientmedia biedt informatie over de mediastromen aan de clientzijde tussen afzonderlijke deelnemers die betrokken zijn bij een gesprek. Deze logboeken zijn momenteel in beperkte preview en bieden gedetailleerde tijdreeksgegevens op de media voor audio, video en screenshare tussen deelnemers met een standaard aggregatie-interval van 10 seconden. De logboeken bevatten gedetailleerde tijdreeksinformatie over mediastroomtype, richting, codec en bitrate-eigenschappen (bijvoorbeeld max, min, gemiddelde).

Dit logboek biedt meer gedetailleerde informatie dan het logboek voor gespreksdiagnose om inzicht te hebben in de kwaliteit van mediastooms tussen deelnemers. Het kan worden gebruikt om kwaliteitsproblemen voor uw aanroepen te visualiseren en te onderzoeken via Gespreksdiagnose voor uw Azure Communication Services-resource. Meer informatie over diagnostische oproepen

Eigenschappen Beschrijving
OperationName De bewerking die is gekoppeld aan de logboekrecord.
CallId De unieke id voor een oproep. Het identificeert gecorreleerde gebeurtenissen van alle deelnemers en eindpunten die verbinding maken tijdens één gesprek en u kunt deze gebruiken om gegevens uit verschillende logboeken samen te voegen. Het is vergelijkbaar met de correlationId in het logboek van het gespreksoverzicht en het diagnostische logboek voor aanroepen.
CallClientTimeStamp De tijdstempel wanneer de mediastatistieken worden vastgelegd.
MetricName De naam van de mediastatistieken, zoals Bitrate, JitterInMs, PacketsPerSecond, enzovoort.
Count Het aantal gegevenspunten dat is gesampleerd op een bepaald tijdstempel.
Sum De som van metrische waarden van alle gegevenspunten die zijn gesampleerd.
Average De gemiddelde metrische waarde van de voorbeeldgegevenspunten. Gemiddelde = Som / Aantal
Minimum Het minimum aan metrische waarden van alle gegevenspunten die zijn gesampleerd.
Maximum Het maximum aantal metrische waarden van alle gegevenspunten die zijn gesampleerd.
MediaStreamDirection De richting van de mediastroom. Het kan worden verzonden of ontvangen
MediaStreamType Het type mediastream. Het kan video, audio of scherm zijn.
MediaStreamCodec De codec die wordt gebruikt voor het coderen/decoderen van de mediastroom, zoals H264, OPUS, VP8, enzovoort.
ParticipantId De unieke id die wordt gegenereerd om elk eindpunt in de aanroep weer te geven.
ClientInstanceId De unieke id die het aanroepclientobject vertegenwoordigt dat is gemaakt in de aanroepende SDK.
EndpointId De unieke id die elk eindpunt vertegenwoordigt dat is verbonden met de aanroep. EndpointId kan blijven bestaan voor dezelfde gebruiker voor meerdere aanroepen (callIds) voor systeemeigen clients, maar is uniek voor elke aanroep wanneer de client een webbrowser is. Houd er rekening mee dat EndpointId momenteel niet is geïnstrueerd in dit logboek. Wanneer deze in de toekomst wordt geïmplementeerd, komen deze overeen met de waarden in CallSummary/Diagnostics-logboeken
RemoteParticipantId De unieke id die het externe eindpunt in de mediastroom vertegenwoordigt. Een gebruiker kan bijvoorbeeld meerdere videostreams weergeven voor de andere gebruikers in hetzelfde gesprek. Elke videostream heeft een andere RemoteParticipantId.
RemoteEndpointId Hetzelfde als EndpointId, maar vertegenwoordigt de gebruiker aan de externe kant van de stream.
MediaStreamId Een unieke id die elke mediastroom in het gesprek vertegenwoordigt. MediaStreamId is momenteel niet geïnstrueerd in clients. Wanneer deze wordt geïmplementeerd, komt deze overeen met de streamId-kolom in de CallDiagnostics-logboeken.
AggregationIntervalSeconds Het tijdsinterval voor het samenvoegen van de mediastatistieken. Momenteel in het aanroepen van SDK worden de metrische mediagegevens elke 1 seconde genomen en wanneer we in het logboek rapporteren, worden alle voorbeelden elke 10 seconden samengevoegd. Elke rij in deze tabel heeft dus maximaal 10 steekproeven.

P2P versus groepsgesprekken

Er zijn twee soorten aanroepen, zoals vertegenwoordigd door callType:

  • Peer-to-peeraanroep (P2P): een verbinding tussen slechts twee eindpunten, zonder servereindpunt. P2P-aanroepen worden gestart als een aanroep tussen deze eindpunten en worden niet gemaakt als groepsaanroep vóór de verbinding.

    Diagram met een P2P-aanroep tussen twee eindpunten.

  • Groepsoproep: elke oproep met meer dan twee eindpunten die zijn verbonden. Groepsaanroepen bevatten een servereindpunt en de verbinding tussen elk eindpunt en de server. P2P-aanroepen die een ander eindpunt toevoegen tijdens de aanroep, blijven P2P en worden een groepsoproep. U kunt de tijdlijn bepalen van wanneer elk eindpunt deel uitmaakt van de aanroep met behulp van de participantStartTime en participantDuration metrische gegevens.

    Diagram met een groepsoproep tussen meerdere eindpunten.

Logboekstructuur

Azure Communication Services maakt vier typen logboeken:

  • Oproepoverzichtslogboeken: bevat basisinformatie over de aanroep, inclusief alle relevante id's, tijdstempels, eindpunten en SDK-informatie. Voor elke deelnemer binnen een gesprek maakt Communication Services een afzonderlijk logboek voor het samenvatten van oproepen.

    Als iemand opnieuw deel gaat aan een gesprek, heeft die deelnemer dezelfde EndpointId waarde, maar een andere ParticipantId waarde. Dat eindpunt kan vervolgens twee logboeken met oproepsamenvatting bevatten.

  • Diagnostische logboeken aanroepen: bevat informatie over de stroom, samen met een set metrische gegevens die de kwaliteit van de ervaringsmetingen aangeven. Voor elk EndpointId gesprek (inclusief de server) maakt Azure Communication Services een afzonderlijk logboek voor gespreksdiagnose voor elke mediastream (bijvoorbeeld audio of video) tussen eindpunten.

  • Logboeken voor aanroepen van clientbewerkingen: bevatten gedetailleerde aanroepclient-gebeurtenissen. Deze logboeken worden gegenereerd voor elke EndpointId gebeurtenis in een oproep en het aantal gegenereerde gebeurtenislogboeken is afhankelijk van de bewerkingen die de deelnemer tijdens de oproep heeft uitgevoerd.

  • Logboeken met statistieken van clientmedia aanroepen: gedetailleerde mediastroomwaarden bevatten. Deze logboeken worden gegenereerd voor elke mediastream in een gesprek. Voor elk EndpointId gesprek (inclusief de server) maakt Azure Communication Services een afzonderlijk logboek voor elke mediastream (bijvoorbeeld audio of video) tussen eindpunten. Het volume aan gegevens dat in elk logboek wordt gegenereerd, is afhankelijk van de duur van het gesprek en het aantal media-stoom in het gesprek.

In een P2P-aanroep bevat elk logboek gegevens die betrekking hebben op elk van de uitgaande streams die aan elk eindpunt zijn gekoppeld. In een groepsoproep maakt elke stroom die is endpointType = "Server" gekoppeld aan een logboek dat gegevens voor de binnenkomende streams bevat. Alle andere streams maken logboeken die gegevens bevatten voor de uitgaande streams voor alle niet-servereindpunten. Gebruik in groepsaanroepen de participantId waarde als sleutel om de gerelateerde inkomende en uitgaande logboeken toe te voegen aan een afzonderlijke deelnemerverbinding.

Voorbeeld: P2P-aanroep

Het volgende diagram vertegenwoordigt twee eindpunten die rechtstreeks zijn verbonden in een P2P-aanroep. In dit voorbeeld maakt Communication Services twee logboeken voor het samenvatten van oproepen (één voor elke participantID waarde) en vier diagnostische logboeken voor oproepen (één voor elke mediastream).

Voor clientdeelnemers aanroepen van Azure Communication Services (ACS) zijn er ook een reeks logboeken voor oproepclientbewerkingen en tijdreekslogboeken voor clientmediastatistieken aanroepen. Het exacte aantal van deze logboeken is afhankelijk van het type SDK-bewerkingen en hoe lang de aanroep is.

Diagram met een P2P-aanroep binnen dezelfde tenant.

Voorbeeld: Groepsoproep

Het volgende diagram vertegenwoordigt een voorbeeld van een groepsoproep met drie participantId waarden (wat drie deelnemers betekent) en een servereindpunt. Meerdere waarden voor endpointId kunnen worden weergegeven in meerdere deelnemers, bijvoorbeeld wanneer ze opnieuw deelnemen aan een oproep vanaf hetzelfde apparaat. Communication Services maakt één aanroepsamenvattingslogboek voor elke participantId waarde. Er worden vier diagnostische logboeken voor aanroepen gemaakt: één voor elke mediastroom per participantId.

Voor azure Communication Services-aanroepclientdeelnemers zijn de logboeken voor oproepclientbewerkingen hetzelfde als P2P-aanroepen. Voor elke deelnemer die de aanroep-SDK gebruikt, ziet u een reeks logboeken voor aanroepclientbewerkingen.

Voor azure Communication Services-aanroepclientdeelnemers zijn de logboeken voor oproepclientbewerkingen en tijdreekslogboeken voor clientmedia aanroepen hetzelfde als P2P-aanroepen. Voor elke deelnemer die de aanroep-SDK gebruikt, worden er een reeks logboeken voor oproepclientbewerkingen en tijdreekslogboeken voor clientmedia-statistieken aangeroepen.

Diagram met een groepsoproep binnen dezelfde tenant.

Voorbeeld: P2P-aanroep tussen tenants

Het volgende diagram vertegenwoordigt twee deelnemers in meerdere tenants die rechtstreeks zijn verbonden in een P2P-aanroep. In dit voorbeeld maakt Communication Services één aanroepsamenvattingslogboek (één voor elke deelnemer) met redacted OS- en SDK-versies. Communication Services maakt ook vier diagnostische logboeken voor aanroepen (één voor elke mediastream). Elk logboek bevat gegevens die betrekking hebben op de uitgaande stroom van participantID.

Diagram met een P2P-aanroep voor meerdere tenants.

Voorbeeld: Groepsoproep tussen tenants

Het volgende diagram vertegenwoordigt een voorbeeld van een groepsoproep met drie participantId waarden voor meerdere tenants. Communication Services maakt één aanroepsamenvattingslogboek voor elke deelnemer met redacted OS- en SDK-versies. Communication Services maakt ook vier diagnostische logboeken voor aanroepen die betrekking hebben op elke participantId waarde (één voor elke mediastroom).

Diagram met een groepsoproep tussen tenants.

Notitie

Deze release ondersteunt alleen uitgaande diagnostische logboeken. Besturingssysteem- en SDK-versies die zijn gekoppeld aan de bot en de deelnemer kunnen worden bewerkt omdat Communication Services identiteiten van deelnemers en bots op dezelfde manier behandelt.

Voorbeeldgegevens

P2P-oproep

Dit zijn gedeelde velden voor alle logboeken in een P2P-aanroep:

"time":                     "2021-07-19T18:46:50.188Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "8d1a8374-344d-4502-b54b-ba2d6daaf0ae",

Overzichtslogboeken van oproepen

Oproepoverzichtslogboeken hebben gedeelde bewerkings- en categoriegegevens:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Hier volgt een oproepoverzicht voor VoIP-gebruiker 1:

"properties": {
    "identifier":               "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "callStartTime":            "2021-07-19T17:54:05.113Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",    
    "participantStartTime":     "2021-07-19T17:54:06.758Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.1.0",
    "osVersion":                "Windows 10.0.17763 Arch: x64"
}

Hier volgt een oproepoverzicht voor VoIP-gebruiker 2:

"properties": {
    "identifier":               "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "callStartTime":            "2021-07-19T17:54:05.335Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantStartTime":     "2021-07-19T17:54:06.335Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.1.0.0",
    "osVersion":                "null"
}

Hier volgt een overzichtslogboek voor meerdere tenantaanroepen voor VoIP-gebruiker 1:

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             520,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "520",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

Hier volgt een oproepoverzicht voor een PSTN-oproep:

Notitie

P2P- of groepsoproeplogboeken hebben os- en SDK-versies, ongeacht of dit de tenant van de deelnemer of de tenant van de bot is.

"properties": {
    "identifier": "b1999c3e-bbbb-4650-9b23-9999bdabab47",
    "callStartTime": "2022-08-07T13:53:12Z",
    "callDuration": 1470,
    "callType": "Group",
    "teamsThreadId": "19:36ec5177126fff000aaa521670c804a3@thread.v2",
    "participantId": " b25cf111-73df-4e0a-a888-640000abe34d",
    "participantStartTime": "2022-08-07T13:56:45Z",
    "participantDuration": 960,
    "participantEndReason": "0",
    "endpointId": "8731d003-6c1e-4808-8159-effff000aaa2",
    "endpointType": "PSTN",
    "sdkVersion": "Redacted",
    "osVersion": "Redacted"
}

Diagnostische logboeken aanroepen

Oproep diagnostische logboeken delen bewerkingsgegevens:

"operationName":            "CallDiagnostics",
"operationVersion":         "1.0",
"category":                 "CallDiagnostics",

Hier volgt een diagnostisch logboek voor een audiostream van VoIP-eindpunt 1 naar VoIP-eindpunt 2:

"properties": {
    "identifier":           "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "participantId":        "null",
    "endpointId":           "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "1000",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "82",
    "roundTripTimeMax":     "88",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

Hier volgt een diagnostisch logboek voor een audiostream van VoIP-eindpunt 2 naar VoIP-eindpunt 1:

"properties": {
    "identifier":           "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "participantId":        "null",
    "endpointId":           "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "1363841599",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "78",
    "roundTripTimeMax":     "84",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

Hier volgt een diagnostisch logboek voor een videostream van VoIP-eindpunt 1 naar VoIP-eindpunt 2:

"properties": {
    "identifier":           "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "participantId":        "null",
    "endpointId":           "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":         "VoIP",
    "mediaType":            "Video",
    "streamId":             "2804",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "103",
    "roundTripTimeMax":     "143",
    "jitterAvg":            "0",
    "jitterMax":            "4",
    "packetLossRateAvg":    "3.146336E-05",
    "packetLossRateMax":    "0.001769911"
}

Groepsgesprek

Gegevens voor een groepsoproep worden gegenereerd in drie logboeken voor het overzicht van oproepen en zes diagnostische logboeken voor oproepen. Dit zijn gedeelde velden voor alle logboeken in de aanroep:

"time":                     "2021-07-05T06:30:06.402Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "341acde7-8aa5-445b-a3da-2ddadca47d22",

Overzichtslogboeken van oproepen

Oproepoverzichtslogboeken hebben gedeelde bewerkings- en categoriegegevens:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Hier volgt een gespreksoverzicht voor VoIP-eindpunt 1:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "participantStartTime":     "2021-07-05T06:16:44.235Z",
    "participantDuration":      "82",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Darwin Kernel Version 18.7.0: Mon Nov 9 15:07:15 PST 2020; root:xnu-4903.272.3~3/RELEASE_ARM64_S5L8960X"
}

Hier volgt een gespreksoverzicht voor VoIP-eindpunt 3:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLTk2ZDUtYTZlM2I2ZjgxOTkw@thread.v2",
    "participantId":            "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "participantStartTime":     "2021-07-05T06:16:40.240Z",
    "participantDuration":      "87",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Android 11.0; Manufacturer: Google; Product: redfin; Model: Pixel 5; Hardware: redfin"
}

Hier volgt een overzicht van oproepen voor PSTN-eindpunt 2:

"properties": {
    "identifier":               "null",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "515650f7-8204-4079-ac9d-d8f4bf07b04c",
    "participantStartTime":     "2021-07-05T06:17:10.447Z",
    "participantDuration":      "52",
    "participantEndReason":     "0",
    "endpointId":               "46387150-692a-47be-8c9d-1237efe6c48b",
    "endpointType":             "PSTN",
    "sdkVersion":               "null",
    "osVersion":                "null"
}

Hier volgt een overzichtslogboek voor meerdere tenantgesprekken:

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             912,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "aa1dd7da-5922-4bb1-a4fa-e350a111fd9c",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "902",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

Hier volgt een overzichtslogboek voor meerdere tenantgesprekken met een bot als deelnemer:


"properties": {
    "identifier":             "b1902c3e-b9f7-4650-9b23-9999bdabab47",
    "callStartTime":          "2022-08-09T16:00:32Z",
    "callDuration":            1470,
    "callType":               "Group",
    "teamsThreadId":         "19:meeting_MmQwZDcwYTQtZ000HWE6NzI4LTg1YTAtNXXXXX99999ZZZZZ@thread.v2",
    "participantId":           "66e9d9a7-a434-4663-d91d-fb1ea73ff31e",
    "participantStartTime":    "2022-08-09T16:14:18Z",
    "participantDuration":      644,
    "participantEndReason":    "0",
    "endpointId":             "69680ec2-5ac0-4a3c-9574-eaaa77720b82",
    "endpointType":           "Bot",
    "sdkVersion":             "Redacted",
    "osVersion":              "Redacted"
}

Diagnostische logboeken aanroepen

Oproep diagnostische logboeken delen bewerkingsgegevens:

"operationName":            "CallDiagnostics",
"operationVersion":         "1.0",
"category":                 "CallDiagnostics",

Hier volgt een diagnostisch logboek voor een audiostream van VoIP-eindpunt 1 naar een servereindpunt:

"properties": {
    "identifier":           "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "participantId":        "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "endpointId":           "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "14884",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "46",
    "roundTripTimeMax":     "48",
    "jitterAvg":            "0",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

Hier volgt een diagnostisch logboek voor een audiostream van een servereindpunt naar VoIP-eindpunt 1:

"properties": {
    "identifier":           null,
    "participantId":        "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "endpointId":           null,
    "endpointType":         "Server",
    "mediaType":            "Audio",
    "streamId":             "2001",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "42",
    "roundTripTimeMax":     "44",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

Hier volgt een diagnostisch logboek voor een audiostream van VoIP-eindpunt 3 naar een servereindpunt:

"properties": {
    "identifier":           "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "participantId":        "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "endpointId":           "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "13783",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "45",
    "roundTripTimeMax":     "46",
    "jitterAvg":            "1",
    "jitterMax":            "2",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

Hier volgt een diagnostisch logboek voor een audiostream van een servereindpunt naar VoIP-eindpunt 3:

"properties": {
    "identifier":           "null",
    "participantId":        "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "endpointId":           null,
    "endpointType":         "Server"    
    "mediaType":            "Audio",
    "streamId":             "1000",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "45",
    "roundTripTimeMax":     "46",
    "jitterAvg":            "1",
    "jitterMax":            "4",
    "packetLossRateAvg":    "0",

Logboek van clientbewerkingen aanroepen en logboeken met statistieken van clientmedia aanroepen voor P2P- en groepsoproepen

Voor het logboek voor oproepclientbewerkingen en het tijdreekslogboek voor clientmediastatistieken is er geen verschil tussen P2P- en groepsoproepscenario's en het aantal logboeken is afhankelijk van de SDK-bewerkingen en de duur van de oproep. Hieronder ziet u enkele algemene voorbeelden die het schema van deze logboeken weergeven.

Logboek voor clientbewerkingen aanroepen

Hier volgt een aanroepclientbewerkingslogboek voor de bewerking CreateView:

"properties": {
    "TenantId":               "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
    "TimeGenerated":          "2024-01-09T17:06:50.3Z",
    "CallClientTimeStamp":    "2024-01-09T15:07:56.066Z",
    "OperationName":          "CreateView" ,   
    "CallId":                 "92d800c4-abde-40be-91e9-3814ee786b19",
    "ParticipantId":          "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
    "OperationType":          "client-api-request",
    "OperationId":            "0d987336-37e0-4acc-aba3-e48741d88103",
    "DurationMs":             "577",
    "ResultType":             "Succeeded",
    "ResultSignature":        "200",
    "SdkVersion":             "1.19.2.2_beta",
    "UserAgent":              "azure-communication-services/1.3.1-beta.1 azsdk-js-communication-calling/1.19.2-beta.2 (javascript_calling_sdk;#clientTag:904f667c-5f25-4729-9ee8-6968b0eaa40b). Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "ClientInstanceId":       "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "OperationPayload":       "{"StreamType":"Video","StreamId":"2.0","Source":"remote","RemoteParticipantId":"remote"}",
    "Type":                   "ACSCallClientOperations"
}

Elke deelnemer kan veel verschillende metrische gegevens voor een gesprek hebben. De volgende query kan worden uitgevoerd in Log Analytics in De Azure-portal om alle mogelijke bewerkingen in het logboek voor aanroepclientbewerkingen weer te geven:

ACSCallClientOperations | distinct OperationName

Tijdreekslogboek voor clientmediastatistieken aanroepen

Hier volgt een voorbeeld van het tijdreekslogboek voor mediastatistieken. Het toont de Jitter-meetwaarde van de deelnemer voor het ontvangen van een audiostream op een specifieke tijdstempel.

"properties": {
    "TenantId":                     "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
    "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"
}

Elke deelnemer kan veel verschillende metrische gegevens over mediastatistieken voor een gesprek hebben. De volgende query kan worden uitgevoerd in Log Analytics in Azure Portal om alle mogelijke metrische gegevens in dit logboek weer te geven:

ACSCallClientMediaStatsTimeSeries | distinct MetricName

Foutcodes

De participantEndReason eigenschap bevat een waarde uit de set aanroepende SDK-foutcodes. U kunt deze codes raadplegen om problemen tijdens de aanroep op te lossen voor elk eindpunt. Zie Problemen oplossen in Azure Communication Services.

Volgende stappen