Çağrı Otomasyonu günlüklerini Azure İletişim Hizmetleri
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.
Önkoşullar
Azure İletişim Hizmetleri aracılığıyla izleme ve analiz özellikleri sağlarAzure İzleyici Günlükleri ve Azure İzleyici Ölçümleri. Her Azure kaynağı, aşağıdaki ölçütleri tanımlayan kendi tanılama ayarını gerektirir:
Ayarın tanımladığı hedeflere gönderilen günlük ve ölçüm verilerinin kategorileri. Kullanılabilir kategoriler kaynak türüne göre farklılık gösterir.
Günlükleri göndermek için bir veya daha fazla hedef. Geçerli hedefler Arasında Log Analytics çalışma alanı, Azure Event Hubs ve Azure Depolama yer alır.
Tek bir tanılama ayarı her hedef türünden en fazla birini tanımlayabilir. Birden fazla hedef türüne (örneğin, iki Log Analytics çalışma alanı) veri göndermek istiyorsanız, birden çok ayar oluşturun. Her kaynağın en fazla beş tanılama ayarı olabilir.
Önemli
Anketlerinizin günlük verilerini bir Log Analytics çalışma alanına, olay hub'ına veya anket verilerinizi almak ve analiz etmek üzere bir Azure depolama hesabına göndermek için Azure İzleyici'de bir tanılama ayarını etkinleştirmeniz gerekir. Çağrı Otomasyonu verilerini bu seçeneklerden birine göndermezseniz anket verileriniz depolanmaz ve kaybolur.
Aşağıdaki yönergeler, İletişim Hizmetleri örneğiniz için günlükler ve ölçümler oluşturmaya başlamak için Azure İzleyici kaynağınızı yapılandırın. Tüm Azure kaynaklarında tanılama ayarlarını kullanma hakkında ayrıntılı belgeler için bkz . Tanılama ayarlarında günlüğe kaydetmeyi etkinleştirme.
Tanılama ayarı adının altında, Çağrı Otomasyonu günlüklerini etkinleştirmek için İşlem Çağrısı Otomasyon Günlükleri ve Çağrı Otomasyonu Olay Özet Günlükleri'ni seçin.
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.
- Çağrı otomasyonu işlem günlükleri: Çağrı Otomasyonu API'leri istekleriyle ilgili operasyonel bilgiler sağlayın. Hata noktalarını belirlemek ve bir çağrıda yapılan tüm istekleri sorgulamak için bu günlükleri kullanabilirsiniz (bağıntı kimliğini veya sunucu çağrı kimliğini kullanarak).
- Çağrı Otomasyonu medya özet günlükleri: Medya işlemlerinin sonucu hakkında bilgi sağlayın. Arama Otomasyonu API'lerini kullanarak medya isteklerinde bulunurken bu günlükler size zaman uyumsuz olarak gelir. Bu günlükleri, hata noktalarını ve kullanıcıların uygulamanızla nasıl etkileşim kurabileceğine ilişkin olası desenleri tanımlamaya yardımcı olması için kullanabilirsiniz.
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ı Otomasyonu işlem günlükleri
| Özellik | Açıklama |
|---|---|
TimeGenerated |
Günlüğün oluşturulduğu zaman damgası (UTC). |
OperationName |
Günlük kaydıyla ilişkili işlem. |
CorrelationID |
Bir çağrıyı tanımlamak ve benzersiz bir çağrı için olayları ilişkilendirmek için tanımlayıcı. |
OperationVersion |
İşlem api-version bir API aracılığıyla gerçekleştirildiyse operationName , işlemle ilişkili sürüm. 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. |
ResultType |
İşlemin durumu. |
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. |
DurationMs |
İşlemin milisaniye cinsinden süresi. |
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. |
Level |
Olayın önem düzeyi. |
URI |
İsteğin URI'sini. |
CallConnectionId |
Varsa, arama bağlantısını temsil eden kimlik. Bu kimlik her katılımcı için farklıdır ve çağrıya olan bağlantılarını tanımlamak için kullanılır. |
ServerCallId |
Çağrıyı tanımlamak için benzersiz bir kimlik. |
SDKVersion |
İstek için kullanılan SDK sürümü. |
SDKType |
İstek için kullanılan SDK türü. |
ParticipantId |
İsteği yapan çağrı katılımcısını tanımlama kimliği. |
SubOperationName |
Medya işleminin alt türünü tanımlamak için kullanılan ad (oynatma veya tanıma). |
operationID |
Zaman uyumsuz olayları ilişkilendirmek için kullanılan kimlik. |
Çağrı Otomasyonu işlem günlüğü örneği aşağıda verilmişti:
[
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "e2a97d52-0cbb-4adf-8c4b-e10f791fb764",
"OperationName": "Play",
"OperationVersion": "3/6/23",
"URI": "ccts-media-synthetics-prod.communication.azure.com",
"ResultType": "Succeeded",
"ResultSignature": "202",
"DurationMs": "82",
"CallerIpAddress": "40.88.50.228",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"ServerCallId": "aHR0cHM6Ly9hcGkuZmxpZ2h0cHJveHkuc2t5cGUuY29tL2FwaS92Mi9jcC9jb252LXVzZWEyLTAxLmNvbnYuc2t5cGUuY29tL2NvbnYvZzRoWlVoS1ZEVUtma19HenRDZ1JTQT9pPTEyJmU9NjM4MjA1NDc4MDg5MzEzMjIz",
"SdkVersion": "",
"SdkType": "unknown",
"SubOperationName": "File",
"OperationId": "5fab0875-3211-4879-8051-c688d0854c4d",
}
Çağrı Otomasyonu medya özet günlükleri
| Özellik | Açıklama |
|---|---|
TimeGenerated |
Olayın zaman damgası (UTC). |
level |
Olayın önem düzeyi. , , WarningErrorveya CriticalolmalıdırInformational. |
resourceId |
Olayı gösteren kaynağın kimliği. |
durationMs |
İşlemin milisaniye cinsinden süresi. |
callerIpAddress |
|
correlationId |
Skype zincir kimliği. |
operationName |
Bu olayın temsil ettiği işlemin adı. |
operationVersion |
|
resultType |
Etkinliğin durumu. Tipik değerler , Canceledve Faileddeğerlerini içerirCompleted. |
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. |
operationId |
Zaman uyumsuz olayları ilişkilendirmek için kullanılan işlem kimliği. |
recognizePromptSubOperationName |
İşlemin alt türü. Olası değerler , TextToSpeechve SSMLdeğerlerini içerirFile. |
playInLoop |
True yürütme işlemi için döngü istendiyse. False aksi takdirde. |
playToParticipant |
True yürütme işleminin bir hedefi varsa. False bu bir play-to-all işlemiyse. |
interrupted |
True istem kesintiye uğrarsa. False aksi takdirde. |
resultCode |
İşlemin sonuç kodu. |
resultSubcode |
İşlemin sonuç alt kodu. |
resultMessage |
İşlemin sonuç iletisi. |
Çağrı Otomasyonu medya özet günlüğü örneği aşağıda verilmişti:
[
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "d149d528-a392-404c-8fcd-69087e9d0802",
"ResultType": "Completed",
"OperationName": "Play",
"OperationId": "7bef24d5-eb95-4ee6-bbab-0b7d45d91288",
"PlayInLoop": "FALSE",
"PlayToParticipant": "TRUE",
"PlayInterrupted": "FALSE",
"RecognizePromptSubOperationName": "",
"ResultCode": "200",
"ResultSubcode": "0",
"ResultMessage": "Action completed successfully."
}
Sonraki adımlar
- Çağrı Otomasyonu günlüklerini ve ölçümlerini izlemek için içgörü panosu hakkında bilgi edinin.