Arama Kaydı günlüklerini Azure İletişim Hizmetleri

Makale
10/26/2023

Azure İletişim Hizmetleri, İletişim Hizmetleri çözümünüzü izlemek ve hatalarını ayıklamak için kullanabileceğiniz günlük özellikleri sunar. Bu özellikleri Azure portalı aracılığıyla yapılandırabilirsiniz.

Bu makaledeki içerik, Azure İzleyici aracılığıyla etkinleştirilen günlükleri ifade eder (ayrıca bkz. SSS). İletişim Hizmetleri için bu günlükleri etkinleştirmek için bkz . Tanılama ayarlarında günlüğü etkinleştirme.

Kaynak günlüğü kategorileri

İletişim Hizmetleri, etkinleştirebileceğiniz aşağıdaki günlük türlerini sunar:

Kullanım günlükleri: Faturalanan her hizmet teklifiyle ilişkili kullanım verilerini sağlayın.
Arama Kaydı özet günlükleri: Arama kayıtları için özet bilgileri sağlayın, örneğin:
- Arama süresi.
- Medya içeriği (örneğin, ses/video, karışık veya transkripsiyon).
- Kayıt için kullanılan biçim türleri (örneğin, WAV veya MP4).
- Kaydın sona erme nedeni.
Gelen işlem günlüklerini kaydetme: Çağrı Kaydı işlemleri için gelen istekler hakkında bilgi sağlayın. Her giriş, Kayıt Başlat, Kayıt Durdurma, Kayıt Duraklatma ve Özgeçmiş Kaydı gibi Çağrı Kaydı API'lerine yapılan çağrının sonucuna karşılık gelir.

Bir aramanın veya toplantının sonunda bir kayıt dosyası oluşturulur. Bir kullanıcı veya uygulama (bot) kaydı başlatabilir ve durdurabilir. Kayıt, sistem hatası nedeniyle de sona erebilir.

Özet günlükler, bir kayıt indirilmeye hazır olduktan sonra yayımlanır. Günlükler, Azure İzleyici kaynak günlükleri için standart gecikme süresi içinde yayımlanır. Bkz . Azure İzleyici'de günlük verileri alma süresi.

Kullanım günlüğü şeması

Özellik	Açıklama
`timestamp`	Günlüğün oluşturulduğu zaman damgası (UTC).
`operationName`	Günlük kaydıyla ilişkili işlem.
`operationVersion`	İşlem `api-version` bir API aracılığıyla gerçekleştirildiyse `operationName` işlemle ilişkili değer. Bu işleme karşılık gelen API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm işlemin sürümünü temsil eder.
`category`	Olayın günlük kategorisi. Kategori, kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın blobu `properties` içinde görünen özellikler, günlük kategorisi ve kaynak türü içinde aynıdır.
`correlationID`	bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için bunu kullanabilirsiniz.
`Properties`	Çeşitli İletişim Hizmetleri modları için geçerli olan diğer veriler.
`recordID`	Kullanım kaydının benzersiz kimliği.
`usageType`	Kullanım modu (örneğin, Sohbet, PSTN veya NAT).
`unitType`	Kullanımın bir kullanım modu (örneğin, dakika, megabayt veya iletiler) için temel alındığı birim türü.
`quantity`	Bu kayıt için kullanılan veya kullanılan birim sayısı.

Çağrı Kaydı özet günlük şeması

Özellik adı	Veri türü	Açıklama
`timeGenerated`	DateTime	Günlüğün oluşturulduğu zaman damgası (UTC).
`operationName`	String	Günlük kaydıyla ilişkili işlem.
`correlationId`	String	Tablolar arasındaki olayları ilişkilendirmek için kullanılan kimlik.
`recordingID`	String	Bu günlüğün başvurduğu kaydın kimliği.
`category`	String	Olayın günlük kategorisi. Aynı günlük kategorisine ve kaynak türüne sahip günlükler aynı özellik alanlarına sahiptir.
`resultType`	String	İşlemin durumu.
`level`	String	İşlemin önem düzeyi.
`chunkCount`	Tamsayı	Kayıt için oluşturulan toplam öbek sayısı.
`channelType`	String	Kaydın karışık veya karışık gibi kanal türü.
`recordingStartTime`	DateTime	Kaydın başladığı saat.
`contentType`	String	Yalnızca ses, ses/video veya transkripsiyon gibi kaydın içeriği.
`formatType`	String	Kaydın dosya biçimi.
`recordingLength`	Çift	Kaydın saniye cinsinden süresi.
`audioChannelsCount`	Tamsayı	Kayıttaki toplam ses kanalı sayısı.
`recordingEndReason`	String	Kaydın sona erme nedeni.

Arama Kaydı ve örnek veriler

"operationName":            "Call Recording Summary",
"operationVersion":         "1.0",
"category":                 "RecordingSummary",

Bir aramada, bir kayıt olayının kaç kez tetiklendiğinden bağlı olarak bir veya birden çok kayıt olabilir.

Örneğin, bir aracı kaydedilen bir satırda giden bir çağrı başlatırsa ve kötü bir ağ sinyali nedeniyle çağrı düşerse, callID tek recordingID bir değere sahip olur. Aracı müşteriyi geri çağırırsa, sistem yeni callID bir örnek ve yeni recordingID bir değer oluşturur.

Örnek: Tek bir kayıt için Arama Kaydı

"properties"
{  
  "TimeGenerated":"2022-08-17T23:18:26.4332392Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "zzzzzz-cada-4164-be10-0000000000",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBvaW5xxxxxxxxFmNjkwxxxxxxxxxxxxSZXNvdXJjZVNwZWNpZmljSWQiOiJiZGU5YzE3Ni05M2Q3LTRkMWYtYmYwNS0yMTMwZTRiNWNlOTgifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-16T09:07:54.0000000Z",
    "RecordingLength": "73872.94",
    "ChunkCount": 6,
   "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

Aracı bir kayıt başlatırsa ve çağrı hala açıkken kaydı birkaç kez durdurup yeniden başlatırsa, callID birçok recordingID değere sahip olur. Değerlerin sayısı, kayıt olaylarının kaç kez tetiklenmiş olduğuna bağlıdır.

Örnek: Birçok kayda tek bir çağrı için Arama Kaydı


{   
 "TimeGenerated": "2022-08-17T23:55:46.6304762Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBxxxxxxxxxxxxjkwMC05MmEwLTRlZDYtOTcxYS1kYzZlZTkzNjU0NzciLCJSxxxxxNwZWNpZmljSWQiOiI5ZmY2ZTY2Ny04YmQyLTQ0NzAtYmRkYy00ZTVhMmUwYmNmOTYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:43.3304762Z",
    "RecordingLength": 3.34,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}
{
    "TimeGenerated": "2022-08-17T23:55:56.7664976Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuxxxxxxiOiI4NDFmNjkwMC1mMjBiLTQzNmQtYTg0Mi1hODY2YzE4M2Y0YTEiLCJSZXNvdXJjZVNwZWNpZmljSWQiOiI2YzRlZDI4NC0wOGQ1LTQxNjEtOTExMy1jYWIxNTc3YjM1ODYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:54.0664976Z",
    "RecordingLength": 2.7,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

ACSCallRecordingIncomingOperations günlükleri

Özellikler şunlardır:

Özellik	Açıklama
`timeGenerated`	Günlüğün oluşturulduğu zaman damgası (UTC).
`callConnectionId`	Varsa, arama bağlantısının veya bacağının kimliği.
`callerIpAddress`	İşlem genel kullanıma açık IP adresine sahip bir varlıktan gelen bir API çağrısına karşılık geliyorsa çağıranın IP adresi.
`correlationId`	bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için bunu kullanabilirsiniz.
`durationMs`	İşlemin milisaniye cinsinden süresi.
`level`	İşlemin önem düzeyi.
`operationName`	Günlük kayıtlarıyla ilişkili işlem.
`operationVersion`	İşlemin işlemi veya sürümüyle ilişkili API sürümü (API sürümü yoksa).
`resourceId`	Kaydın ilişkili olduğu kaynağın benzersiz tanımlayıcısı.
`resultSignature`	İşlemin alt durumu. Bu işlem bir REST API çağrısına karşılık geliyorsa, bu alan ilgili REST çağrısının HTTP durum kodudur.
`resultType`	İşlemin durumu.
`sdkType`	İstekte kullanılan SDK türü.
`sdkVersion`	SDK sürümü.
`serverCallId`	Sunucu çağrı kimliği.
`URI`	İsteğin URI'sini.

Bir örnek aşağıda verilmiştir:

"properties"
{  "TimeGenerated": "2023-05-09T15:58:30.100Z",
    "Level": "Informational",
    "CorrelationId": "a999f996-b4e1-xxxx-ac04-a59test87d97",
    "OperationName": "ResumeCallRecording",
    "OperationVersion": "2023-03-06",
    "URI": "https://acsresouce.communication.azure.com/calling/recordings/   eyJQbGF0Zm9ybUVuZHBviI0MjFmMTIwMC04MjhiLTRmZGItOTZjYi0...:resume?api-version=2023-03-06",
    "ResultType": "Succeeded",
    "ResultSignature": 202,
    "DurationMs": 130,
    "CallerIpAddress": "127.0.0.1",
    "CallConnectionId": "d5596715-ab0b-test-8eee-575c250e4234",
    "ServerCallId": "aHR0cHM6Ly9hcGk0vjCCCCCCQd2pRP2k9OTMmZT02Mzc5OTQ3xMDAzNDUwMzg...",
    "SdkVersion": "1.0.0-alpha.20220829.1",
    "SdkType": "dotnet"
}

Sonraki adımlar

Arama Kaydı içgörüleri alın.
Arama Kaydı hakkında daha fazla bilgi edinin.

Aracılığıyla paylaş