Dela via

Anropa loggschema för klientåtgärder

Anropsklientens åtgärdslogg innehåller information på klientsidan om de anropande slutpunkterna och deltagarna som deltar i ett samtal. Dessa loggar är för närvarande i förhandsversion och visar klienthändelser som inträffade i ett anrop och vilka åtgärder en kund vidtar under ett samtal.

Den här loggen innehåller detaljerad information om åtgärder som vidtas under ett anrop och kan användas för att visualisera och undersöka samtalsproblem med hjälp av samtalsdiagnostik för din Azure Communication Services-resurs. Läs mer om samtalsdiagnostik

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

Anropa loggschema för klientåtgärder

I den här tabellen beskrivs varje egenskap.

Property beskrivning
CallClientTimeStamp Tidsstämpeln för när åtgärden inträffade på SDK:t i UTC.
OperationName Namnet på den åtgärd som utlöstes på den anropande SDK:t.
CallId 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. Det liknar correlationId i anropssammanfattningsloggen och anropsdiagnostikloggen.
ParticipantId Den unika identifieraren för varje samtalsben (i Gruppsamtal) eller samtalsdeltagare (i Peer to Peer-anrop). Det här ID:t är den viktigaste korrelationspunkten mellan Loggarna CallSummary, CallDiagnostic, CallClientOperations och CallClientMediaStats.
OperationType Anropa klientåtgärd.
OperationId En unik GGUID som identifierar en SDK-åtgärd.
DurationMs Den tid det tog för en anropande SDK-åtgärd att misslyckas eller lyckas.
ResultType Fält som beskriver lyckade eller misslyckade åtgärder.
ResultSignature HTTP-liknande fel eller lyckad kod (200, 500).
SdkVersion Den version av Calling SDK som används.
UserAgent Standardanvändaragentsträngen som baseras på webbläsaren eller plattformen Calling SDK används.
ClientInstanceId En unik GGUID som identifierar CallClient-objektet.
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").

EndpointId-värdet 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.
OperationPayload En dynamisk nyttolast som varierar beroende på vilken åtgärd som ger mer åtgärdsspecifik information.

Exempeldata för olika anropstyper

Anropa klientdriftsloggen

Här är en anropsklientåtgärdslogg för åtgärden "CreateView":

"properties": {
    "TenantId":               "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "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"
}

Varje deltagare kan ha många olika mått för ett anrop. Du kan köra följande fråga i Log Analytics i Azure Portal för att visa en lista över alla möjliga åtgärder i anropsklientens åtgärdslogg:

ACSCallClientOperations | distinct OperationName

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