Logboeken van Azure Communication Services-ruimten

Artikel
10/28/2023

Azure Communication Services biedt mogelijkheden voor logboekregistratie die u kunt gebruiken om uw Communication Services-oplossing te bewaken en fouten op te sporen. Deze mogelijkheden kunnen worden geconfigureerd via de Azure Portal.

Belangrijk

Hieronder wordt verwezen naar logboeken die zijn ingeschakeld via Azure Monitor (zie ook veelgestelde vragen). Als u deze logboeken voor uw Communications Services wilt inschakelen, raadpleegt u: Logboekregistratie in diagnostische instellingen inschakelen

Vereisten

Azure Communications Services biedt bewakings- en analysefuncties via het overzicht van Azure Monitor-logboeken en metrische gegevens van Azure Monitor. Voor elke Azure-resource is een eigen diagnostische instelling vereist, die de volgende criteria definieert:

Categorieën logboeken en metrische gegevens die worden verzonden naar de bestemmingen die in de instelling zijn gedefinieerd. De beschikbare categorieën variëren voor verschillende resourcetypen.
Een of meer bestemmingen voor de logboeken. Huidige bestemmingen omvatten Log Analytics-werkruimte, Event Hubs en Azure Storage.
Eén diagnostische instelling kan niet meer dan één van de bestemmingen definiëren. Als u gegevens wilt verzenden naar meer dan een van een bepaald doeltype (bijvoorbeeld twee verschillende Log Analytics-werkruimten), maakt u meerdere instellingen. Elke resource kan maximaal vijf diagnostische instellingen hebben.

Hieronder volgen instructies voor het configureren van uw Azure Monitor-resource om te beginnen met het maken van logboeken en metrische gegevens voor uw Communications Services. Zie voor gedetailleerde documentatie over het gebruik van diagnostische instellingen voor alle Azure-resources: Logboekregistratie in diagnostische instellingen inschakelen

Notitie

Selecteer onder de naam van de diagnostische instelling 'Logboeken operationele ruimten' om de logboeken voor ruimten in te schakelen.

Overzicht

Operationele logboeken van ruimten zijn records van gebeurtenissen en activiteiten die inzicht bieden in uw ruimten-API-aanvragen. Ze leggen details vast over de prestaties en functionaliteit van de primitieve ruimten, inclusief de status van elke aanvraag voor ruimten en aanvullende eigenschappen. Operationele logboeken van ruimten bevatten informatie waarmee trends en patronen van het gebruik van ruimten kunnen worden geïdentificeerd.

Logboekcategorieën

Communication Services biedt de volgende typen logboeken die u kunt inschakelen:

Operational Rooms-logboeken - biedt basisinformatie met betrekking tot de Rooms-service

Schema voor operationele ruimten-logboeken

Eigenschappen	Beschrijving
`Correlation ID`	Unieke id van de aanvraag.
`Level`	De ernst van de gebeurtenis.
`Operation Name`	De bewerking die aan de logboekrecord is gekoppeld. Bijvoorbeeld CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	De API-versie die aan de bewerking is gekoppeld.
`ResultType`	De status van de bewerking.
`ResultSignature`	De substatus van de bewerking. Als deze bewerking overeenkomt met een REST API-aanroep, dan is dit veld de HTTP-statuscode van de bijbehorende REST-aanroep.
.`RoomId`	De id van de kamer.
`RoomLifeSpan`	De levensduur van de kamer in minuten.
`AddedRoomParticipantsCount`	Het aantal deelnemers dat is toegevoegd aan een ruimte.
`UpsertedRoomParticipantsCount`	Het aantal deelnemers dat is geupert in een ruimte.
`RemovedRoomParticipantsCount`	Het aantal deelnemers dat uit een ruimte is verwijderd.
`TimeGenerated`	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
`PstnDialOutEnabled`	Hiermee wordt aangegeven of een ruimte de mogelijkheid heeft om PSTN-oproepen uit te voeren om personen uit te nodigen voor een vergadering.

Voorbeeld van CreateRoom-logboek

    [
      {
      "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,
      }
    ]

Voorbeeld van GetRoom-logboek

    [
      {
      "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",
      },
    ]

Voorbeeld van UpdateRoom-logboek

    [
      {
      "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,
      },
    ]

Voorbeeld van DeleteRoom-logboek

    [
      {
      "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",
      },
    ]

Voorbeeld van listrooms-logboek

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

Voorbeeld van Het logboek UpdateParticipants

    [
      {
      "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",
      },
    ]

(Zie ook Veelgestelde vragen).

Delen via