Azure Communication Services-szobák naplói
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. Ezek a képességek az Azure Portalon konfigurálhatók.
Fontos
Az alábbiak az Azure Monitoron keresztül engedélyezett naplókra vonatkoznak (lásd még a gyakori kérdéseket). Ha engedélyezni szeretné ezeket a naplókat a Communications Servicesben, olvassa el a következőt: Naplózás engedélyezése a Diagnosztikai Gépház
Pre-requisites
Az Azure Communications Services monitorozási és elemzési funkciókat biztosít az Azure Monitor-naplók áttekintésében és az Azure Monitor-metrikákban. Minden Azure-erőforráshoz saját diagnosztikai beállítás szükséges, amely a következő feltételeket határozza meg:
- A naplók és a metrikaadatok kategóriái, amelyeket a beállításban meghatározott célhelyekre küldtek. A rendelkezésre álló kategóriák eltérőek lesznek a különböző erőforrástípusok esetében.
- Egy vagy több célhely a naplók elküldéséhez. Az aktuális célhelyek közé tartozik a Log Analytics-munkaterület, az Event Hubs és az Azure Storage.
- Egyetlen diagnosztikai beállítás legfeljebb egy célhelyet definiálhat. Ha több céltípusba (például két különböző Log Analytics-munkaterületre) szeretne adatokat küldeni, hozzon létre több beállítást. Minden erőforrás legfeljebb öt diagnosztikai beállításokkal rendelkezhet.
Az alábbiakban útmutatást talál az Azure Monitor-erőforrás konfigurálásához, hogy naplókat és metrikákat hozzon létre a Communications Serviceshez. A diagnosztikai Gépház az összes Azure-erőforráson való használatával kapcsolatos részletes dokumentációt a következő témakörben találja: Naplózás engedélyezése a Diagnosztikai Gépház
Megjegyzés:
A diagnosztikai beállítás neve alatt válassza az "Operatív szobák naplói" lehetőséget a szobák naplóinak engedélyezéséhez.
Áttekintés
A szobák működési naplói olyan események és tevékenységek rekordjai, amelyek betekintést nyújtanak a Rooms API-kérésekbe. Rögzítik a primitív szobák teljesítményével és funkcióival kapcsolatos részleteket, beleértve az egyes szobákra vonatkozó kérések állapotát, valamint a további tulajdonságokat. A szobák működési naplói olyan információkat tartalmaznak, amelyek segítenek azonosítani a helyiséghasználat trendjeit és mintáit.
Naplókategóriák
A Communication Services a következő típusú naplókat kínálja, amelyeket engedélyezhet:
- Az Operatív szobák naplói – a Szobák szolgáltatással kapcsolatos alapvető információkat nyújt
Az Operatív helyiségek naplói séma
Property | Leírás |
---|---|
Correlation ID |
A kérés egyedi azonosítója. |
Level |
Az esemény súlyossági szintje. |
Operation Name |
A naplórekordhoz társított művelet. Például: CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants. |
Operation Version |
A művelethez társított API-verzió. |
ResultType |
A művelet állapota. |
ResultSignature |
A művelet alállapota. Ha ez a művelet egy REST API-hívásnak felel meg, ez a mező a megfelelő REST-hívás HTTP-állapotkódja. |
.RoomId |
A szoba azonosítója. |
RoomLifeSpan |
A szoba élettartama percek alatt. |
AddedRoomParticipantsCount |
A helyiséghez hozzáadott résztvevők száma. |
UpsertedRoomParticipantsCount |
A résztvevők száma egy szobában. |
RemovedRoomParticipantsCount |
A helyiségből eltávolított résztvevők száma. |
TimeGenerated |
A napló létrehozásának időbélyege (UTC). |
PstnDialOutEnabled |
Azt jelzi, hogy egy helyiség képes-e PSTN-hívásokat kezdeményezni az értekezletre való meghíváshoz. |
Példa CreateRoom-naplóra
[
{
"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,
}
]
Példa GetRoom-naplóra
[
{
"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",
},
]
Példa UpdateRoom-naplóra
[
{
"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,
},
]
Példa DeleteRoom-naplóra
[
{
"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",
},
]
Példa ListRooms-naplóra
[
{
"CorrelationId": "KibM39CaXkK+HTInfsiY2w",
"Level": "Informational",
"OperationName": "ListRooms",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "200",
"TimeGenerated": "2022-08-19T17:07:30.5393800Z",
},
]
Példa UpdateParticipants-naplóra
[
{
"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",
},
]
(Lásd még :GYIK).