Loggar för Azure Communication Services-rum

Artikel
10/16/2024

Azure Communication Services erbjuder loggningsfunktioner som du kan använda för att övervaka och felsöka din Communication Services-lösning. Dessa funktioner kan konfigureras via Azure Portal.

Viktigt!

Följande avser loggar som är aktiverade via Azure Monitor (se även Vanliga frågor och svar). Information om hur du aktiverar dessa loggar för dina kommunikationstjänster finns i: Aktivera loggning i diagnostikinställningar

Förutsättningar

Azure Communications Services tillhandahåller övervaknings- och analysfunktioner via Översikt över Azure Monitor-loggar och Azure Monitor-mått. Varje Azure-resurs kräver en egen diagnostikinställning, som definierar följande villkor:

Kategorier av loggar och måttdata som skickas till de mål som definieras i inställningen. De tillgängliga kategorierna varierar för olika resurstyper.
Ett eller flera mål för att skicka loggarna. Aktuella mål är Log Analytics-arbetsytan, Event Hubs och Azure Storage.
En enda diagnostikinställning kan inte definiera fler än ett av vart och ett av målen. Om du vill skicka data till mer än en av en viss måltyp (till exempel två olika Log Analytics-arbetsytor) skapar du flera inställningar. Varje resurs kan ha upp till fem diagnostikinställningar.

Följande är instruktioner för hur du konfigurerar din Azure Monitor-resurs för att börja skapa loggar och mått för dina kommunikationstjänster. Detaljerad dokumentation om hur du använder diagnostikinställningar för alla Azure-resurser finns i: Aktivera loggning i diagnostikinställningar

Kommentar

Under namn på diagnostikinställning väljer du "Operationsrumsloggar" för att aktivera loggarna för Rum.

Översikt

Driftloggar för rum är poster över händelser och aktiviteter som ger insikter om dina rums-API-begäranden. De samlar in information om prestanda och funktioner i de primitiva rummen, inklusive status för varje rumsbegäran samt ytterligare egenskaper. Rummens driftloggar innehåller information som hjälper dig att identifiera trender och mönster för rumsanvändning.

LOGGKATEGORIER

Communication Services erbjuder följande typer av loggar som du kan aktivera:

Loggar för operationsrum – ger grundläggande information om rumstjänsten

Loggschema för operationsrum

Property	beskrivning
`Correlation ID`	Unikt ID för begäran.
`Level`	Allvarlighetsgraden för händelsen.
`Operation Name`	Åtgärden som är associerad med loggposten. Till exempel CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	Api-versionen som är associerad med åtgärden.
`ResultType`	Status för åtgärden.
`ResultSignature`	Åtgärdens understatus. Om den här åtgärden motsvarar ett REST API-anrop är det här fältet HTTP-statuskoden för motsvarande REST-anrop.
.`RoomId`	Rummets ID.
`RoomLifeSpan`	Rummets livslängd på några minuter.
`AddedRoomParticipantsCount`	Antalet deltagare som lagts till i ett rum.
`UpsertedRoomParticipantsCount`	Antalet deltagare ökade i ett rum.
`RemovedRoomParticipantsCount`	Antalet deltagare som tagits bort från ett rum.
`TimeGenerated`	Tidsstämpeln (UTC) för när loggen genererades.
`PstnDialOutEnabled`	Anger om ett rum har möjlighet att göra PSTN-anrop för att bjuda in personer till ett möte.

Exempel på CreateRoom-logg

    [
      {
      "CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
      "Level": "Informational",
      "OperationName": "CreateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": 201,
      "RoomId": "99466898241024408",
      "RoomLifespan": 61,
      "AddedRoomParticipantsCount": 4,
      "TimeGenerated": "5/25/2023, 4:32:49.469 AM",
      "PstnDialOutEnabled": false,
      }
    ]

Exempel på GetRoom-logg

    [
      {
      "CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
      "Level": "Informational",
      "OperationName": "GetRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 61,
      "TimeGenerated": "2022-08-19T17:07:30.2400300Z",
      },
    ]

Exempel på UpdateRoom-logg

    [
      {
      "CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
      "Level": "Informational",
      "OperationName": "UpdateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.3543160Z",
      "PstnDialOutEnabled": false,
      },
    ]

Exempel på DeleteRoom-logg

    [
      {
      "CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
      "Level": "Informational",
      "OperationName": "DeleteRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "204",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
      },
    ]

Exempel på ListRooms-logg

	[
	  {
	  "CorrelationId": "KibM39CaXkK+HTInfsiY2w",
	  "Level": "Informational",
	  "OperationName": "ListRooms",
	  "OperationVersion": "2023-10-30-preview",
	  "ResultType": "Succeeded",
	  "ResultSignature": "200",
	  "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
	  },
	]

Exempel på UpdateParticipants-logg

    [
      {
      "CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
      "Level": "Informational",
      "OperationName": "UpdateParticipants",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "UpsertedRoomParticipantsCount": 5,
      "RemovedRoomParticipantsCount": 1,
      "TimeGenerated": "2023-04-14T17:07:30.5393800Z",
      },
    ]

(Se även Vanliga frågor och svar).

Dela via