Dela via

Schema för anropssammanfattningslogg

Sammanfattningsloggen för samtal innehåller data som hjälper dig att identifiera viktiga egenskaper för alla anrop. En annan anropssammanfattningslogg skapas för varje participantId (eller endpointId för peer-to-peer-anrop [P2P]-anrop) i anropet.

För varje deltagare i ett anrop skapar Communication Services en distinkt anropssammanfattningslogg. Om någon ansluter till ett anrop igen har deltagaren samma EndpointId värde men ett annat ParticipantId värde. Slutpunkten kan sedan ha två sammanfattningsloggar för samtal.

Använda samtalsloggar

Vi rekommenderar att du samlar in alla tillgängliga samtalsloggar i en log analytics-resurs så att du kan övervaka samtalsanvändningen och förbättra samtalskvaliteten och ta emot nya loggar från Azure Communication Services när vi släpper dem.

Det finns två huvudverktyg som du kan använda för att övervaka dina samtal och förbättra samtalskvaliteten.

Vi rekommenderar att du använder instrumentpanelerna för röst- och videoinsikter för att starta kvalitetsundersökningar och använda samtalsdiagnostik efter behov för att utforska enskilda samtal när du behöver detaljerad information.

Databegrepp

Viktigt!

Du måste samla in loggar om du vill analysera dem. Mer information finns i: Hur gör jag för att lagra loggar?

Azure lagrar inte dina samtalsloggdata om du inte aktiverar dessa specifika diagnostikinställningar. Dina samtalsdata är inte retroaktivt tillgängliga. Du ackumulerar data när du har skapat diagnostikinställningarna.

Datadefinitioner

Schema för anropssammanfattningslogg

Viktigt!

Deltagarinformationen i samtalssammanfattningsloggen varierar beroende på deltagarens klientorganisation. SDK-versionen och OS-versionen redigeras om deltagaren inte finns i samma klientorganisation (kallas även för korsklientorganisation) som Communication Services-resursen. Deltagare mellan klientorganisationer klassificeras som externa användare som bjuds in av en resursklientorganisation för att ansluta till och samarbeta under ett anrop.

I den här tabellen beskrivs varje egenskap.

Egendom beskrivning
time Tidsstämpeln (UTC) när loggen genererades.
operationName Åtgärden som är associerad med loggposten.
operationVersion Värdet api-version som är associerat med åtgärden, om åtgärden operationName utfördes via ett API. Om inget API motsvarar den här åtgärden representerar versionen versionen av åtgärden, om egenskaperna som är associerade med åtgärden ändras i framtiden.
category Loggkategorin för händelsen. Den här egenskapen är den kornighet där du kan aktivera eller inaktivera loggar på en resurs. Egenskaperna som visas i blobben för properties en händelse är desamma inom en loggkategori och resurstyp.
correlationId Det unika ID:t för ett anrop. Den identifierar korrelerade händelser från alla deltagare och slutpunkter som ansluter under ett enda anrop, och du kan använda dem för att koppla data från olika loggar. Om du någonsin behöver öppna ett supportärende correlationId med Microsoft kan du använda värdet för att enkelt identifiera det samtal som du felsöker.
identifier Det unika ID:t för användaren. Identiteten kan vara en Azure Communication Services-användare, ett Microsoft Entra-användar-ID, ett anonymt användar-ID för Teams eller ett Teams-robot-ID. Du kan använda det här ID:t för att korrelera användarhändelser mellan loggar.
callStartTime En tidsstämpel för anropets start, baserat på det första anslutningsförsöket från valfri slutpunkt.
callDuration Varaktigheten för samtalet, uttryckt i sekunder, baserat på det första anslutningsförsöket och slutet av den sista anslutningen mellan två slutpunkter.
callType Typ av anrop. Den innehåller antingen "P2P" eller "Group". Ett "P2P" anrop är en direkt 1:1-anslutning mellan endast två, icke-serverslutpunkter. Ett "Group" anrop är ett anrop som har fler än två slutpunkter eller som skapas som "Group" anrop före anslutningen.
teamsThreadId Teams tråd-ID. Det här ID:t är endast relevant när samtalet organiseras som ett Teams-möte. Det representerar sedan användningsfallet för samverkan mellan Microsoft Teams och Azure Communication Services.

Det här ID:t exponeras i driftloggar. Du kan också hämta det här ID:t via chatt-API:erna.
participantId Det ID som genereras för att representera dubbelriktad anslutning mellan en "Participant" slutpunkt (endpointType = "Server") och servern. När callType = "P2P"finns det en direkt anslutning mellan två slutpunkter och inget participantId värde genereras.
participantStartTime Tidsstämpeln för början av deltagarens första anslutningsförsök.
participantDuration Varaktigheten för varje deltagaranslutning i sekunder, från participantStartTime till tidsstämpeln när anslutningen avslutades.
participantEndReason Orsaken till slutet på en deltagares anslutning. Den innehåller anropande SDK-felkoder som SDK genererar (när det är relevant) för varje participantId värde.
endpointId Det unika ID som representerar varje slutpunkt som är ansluten till anropet, där endpointType definierar slutpunktstypen. När värdet är nullär den anslutna entiteten Communication Services-servern (endpointType = "Server").

Värdet endpointId kan ibland sparas för samma användare över flera anrop (correlationId) för interna klienter. Antalet endpointId värden avgör antalet anropssammanfattningsloggar. En distinkt sammanfattningslogg skapas för varje endpointId värde.
endpointType Det här värdet beskriver egenskaperna för varje slutpunkt som är ansluten till anropet. Den kan innehålla "Server", "VOIP", "PSTN", "BOT"eller "Unknown".
sdkVersion Versionssträngen för den Communication Services Calling SDK-version som varje relevant slutpunkt använder (till exempel "1.1.00.20212500").
osVersion En sträng som representerar operativsystemet och versionen av varje slutpunktsenhet.
participantTenantId ID:t för den Microsoft-hyresgäst som är associerad med deltagarens identitet. Klientorganisationen kan antingen vara den Azure-klientorganisation som äger Azure Communication Services-resursen eller Microsoft-klientorganisationen för en Microsoft 365-identitet. Det här fältet används för att vägleda radering mellan hyresgäster.
participantType Beskrivning av deltagaren som en kombination av klienten (Azure Communication Services eller Teams) och dess identitet (Azure Communication Services eller Microsoft 365). Möjliga värden är: Azure Communication Services (Azure Communication Services-identitet och Azure Communication Services SDK), Teams (Teams-identitet och Teams-klient), Azure Communication Services som Extern Teams-användare (Azure Communication Services-identitet och Azure Communication Services SDK i Teams-samtal eller möte), Azure Communication Services som Microsoft 365-användare (Microsoft 365-identitet och Azure Communication Services-klient), och Teams Voice Apps.
pstnParticipantCallType Representerar typen och riktningen för PSTN-deltagare, inklusive nödsamtal, direktdirigering, överföring, vidarebefordran och så vidare.
ParticipantEndSubCode Representerar den anropande SDK-felunderkoden som SDK genererar (när det är relevant) för varje participantId värde.
ResultCategory Representerar kategorin för deltagaren som avslutar anropet. Det kan vara ett av följande fyra värden: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError.
DiagnosticOptions Med det här värdet kan utvecklare koppla anpassade taggar till sin klienttelemetri, som sedan kan visas i avsnittet Samtalsdiagnostik. Detta hjälper dig att identifiera och felsöka problem mer effektivt. Mer information om hur du lägger till anpassade taggar i det här värdet finns i Självstudie om hur du lägger till anpassade taggar i klienttelemetrin
callDebuggingInfo Det här värdet innehåller json-objekt med nyckel/värde-par som representerar interna egenskaper för det anrop som används för Microsoft-felsökning.
TPE Det här värdet anger att samtalet är associerat med ett utökningsscenario för Teams Phone.

Felkoder

Egenskapen participantEndReason innehåller ett värde från uppsättningen anropande SDK-felkoder. Du kan referera till dessa koder för att felsöka problem som upptäcktes under anropet för varje slutpunkt. Se Felsöka svarskoder för samtalsslut för Calling SDK, Call Automation SDK, PSTN, Chat SDK och SMS SDK.

Exempeldata för olika anropstyper

Kommentar

I den här artikeln finns P2P- och gruppanrop inom samma klientorganisation som standard. Alla samtalsscenarier som är tvärhyresgäster anges på ett lämpligt sätt i hela artikeln.

P2P-anrop

Här är delade fält för alla loggar i ett P2P-anrop:

"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":            "aaaa0000-bb11-2222-33cc-444444dddddd",

Samtalssammanfattningsloggar

Sammanfattningsloggar för samtal delar åtgärds- och kategoriinformation.

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

Här är en samtalssammanfattning för VoIP-användare 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"
}

Här är en samtalssammanfattning för VoIP-användare 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"
}

Här är en sammanställning av samtalsloggar mellan olika klientorganisationer för VoIP-användare 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"
}

Här är en samtalssammanfattning för ett PSTN-samtal:

Kommentar

P2P- eller gruppanropsloggar har OS- och SDK-versioner borttagna, oavsett om det är deltagarens eller robotens klientorganisation.

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

Gruppsamtal

Data för ett gruppanrop genereras i tre anropssammanfattningsloggar och sex anropsdiagnostikloggar. Här är de gemensamma fälten för alla loggar i samtalet:

"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":            "bbbb1111-cc22-3333-44dd-555555eeeeee",

Samtalssammanfattningsloggar

Sammanfattningsloggar för samtal delar åtgärds- och kategoriinformation.

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

Här är en anropssammanfattning för VoIP-slutpunkt 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"
}

Här är en anropssammanfattning för VoIP-slutpunkt 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"
}

Här är en samtalssammanfattning för PSTN-slutpunkt 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"
}

Här är en översikt över samtalsloggar mellan hyrande enheter:

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

Här är en sammanfattningslogg för samtal mellan olika hyresgäster med en bot som deltagare.


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

Vanliga frågor och svar

Hur gör jag för att lagra loggar?

I följande avsnitt beskrivs det här kravet.

Azure Communication Services-loggar lagras inte i ditt Azure-konto som standard, så du måste börja lagra dem för att verktyg som instrumentpanelen för röst- och videoinsikter ska fungera och anropa diagnostiken . Om du vill samla in dessa samtalsloggar måste du aktivera en diagnostikinställning som dirigerar samtalsdata till en Log Analytics-arbetsyta.

Data lagras inte retroaktivt, så du börjar samla in samtalsloggar först när du har konfigurerat diagnostikinställningen.

Följ anvisningarna för att lägga till diagnostikinställningar för din resurs i Aktivera loggar via diagnostikinställningar i Azure Monitor. Vi rekommenderar att du först samlar in alla loggar. När du har förstått funktionerna i Azure Monitor kan du avgöra vilka loggar du vill behålla och hur länge. När du lägger till diagnostikinställningen uppmanas du att välja loggar. Om du vill samla in alla loggar väljer du allaLoggar.

Din datavolym, kvarhållning och användning i Log Analytics i Azure Monitor debiteras via befintliga Azure-datamätare. Vi rekommenderar att du övervakar dina dataanvändnings- och kvarhållningsprinciper för kostnadsöverväganden efter behov. Mer information finns i Kontrollera kostnader.

Om du har flera Resurs-ID:t för Azure Communications Services måste du aktivera de här inställningarna för varje resurs-ID.

Nästa steg