Megosztás a következőn keresztül:

Az Azure Communication Services hanghívási és videohívási naplói

  • Cikk

Az Azure Communication Services naplózási képességeket kínál, amelyekkel monitorozhat és hibakeresést végezhet a Communication Services-megoldásban. Ezeket a képességeket az Azure Portalon konfigurálhatja.

A cikk tartalma az Azure Monitoron keresztül engedélyezett naplókra vonatkozik (lásd még a gyakori kérdéseket). Ha engedélyezni szeretné ezeket a naplókat a Communication Serviceshez, olvassa el a naplózás engedélyezése a diagnosztikai beállításokban című témakört.

Adatfogalmak

Az adatfogalmak alábbi magas szintű leírása a hanghívásra és a videohívásra vonatkozik. Ezeket a fogalmakat fontos áttekinteni, hogy megértse a naplókban rögzített adatok jelentését.

Entitások és azonosítók

Ismerkedjen meg a következő kifejezésekkel:

  • Hívás: Az adatokban látható módon a hívás egy absztrakció, amelyet correlationIda következő ábrázol: . correlationId Az értékek minden híváshoz egyediek, és időkorlátja callStartTime és callDuration.

  • Résztvevő: Ez az entitás a végpont és a kiszolgáló közötti kapcsolatot jelöli. A résztvevő (participantId) csak akkor van jelen, ha a hívás csoportos hívás.

  • Végpont: Ez a legegyedibb entitás, amelyet endpointIda . Minden hívás olyan esemény, amely két vagy több végpont adatait tartalmazza. A végpontok a hívás résztvevőit jelölik.

    EndpointType azt jelzi, hogy a végpont egy emberi felhasználó (PSTN vagy VoIP), egy robot vagy egy olyan kiszolgáló, amely több résztvevőt kezel egy hívásban. endpointType"Server"Érték esetén a végponthoz nincs hozzárendelve egyedi azonosító. Elemezheti endpointType és az értékek számát endpointId annak meghatározásához, hogy hány felhasználó és más, nem embertelen résztvevő (robotok és kiszolgálók) csatlakoznak a híváshoz.

    Az Androidhoz és iOS-hez készült natív SDK-k ugyanazt endpointId az értéket használják fel a felhasználók számára több hívás során, így a munkamenetek során megismerheti a felhasználói élményeket. Ez a folyamat eltér a webes végpontoktól, amelyek mindig új endpointId értéket hoznak létre minden új híváshoz.

  • Stream: Ez a legrészletesebb entitás. Minden irányhoz (bejövő vagy kimenő) és mediaType értékhez (például AudioVideovagy) egy stream tartozik.

Adatdefiníciók

Használati napló sémája

Tulajdonság Leírás
Timestamp A napló létrehozásának időbélyege (UTC).
Operation Name A naplórekordhoz társított művelet.
Operation Version A api-version művelethez társított érték, ha a Operation Name műveletet API-val hajtották végre. Ha egyetlen API sem felel meg ennek a műveletnek, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letiltja a naplókat egy erőforráson. Az esemény blobjában megjelenő properties tulajdonságok megegyeznek egy naplókategórián és erőforrástípuson belül.
Correlation ID A korrelált események azonosítója. Ezzel azonosíthatja a több tábla közötti korrelált eseményeket.
Properties Egyéb adatok, amelyek a kommunikációs szolgáltatások különböző módjaira vonatkoznak.
Record ID A használati rekord egyedi azonosítója.
Usage Type A használati mód (például Csevegés, PSTN vagy NAT).
Unit Type A használati mód (például percek, megabájtok vagy üzenetek) alapján használt egység típusa.
Quantity A rekordhoz használt vagy felhasznált egységek száma.

Hívásösszegző naplóséma

A hívásösszegző napló adatokat tartalmaz az összes hívás kulcstulajdonságainak azonosításához. A hívás minden participantId egyes (endpointId társközi [P2P] hívás esetén) értékéhez más hívásösszegző napló jön létre.

Fontos

A hívás összegzési naplójában szereplő résztvevők adatai a résztvevő bérlője alapján változnak. Az SDK-verzió és az operációs rendszer verziója újra lesz alkalmazva, ha a résztvevő nem ugyanabban a bérlőben (más néven bérlőközi) van, mint a Communication Services-erőforrás. A bérlők közötti résztvevők az erőforrás-bérlő által meghívott külső felhasználókként vannak besorolva a hívás során való csatlakozáshoz és együttműködéshez.

Tulajdonság Leírás
time A napló létrehozásának időbélyege (UTC).
operationName A naplórekordhoz társított művelet.
operationVersion A api-version művelethez társított érték, ha a operationName műveletet API-val hajtották végre. Ha egyetlen API sem felel meg ennek a műveletnek, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
category Az esemény naplókategóriája. Ez a tulajdonság az a részletesség, amely lehetővé teszi vagy letilthatja az erőforrások naplóit. Az esemény blobjában megjelenő properties tulajdonságok megegyeznek egy naplókategórián és erőforrástípuson belül.
correlationId A hívás egyedi azonosítója. Azonosítja az összes résztvevő és végpont korrelált eseményeit, amelyek egyetlen hívás során csatlakoznak, és segítségével különböző naplókból származó adatokat kapcsolhat össze. Ha bármikor meg kell nyitnia egy támogatási esetet a Microsoftnál, az correlationId érték használatával egyszerűen azonosíthatja a hibaelhárítás alatt lévő hívást.
identifier A felhasználó egyedi azonosítója. Az identitás lehet Azure Communication Services-felhasználó, Microsoft Entra-felhasználói azonosító, Teams névtelen felhasználói azonosító vagy Teams-robotazonosító. Ezzel az azonosítóval korrelálhatja a felhasználói eseményeket a naplók között.
callStartTime Egy időbélyeg a hívás indításához, a végpontok első csatlakozási kísérlete alapján.
callDuration A hívás időtartama másodpercben kifejezve. Ez az első megkísérelt kapcsolaton és a két végpont közötti utolsó kapcsolat végén alapul.
callType A hívás típusa. Vagy ."P2P""Group" A "P2P" hívás közvetlen 1:1-es kapcsolat csak két, nem kiszolgálóvégpont között. A "Group" hívás olyan hívás, amely két végpontnál több végponttal rendelkezik, vagy hívásként "Group" jön létre a kapcsolat előtt.
teamsThreadId A Teams-szál azonosítója. Ez az azonosító csak akkor releváns, ha a hívás Teams-értekezletként van rendszerezve. Ezután a Microsoft Teams és az Azure Communication Services közötti együttműködés használati esetét jelöli.

Ez az azonosító az operatív naplókban jelenik meg. Ezt az azonosítót a csevegési API-kon keresztül is lekérheti.
participantId A végpont (endpointType = "Server") és a kiszolgáló közötti "Participant" kétirányú kapcsolat megjelenítésére létrehozott azonosító. Amikor callType = "P2P"közvetlen kapcsolat van két végpont között, és nem participantId jön létre érték.
participantStartTime A résztvevő első csatlakozási kísérletének kezdetének időbélyege.
participantDuration Az egyes résztvevők közötti kapcsolatok időtartama másodpercben, a kapcsolat végének időbélyegétől participantStartTime kezdve.
participantEndReason A résztvevők közötti kapcsolat megszűnésének oka. Olyan hívási SDK-hibakódokat tartalmaz, amelyeket az SDK bocsát ki (ha releváns) az egyes participantId értékekhez.
endpointId A híváshoz csatlakoztatott végpontokat jelképező egyedi azonosító, amely endpointType meghatározza a végpont típusát. Ha az érték az null, a csatlakoztatott entitás a Communication Services-kiszolgáló (endpointType = "Server").

Az endpointId érték néha megmaradhat ugyanahhoz a felhasználóhoz a natív ügyfelek több hívása (correlationId) során. Az értékek száma endpointId határozza meg a hívásösszegző naplók számát. Minden endpointId értékhez külön összefoglaló napló jön létre.
endpointType Ez az érték a híváshoz csatlakoztatott végpontok tulajdonságait ismerteti. Tartalmazhat "Server", "VOIP", "PSTN", "BOT"vagy "Unknown".
sdkVersion A Communication Services Calling SDK-verziójának verziósztringje, "1.1.00.20212500"amelyet az egyes releváns végpontok használnak (például).
osVersion Egy sztring, amely az egyes végponteszközök operációs rendszerét és verzióját jelöli.
participantTenantId A résztvevő identitásához társított Microsoft-bérlő azonosítója. A bérlő lehet az Azure Communication Services-erőforrás tulajdonosa, vagy egy M365-identitás Microsoft-bérlője. Ez a mező a bérlők közötti újrafelfedés irányítására szolgál.
participantType A résztvevő leírása az ügyfél (Azure Communication Services vagy Teams) és identitása (Azure Communication Services vagy Microsoft 365) kombinációjaként. A lehetséges értékek a következők: Azure Communication Services (Azure Communication Services-identitás és Azure Communication Services SDK), Teams (Teams-identitás és Teams-ügyfél), Azure Communication Services külső felhasználóként (Azure Communication Services-identitás és Azure Communication Services SDK a Teams-hívásokban vagy -értekezletekben), Az Azure Communication Services mint Microsoft 365-felhasználó (M365-identitás és Azure Communication Services-ügyfél), és a Teams Voice Apps szolgáltatásban.
pstnPartcipantCallType A PSTN-résztvevők típusát és irányát jelöli, beleértve a segélyhívást, a közvetlen útválasztást, az átvitelt, a továbbítást stb.
ParticipantEndSubCode ez az SDK-hiba alkódját jelöli, amelyet az SDK bocsát ki (ha releváns) az egyes participantId értékekhez.
ResultCategory A meghívást befejező résztvevő kategóriáját jelöli. A következő 4 érték egyike lehet: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError.

Diagnosztikai naplóséma meghívása

A hívásdiagnosztikai naplók fontos információkat nyújtanak az egyes résztvevők végpontjairól és médiaátviteleiről. Emellett olyan méréseket is biztosítanak, amelyek segítenek a minőségi problémák megértésében.

A hívás minden végpontja esetében külön hívásdiagnosztikai napló jön létre a végpontok közötti kimenő médiastreamekhez (például hang- vagy videostreamekhez). A P2P-hívásokban minden napló olyan adatokat tartalmaz, amelyek az egyes végpontokhoz társított kimenő streamekhez kapcsolódnak. A csoportos hívásokban participantId kulcsazonosítóként szolgál a kapcsolódó kimenő naplók különálló résztvevőkapcsolatba való csatlakoztatásához. A hívásdiagnosztikai naplók érintetlenek maradnak, és a résztvevők bérlőitől függetlenül ugyanazok.

Feljegyzés

Ebben a cikkben a P2P- és csoporthívások alapértelmezés szerint ugyanazon a bérlőn belül vannak minden bérlőközi hívási forgatókönyv esetében. Ezek a cikk során ennek megfelelően vannak megadva.

Tulajdonság Leírás
operationName A naplórekordhoz társított művelet.
operationVersion A api-version művelethez társított érték, ha a operationName műveletet API-val hajtották végre. Ha egyetlen API sem felel meg ennek a műveletnek, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
category Az esemény naplókategóriája. Ez a tulajdonság az a részletesség, amely lehetővé teszi vagy letilthatja az erőforrások naplóit. Az esemény blobjában megjelenő properties tulajdonságok megegyeznek egy naplókategórián és erőforrástípuson belül.
correlationId A hívás egyedi azonosítója. Azonosítja az összes résztvevő és végpont korrelált eseményeit, amelyek egyetlen hívás során csatlakoznak. Ha bármikor meg kell nyitnia egy támogatási esetet a Microsoftnál, az correlationId érték használatával egyszerűen azonosíthatja a hibaelhárítás alatt lévő hívást.
participantId A végpont (endpointType = "Server") és a kiszolgáló közötti "Participant" kétirányú kapcsolat megjelenítésére létrehozott azonosító. Amikor callType = "P2P"közvetlen kapcsolat van két végpont között, és nem participantId jön létre érték.
identifier A felhasználó egyedi azonosítója. Az identitás lehet Azure Communication Services-felhasználó, Microsoft Entra-felhasználói azonosító, Teams-objektumazonosító vagy Teams-robotazonosító. Ezzel az azonosítóval korrelálhatja a felhasználói eseményeket a naplók között.
endpointId A híváshoz csatlakoztatott végpontokat jelképező egyedi azonosító, amely endpointType meghatározza a végpont típusát. Ha az érték az null, a csatlakoztatott entitás a Communication Services-kiszolgáló. EndpointId a natív ügyfelek több hívása (correlationId) esetén is megmaradhat ugyanahhoz a felhasználóhoz, de minden hívás esetében egyedi, ha az ügyfél webböngésző.
endpointType Az egyes endpointId példányok tulajdonságait leíró érték. Tartalmazhat "Server", , "PSTN""VOIP", "BOT", "Voicemail", , "Anonymous"vagy "Unknown".
mediaType Az egyes streamek végpontjai között továbbított adathordozó típusát leíró sztringérték. Lehetséges értékek a következők: "Audio", "Video""VBSS" (videóalapú képernyőmegosztás) és "AppSharing".
streamId Nem egyedi egész szám, amely az mediaTypeazonos participantId értékű streamek egyedi azonosítására használható.
transportType Az egyes participantId értékekhez tartozó hálózati átviteli protokollt leíró sztringérték. Tartalmazhat "UDP", "TCP"vagy "Unrecognized". "Unrecognized" azt jelzi, hogy a rendszer nem tudta megállapítani, hogy az átviteli típus TCP vagy UDP volt-e.
roundTripTimeAvg Az IP-csomagok egy adott végpontról egy másikra való lekérésének átlagos időtartama egy participantDuration adott időszakon belül. Ez a hálózati propagálási késleltetés a két pont közötti fizikai távolsághoz, a fénysebességhez és a különböző útválasztók által a közöttük felmerülő terheléshez kapcsolódik.

A késést egyirányú vagy oda-vissza menetidőként (RTT) mérik. Értéke ezredmásodpercben kifejezve. Az 500 ms-nál nagyobb RTT negatívan befolyásolja a hívás minőségét.
roundTripTimeMax A mért maximális RTT (ezredmásodpercben) egy csoportos hívás során participantDuration vagy callDuration egy P2P-hívás időszakában éri el a médiastreamet.
jitterAvg Az egymást követő csomagok közötti késés átlagos változása. Az Azure Communication Services puffereléssel képes alkalmazkodni a jitter bizonyos szintjeihez. Ha a jitter túllépi a pufferelést, amely körülbelül jitterAvg 30 ms-nál nagyobb időpontban van, valószínűleg negatív minőségi hatás jelentkezik. A különböző sebességgel érkező csomagok miatt a beszélő hangja robotikusnak hangzik.

Ezt a metrikát a rendszer minden médiastream participantDuration esetében egy csoportos hívás időszakában vagy callDuration egy P2P-hívás időszakában méri.
jitterMax Az egyes médiastreamek csomagjai között mért maximális jitter érték. A hálózati kipukkadások problémákat okozhatnak a hang- és videoforgalomban.
packetLossRateAvg Az elveszett csomagok átlagos százalékos aránya. A csomagvesztés közvetlenül befolyásolja a hangminőséget. A kis méretű, egyéni elveszett csomagoknak szinte nincs hatása, míg a back-to-back burst veszteségek miatt a hang teljesen ki van vágva. Az elvetett és a célhelyükre nem érkező csomagok réseket okoznak az adathordozón. Ez a helyzet a kihagyott szótagokat és szavakat, valamint a szaggatott videót és a megosztást eredményezi.

A 10%-nál (0,1) nagyobb csomagveszteség valószínűleg negatív minőségi hatással van. Ezt a metrikát a rendszer minden médiastream participantDuration esetében egy csoportos hívás időszakában vagy callDuration egy P2P-hívás időszakában méri.
packetLossRateMax Ez az érték az egyes médiastreamek maximális csomagvesztési arányát (százalékát) jelöli egy participantDuration csoportos hívás vagy egy P2P-hívás időszaka alatt callDuration . A hálózati kipukkadások problémákat okozhatnak a hang- és videoforgalomban.
JitterBufferSizeAvg A jitter puffer átlagos mérete az egyes médiastreamek időtartama alatt. A jitter puffer egy megosztott adatterület, ahol a hangcsomagok egyenletesen elosztva gyűjthetők, tárolhatók és elküldhetők a hangfeldolgozónak. A jitter puffer a jitter hatásainak ellensúlyozására szolgál.

A jitter pufferek lehetnek statikusak vagy dinamikusak. A statikus jitter pufferek rögzített méretre vannak beállítva, míg a dinamikus jitter pufferek a hálózati körülmények alapján módosíthatják a méretüket. A jitter puffer célja, hogy zökkenőmentes és zavartalan hang- és videoadatfolyamot biztosítson a felhasználónak.

A webes SDK-ban ez a "JitterBufferSizeAvg" a hívás során a "jitterBufferDelay" átlagos értéke, a "jitterBufferDelay" egy hangminta vagy egy videokeret időtartama, amely a jitter pufferben marad.

Általában, ha a "JitterBufferSizeAvg" érték nagyobb, mint 200 ms, az negatív minőségi hatást okoz.
JitterBufferSizeMax Az egyes médiastreamek időtartama alatt mért maximális jitter pufferméret.

Általában, ha ez az érték nagyobb, mint 200 ms, az negatív minőségi hatással lesz.
HealedDataRatioAvg Az elveszett vagy sérült adatcsomagok átlagos aránya, amelyeket a gyógyító sikeresen rekonstruált vagy helyreállított a hangstream időtartama alatt. A kijavított adatarány a VoIP-rendszerekben használt hibajavítási technikák hatékonyságának mértéke.

Ha ez az érték nagyobb, mint 0,1 (10%), rossz minőségűnek tekintjük a streamet.
HealedDataRatioMax Az egyes médiastreamek időtartama alatt mért maximális begyógyult adatarány.

Ha ez az érték nagyobb, mint 0,1 (10%), rossz minőségűnek tekintjük a streamet.
VideoFrameRateAvg A video-/képernyőmegosztási hívás során másodpercenként továbbított videoképek átlagos száma. A videó képkockasebessége hatással lehet a videóstream minőségére és simaságára, a magasabb képkockasebesség általában egyenletesebb és folyékonyabb mozgást eredményez. A WebRTC-videó normál képkockasebessége általában másodpercenként 30 képkocka (fps), bár ez az adott megvalósítástól és hálózati feltételektől függően változhat.

A stream minősége akkor tekinthető rossznak, ha ez az érték kisebb, mint 7 a videóstreameknél, vagy 1-nél kisebb a képernyőmegosztási stream esetében.
RecvResolutionHeight A video-/képernyőmegosztási hívás során továbbított bejövő videostream függőleges méretének átlaga. Képpontban mérhető, és az egyik tényező, amely meghatározza a videóstream általános felbontását és minőségét. A használt konkrét megoldás a hívásban érintett eszközök és hálózati feltételek képességeitől függhet.

A stream minősége akkor tekinthető rossznak, ha ez az érték kisebb, mint 240 a videóstreamek esetében, vagy kevesebb, mint 768 a képernyőmegosztási stream esetében.
RecvFreezeDurationPerMinuteInMs A bejövő videók/képernyőmegosztási streamek átlagos rögzítési időtartama ezredmásodpercben. A lefagyások oka általában a rossz hálózati állapot, és ronthatja a stream minőségét.

A stream minősége akkor tekinthető gyengenek, ha ez az érték nagyobb, mint 6000 ms a videóstreameknél, vagy nagyobb, mint 25 000 ms a képernyőmegosztási stream esetében.
PacketUtilization Az adott médiastreamhez küldött vagy fogadott csomagok.

Általában minél hosszabb a hívás, annál nagyobb az érték. Ha ez az érték nulla, az azt jelezheti, hogy az adathordozó nem áramlik.
VideoBitRateAvg Egy videó- vagy képernyőmegosztás-stream átlagos bitráta (bit/másodperc)

Az alacsony bitrátaérték gyenge hálózati problémát jelezhet. A minimális bitráta (sávszélesség) itt található: Hálózati sávszélesség.
VideoBitRateMax A videó- vagy képernyőmegosztási stream maximális bitráta (bit/másodperc).

Az alacsony bitrátaérték gyenge hálózati problémát jelezhet. A minimális bitráta (sávszélesség) itt található: Hálózati sávszélesség.
StreamDirection A médiastream iránya. Bejövő vagy kimenő.
CodecName A médiastreamek feldolgozásához használt kodek neve. Lehet OPUS, G722, H264S, SATIN stb.

Ügyfélműveleti naplóséma meghívása

A hívásügyfél műveleti naplója ügyféloldali információkat nyújt a hívásvégpontokról és a hívásban részt vevő résztvevőkről. Ezek a naplók jelenleg előzetes verzióban érhetők el, és megjelenítik a hívás során történt ügyféleseményeket, valamint azt, hogy az ügyfél milyen műveleteket hajtott végre a hívás során.

Ez a napló részletes információkat nyújt a hívás során végrehajtott műveletekről, és az Azure Communication Services-erőforrás Hívásdiagnosztika szolgáltatásával vizualizálhatja és kivizsgálhatja a hívásokkal kapcsolatos problémákat. További információ a Hívásdiagnosztika szolgáltatásról

Tulajdonság Leírás
CallClientTimeStamp Az időbélyeg az SDK-n (UTC) történt, amikor a művelet folyamatban volt.
OperationName A hívó SDK-n aktivált művelet neve.
CallId A hívás egyedi azonosítója. Azonosítja az összes résztvevő és végpont korrelált eseményeit, amelyek egyetlen hívás során csatlakoznak, és segítségével különböző naplókból származó adatokat kapcsolhat össze. Hasonló a hívásösszegző naplóban és a hívásdiagnosztikai naplóban található korrelációs azonosítóhoz.
ParticipantId Az egyes hívási lábak egyedi azonosítója (csoportos hívásokban) vagy a hívás résztvevőinek (társközi hívásokban). Ez az azonosító a CallSummary, a CallDiagnostic, a CallClientOperations és a CallClientMediaStats naplók közötti fő korrelációs pont.
OperationType Ügyfélművelet hívása.
OperationId SDK-műveletet azonosító egyedi GGUID.
DurationMs A hívási SDK-művelet sikertelen vagy sikeres volt.
ResultType Egy művelet sikerességét vagy sikertelenségét leíró mező.
ResultSignature HTTP-hez hasonló hiba vagy sikerkód (200, 500).
SdkVersion A használt Hívás SDK verziója.
UserAgent A rendszer a böngésző vagy a platform hívó SDK-ján alapuló szabványos felhasználói ügynök sztringet használja.
ClientInstanceId A CallClient objektumot azonosító egyedi GGUID.
EndpointId Az egyedi azonosító, amely a híváshoz csatlakoztatott végpontokat jelöli, ahol az endpointType határozza meg a végpont típusát. Ha az érték null, a csatlakoztatott entitás a Communication Services-kiszolgáló (endpointType = "Kiszolgáló").

Az endpointId érték néha megmaradhat ugyanazon a felhasználón több híváson (correlationId) a natív ügyfelek esetében. Az endpointId-értékek száma határozza meg a hívásösszegző naplók számát. Minden endpointId-értékhez külön összefoglaló napló jön létre.
OperationPayload A művelettől függően változó dinamikus hasznos adat, amely további műveletspecifikus részleteket biztosít.

Ügyfél adathordozó-statisztikáinak hívása idősor-naplóséma

A hívás ügyféloldali médiastatisztikáinak idősornaplója ügyféloldali információkat nyújt a hívásban részt vevő egyes résztvevők közötti médiastreamekről. Ezek a naplók jelenleg korlátozott előzetes verzióban érhetők el, és részletes idősoradatokat szolgáltatnak a hang-, video- és képernyőmegosztási médiatartalmakról a résztvevők között az alapértelmezett 10 másodperces összesítési időközzel. A naplók részletes idősor-információkat tartalmaznak a médiastream típusáról, irányáról, kodekéről és bitráta tulajdonságairól (például max, min, átlag).

Ez a napló részletesebb információkat nyújt, mint a Hívásdiagnosztikai napló, hogy megértse a résztvevők közötti médiagőzöket. Segítségével vizualizálhatja és megvizsgálhatja a hívásokkal kapcsolatos minőségi problémákat az Azure Communication Services-erőforrás hívásdiagnosztikai szolgáltatásán keresztül. További információ a Hívásdiagnosztika szolgáltatásról

Tulajdonság Leírás
OperationName A naplórekordhoz társított művelet.
CallId A hívás egyedi azonosítója. Azonosítja az összes résztvevő és végpont korrelált eseményeit, amelyek egyetlen hívás során csatlakoznak, és segítségével különböző naplókból származó adatokat kapcsolhat össze. Hasonló a hívásösszegző naplóban és a hívásdiagnosztikai naplóban található korrelációs azonosítóhoz.
CallClientTimeStamp Az időbélyeg, amikor a médiastatisztikák rögzítésre kerülnek.
MetricName A médiastatisztikák neve, például Bitrate, JitterInMs, PacketsPerSecond stb.
Count Az adott időbélyegen mintavételezett adatpontok száma.
Sum A mintavételezett adatpontok metrikaértékeinek összege.
Average A mintavételezett adatpontok átlagos metrikaértéke. Átlag = Összeg /Darabszám
Minimum A mintavételezett adatpontok metrikaértékeinek minimális értéke.
Maximum A mintavételezett adatpontok metrikaértékeinek maximális száma.
MediaStreamDirection A médiastream iránya. Elküldhető vagy fogadható
MediaStreamType A médiastream típusa. Ez lehet videó, hang vagy képernyő.
MediaStreamCodec A médiastream kódolásához/dekódolásához használt kodek, például H264, OPUS, VP8 stb.
ParticipantId A hívás minden végpontjának megjelenítéséhez létrehozott egyedi azonosító.
ClientInstanceId A hívási SDK-ban létrehozott Hívásügyfél objektumot jelképező egyedi azonosító.
EndpointId A híváshoz csatlakoztatott végpontok egyedi azonosítója. Az EndpointId a natív ügyfelek több hívása (callIds) esetén is megmaradhat ugyanahhoz a felhasználóhoz, de minden hívás esetében egyedi, ha az ügyfél webböngésző. Vegye figyelembe, hogy az EndpointId jelenleg nem szerepel a naplóban. Ha a jövőben implementálják, az megegyezik a CallSummary/Diagnostics naplókban szereplő értékekkel
RemoteParticipantId Az egyedi azonosító, amely a médiastream távoli végpontját jelöli. Egy felhasználó például több videostreamet is megjeleníthet az ugyanabban a hívásban lévő többi felhasználó számára. Minden videóstream egy másik RemoteParticipantId azonosítóval rendelkezik.
RemoteEndpointId Ugyanaz, mint az EndpointId, de a stream távoli oldalán lévő felhasználót jelöli.
MediaStreamId Egy egyedi azonosító, amely a hívásban szereplő egyes médiastreameket jelöli. A MediaStreamId jelenleg nincs kialakítva az ügyfelekben. A implementáláskor megegyezik a CallDiagnostics-naplók streamId oszlopával.
AggregationIntervalSeconds A médiastatisztikák összesítésének időintervalluma. Az SDK hívása során a médiametrikák mintavételezése 1 másodpercenként történik, és amikor jelentést teszünk a naplóban, 10 másodpercenként összesítjük az összes mintát. Tehát a táblázat minden sora legfeljebb 10 mintavételi ponttal rendelkezik.

P2P és csoportos hívások

A hívásoknak két típusa van, az alábbiak szerint callType:

  • Társközi (P2P) hívás: Csak két végpont közötti kapcsolat, kiszolgálóvégpont nélkül. A P2P-hívások a végpontok közötti hívásként indulnak el, és nem csoportos hívási eseményként jönnek létre a kapcsolat előtt.

    P2P-hívást ábrázoló diagram két végponton.

  • Csoportos hívás: Minden olyan hívás, amelyhez két végpontnál több végpont csatlakozik. A csoportos hívások között szerepel egy kiszolgálóvégpont, valamint az egyes végpontok és a kiszolgáló közötti kapcsolat. Azok a P2P-hívások, amelyek a hívás során egy másik végpontot adnak hozzá, megszűnnek P2P-ként, és csoportos hívássá válnak. A metrikák használatával participantDuration meghatározhatja, hogy az egyes végpontok mikor csatlakoztak a participantStartTime híváshoz.

    Több végponton keresztüli csoportos hívásokat bemutató diagram.

Naplóstruktúra

Az Azure Communication Services négy típusú naplót hoz létre:

  • Hívásösszegző naplók: Alapvető információkat tartalmaz a hívásról, beleértve az összes releváns azonosítót, időbélyeget, végpontot és SDK-információt. A hívás minden résztvevője számára a Communication Services létrehoz egy külön hívásösszegző naplót.

    Ha valaki újra csatlakozik egy híváshoz, az adott résztvevő ugyanazzal EndpointId az értékkel rendelkezik, de egy másik ParticipantId értékkel. Ez a végpont ezután két hívásösszegző naplóval rendelkezhet.

  • Diagnosztikai naplók hívása: Tartalmazza a streamtel kapcsolatos információkat, valamint a tapasztalati mérések minőségét jelző metrikákat. Az EndpointId Azure Communication Services minden híváshoz (beleértve a kiszolgálót is) külön hívásdiagnosztikai naplót hoz létre az egyes médiastreamekhez (például hang- vagy videóstreamekhez) a végpontok között.

  • Hívásügyfél műveleti naplói: Részletes hívásügyfél-eseményeket tartalmaz. Ezek a naplóesemények minden EndpointId híváshoz létre lesznek hozva, és a létrehozott eseménynaplók száma a résztvevő által a hívás során végrehajtott műveletektől függ.

  • Ügyféloldali médiastatisztikai naplók meghívása: Részletes médiastream-értékeket tartalmaz. Ezek a naplók egy hívás minden médiastreamjében létre lesznek hozva. Az EndpointId Azure Communication Services minden híváshoz (beleértve a kiszolgálót is) külön naplót hoz létre a végpontok közötti médiastreamekhez (hang- vagy videóstreamekhez). Az egyes naplókban generált adatok mennyisége a hívás időtartamától és a hívásban lévő médiatartalmak számától függ.

A P2P-hívásokban minden napló olyan adatokat tartalmaz, amelyek az egyes végpontokhoz társított kimenő streamekhez kapcsolódnak. Egy csoportos hívásban minden egyes, a bejövő streamekhez tartozó endpointType = "Server" stream létrehoz egy naplót, amely adatokat tartalmaz a bejövő streamekhez. Minden más stream olyan naplókat hoz létre, amelyek adatokat tartalmaznak az összes nem kiszolgáló végpont kimenő streamjeihez. Csoportos hívások esetén használja az participantId értéket kulcsként a kapcsolódó bejövő és kimenő naplók különálló résztvevőkapcsolatba való csatlakoztatásához.

Példa: P2P-hívás

Az alábbi ábra két, közvetlenül P2P-hívásban csatlakoztatott végpontot ábrázol. Ebben a példában a Communication Services két hívásösszegző naplót hoz létre (egyet minden participantID értékhez) és négy hívásdiagnosztikai naplót (egyet minden médiastreamhez).

Az Azure Communication Services (ACS) hívási ügyfél résztvevőinek hívási ügyfélműveleti naplók sorozata és az ügyféloldali médiastatisztikák idősornaplói is megjelennek. A naplók pontos száma attól függ, hogy a rendszer milyen típusú SDK-műveleteket hív meg, és mennyi ideig tart a hívás.

Diagram, amely egy P2P-hívást jelenít meg ugyanazon a bérlőn belül.

Példa: Csoportos hívás

Az alábbi diagram egy csoporthívási példát mutat be három participantId értékkel (ami három résztvevőt jelent) és egy kiszolgálóvégponttal. Több érték endpointId is megjelenhet több résztvevőben – például amikor ugyanabból az eszközről csatlakoznak újra egy híváshoz. A Communication Services minden participantId értékhez egy hívásösszegző naplót hoz létre. Négy hívásdiagnosztikai naplót hoz létre: egyet minden médiastreamhez.participantId

Az Azure Communication Services (ACS) meghívja az ügyfél résztvevőit, a hívásügyfél műveleti naplói megegyeznek a P2P-hívásokkal. A hívó SDK-t használó résztvevők esetében a hívásügyfél műveleti naplóinak sorozata lesz.

Az Azure Communication Services (ACS) meghívja az ügyfél résztvevőit, a hívásügyfél műveleti naplói és az ügyféloldali médiastatisztikák idősornaplói megegyeznek a P2P-hívásokkal. Az SDK-t hívó minden résztvevő esetében a hívásügyfél műveleti naplói és az ügyféloldali médiastatisztikák idősornaplói lesznek.

Diagram, amely egy csoporthívást jelenít meg ugyanabban a bérlőben.

Példa: Bérlők közötti P2P-hívás

Az alábbi ábra két résztvevőt ábrázol több bérlő között, amelyek közvetlenül csatlakoznak egy P2P-híváshoz. Ebben a példában a Communication Services egy hívásösszegző naplót hoz létre (minden résztvevőhöz egyet) a módosított operációsrendszer- és SDK-verziókkal. A Communication Services emellett négy hívásdiagnosztikai naplót is létrehoz (mindegyik médiastreamhez egyet). Minden napló olyan adatokat tartalmaz, amelyek a kimenő adatfolyamhoz participantIDkapcsolódnak.

Bérlők közötti P2P-hívást ábrázoló diagram.

Példa: Bérlők közötti csoporthívás

Az alábbi diagram egy csoporthívási példát mutat be, amely három participantId értéket tartalmaz több bérlő között. A Communication Services egy hívásösszegző naplót hoz létre minden résztvevő számára az operációs rendszer és az SDK újrakiosztott verzióival. A Communication Services emellett négy hívásdiagnosztikai naplót is létrehoz, amelyek az egyes participantId értékekhez kapcsolódnak (egy-egy az egyes médiastreamekhez).

Bérlőközi csoporthívást ábrázoló diagram.

Feljegyzés

Ez a kiadás csak a kimenő diagnosztikai naplókat támogatja. A robothoz és a résztvevőhöz társított operációsrendszer- és SDK-verziók újra kiírhatók, mert a Communication Services ugyanúgy kezeli a résztvevők és a robotok identitásait.

Mintaadatok

P2P-hívás

Az alábbiakban a P2P-hívás összes naplójának megosztott mezőit találja:

"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",

Hívásösszegző naplók

A hívásösszegző naplók megosztott műveletekkel és kategóriainformációkkal rendelkeznek:

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

Az 1. VoIP-felhasználó hívásainak összegzése:

"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"
}

Íme egy hívás összefoglalása a 2. VoIP-felhasználóhoz:

"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"
}

Az 1. VoIP-felhasználó bérlők közötti hívásösszegző naplója:

"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"
}

Egy PSTN-hívás hívásának összegzése:

Feljegyzés

A P2P- vagy csoporthívási naplók operációsrendszer- és SDK-verziói újra vannak kiosztva, függetlenül attól, hogy a résztvevő bérlője vagy a robot bérlője.

"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"
}

Diagnosztikai naplók hívása

A diagnosztikai naplók meghívása megosztási műveletinformációk:

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

Az 1. VoIP-végpontról a 2. VoIP-végpontra irányuló hangstream diagnosztikai naplója:

"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"
}

Az alábbiakban egy diagnosztikai naplót talál a 2. VoIP-végpontról az 1. VoIP-végpontra irányuló hangstreamhez:

"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"
}

Az 1. VoIP-végpontról a 2. VoIP-végpontra irányuló videostream diagnosztikai naplója:

"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"
}

Csoportos hívás

A csoporthívások adatai három hívásösszegző naplóban és hat hívásdiagnosztikai naplóban jönnek létre. A hívás összes naplójának megosztott mezői a következők:

"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",

Hívásösszegző naplók

A hívásösszegző naplók megosztott műveletekkel és kategóriainformációkkal rendelkeznek:

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

Íme egy hívás összefoglalása az 1. VoIP-végponthoz:

"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"
}

Íme egy hívás összefoglalása a 3. VoIP-végponthoz:

"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"
}

Íme egy hívás összefoglalása a 2. PSTN-végponthoz:

"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"
}

Íme egy bérlőközi hívás összefoglaló naplója:

"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"
}

Az alábbiakban egy bérlők közötti hívásösszegzési naplót talál egy robottal résztvevőként:


"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"
}

Diagnosztikai naplók hívása

A diagnosztikai naplók meghívása megosztási műveletinformációk:

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

Az 1. VoIP-végpontról egy kiszolgálóvégpontra irányuló hangstream diagnosztikai naplója:

"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"
}

Az alábbiakban egy diagnosztikai naplót talál egy hangstreamhez egy kiszolgálóvégpontról az 1. VoIP-végpontra:

"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"
}

Az alábbiakban egy diagnosztikai naplót talál egy hangstreamhez a VoIP 3 végpontjától egy kiszolgálóvégpontig:

"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"
}

Az alábbiakban egy diagnosztikai naplót talál egy hangstreamhez egy kiszolgálóvégpontról a 3. VoIP-végpontra:

"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",

Ügyfélműveleti napló meghívása és ügyféloldali médiastatisztikai naplók meghívása P2P- és csoportos hívásokhoz

Az ügyfélműveleti naplók és az ügyféloldali médiaállapotok idősornaplója esetében nincs különbség a P2P és a csoportos hívási forgatókönyvek között, és a naplók száma az SDK-műveletektől és a hívás időtartamától függ. Az alábbiakban néhány általános mintát mutatunk be, amelyek a naplók sémáját mutatják be.

Ügyfélműveleti napló meghívása

A "CreateView" művelet hívási ügyfélműveleti naplója:

"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"
}

Minden résztvevőnek számos különböző metrikája lehet egy híváshoz. A következő lekérdezés futtatható a Log Analyticsben az Azure Portalon a hívásügyfél műveleti naplójában szereplő összes lehetséges művelet listázásához:

ACSCallClientOperations | distinct OperationName

Ügyféloldali médiastatisztikák idősornaplójának meghívása

Az alábbiakban egy példa látható a médiastatisztika idősornaplójára. Megjeleníti a résztvevő Jitter-metrikáját a hangstreamek adott időbélyegen való fogadásához.

"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"
}

Minden résztvevő számos különböző médiastatisztikával rendelkezhet egy híváshoz. Az alábbi lekérdezés futtatható a Log Analyticsben az Azure Portalon a napló összes lehetséges metrikája megjelenítéséhez:

ACSCallClientMediaStatsTimeSeries | distinct MetricName

Hibakódok

A participantEndReason tulajdonság az SDK-hibakódok halmazából származó értéket tartalmaz. Ezekre a kódokra hivatkozva elháríthatja a hívás során felmerülő problémákat az egyes végpontok esetében. Lásd: Hibaelhárítás az Azure Communication Servicesben.

Következő lépések