Azure İletişim Hizmetleri'de sorun giderme

  • Makale

Bu makale, Azure İletişim Hizmetleri çözümünüzde karşılaşabileceğiniz sorunları gidermenize yardımcı olur. SMS sorunlarını gideriyorsanız, SMS teslim ayrıntılarını yakalamak için Azure Event Grid ile teslim bildirimini etkinleştirebilirsiniz.

Azure İletişim Hizmetleri sistem durumunu denetleme

Azure İletişim Hizmetleri çözümünüzün durumunu Azure Hizmet Durumu portalında görüntüleyebilirsiniz. Azure İletişim Hizmetleri çözümünüzle ilgili sorunlarla karşılaşırsanız, önce Hizmet Durumu portalını denetleyin. Ardından, destek çağırmadan veya sorun gidermeye zaman harcamadan önce, devam eden bir çözümle ilgili bilinen bir sorun olup olmadığını belirleyebilirsiniz.

Azure Hizmet Durumu portalı , kullandığınız Azure hizmetlerinin ve bölgelerinin durumunun kişiselleştirilmiş bir görünümünü sağlar. Hizmet Durumu portalı kesintileri, planlı bakım etkinliklerini ve diğer sistem durumu önerilerini aramak için en iyi yerdir. Oturum açtığınızda, kimliği doğrulanmış Hizmet Durumu deneyimi şu anda hangi hizmetleri ve kaynakları kullandığınızı bilir.

Hizmet Durumu'nı kullanmanın en iyi yolu, tercih ettiğiniz iletişim kanalı aracılığıyla sizi bilgilendirmek için Hizmet Durumu uyarıları ayarlamaktır. Hizmet sorunları, planlı bakım veya Azure hizmetlerinizi ve bölgelerinizi etkileyen diğer değişiklikler için bildirimler alırsınız.

Hizmet Durumu Portalınızda oturum açamıyorsanız, bilinen sorunları denetlemek için genel kullanıma yönelik Azure Durumu sayfasını kullanabilirsiniz. Azure durumuna genel bakış, Azure durumundan Azure hizmetlerinin ve bölgelerinin genel görünümünü sağlar.

Durum sayfası, yaygın olaylar için iyi bir başvurudur. Azure olayları ve bakımı hakkında bilgi sahibi olmak için geçerli Azure kullanıcılarının kimliği doğrulanmış Azure Hizmet Durumu portalını görüntülemelerini öneririz. Kimliği doğrulanmış Azure Hizmet Durumu deneyimi, şu anda hangi hizmetleri ve kaynakları kullandığınızı bilir.

Azure İletişim Hizmetleri hizmet düzeyi sözleşmesinde (SLA) kullanılan ölçümleri etkileyen bir kesinti olduğunda, hizmet Azure Hizmet Durumu portalınızda ve Azure Durumu'nda bir bildirim oluşturur. Azure İletişim Hizmetleri SLA hakkında daha fazla bilgi için bkz. Hizmet Düzeyi Sözleşmeleri.

Genellikle, Azure İletişim Hizmetleri API'leri sürekli bir süre için alınan API çağrılarının %3'ünden fazlası için yeniden denenemeyen hatalar döndürdüğünde bir kesinti oluşur.

Olağanüstü durum kurtarma planı ve yüksek kullanılabilirlik stratejisi uygulamayı öğrenmenizi öneririz. Daha fazla bilgi için bkz . Azure uygulamaları için olağanüstü durum kurtarma ve yüksek kullanılabilirlik.

Yardım alın

Geliştiricilerin soru göndermesini, özellik önermesini ve sorunları sorun olarak bildirmesini öneririz. Daha fazla bilgi için ayrılmış destek ve yardım seçenekleri sayfasına bakın.

Bazı sorunları gidermenize yardımcı olması için aşağıdaki bilgi parçalarından birine veya daha fazlasına ihtiyacınız olabilir:

  • MS-CV Kimliği: Arama ve ileti sorunlarını giderme.
  • Arama Kimliği: Azure İletişim Hizmetleri çağrıları tanımlayın.
  • SMS ileti kimliği: SMS iletilerini tanımlama.
  • Kısa kod programı kısa kimliği: Kısa bir kod programı kısa uygulamasını belirleyin.
  • Ücretsiz doğrulama kampanyası kısa kimliği: Ücretsiz doğrulama kampanyası kısa uygulamasını belirleyin.
  • E-posta iletisi kimliği: E-posta Gönder isteklerini belirleyin.
  • Bağıntı Kimliği: Çağrı Otomasyonu kullanılarak yapılan istekleri tanımlayın.
  • Arama günlükleri: Arama ve ağ sorunlarını gidermek için ayrıntılı bilgileri kullanın.

Azaltma ve sınırlamalar hakkında daha fazla bilgi için bkz . Hizmet sınırları.

MS-CV kimliğinize erişme

SDK'larınızı başlatırken nesne örneğinde clientOptions tanılamaları yapılandırarak MS-CV kimliğine erişebilirsiniz. Sohbet, Kimlik ve VoIP çağrısı dahil olmak üzere tüm Azure SDK'ları için tanılama yapılandırabilirsiniz.

İstemci seçenekleri örneği

Aşağıdaki kod parçacıkları tanılama yapılandırmasını gösterir. SDK'lar için tanılamayı etkinleştirdiğinizde, yapılandırılan olay dinleyicisine tanılama ayrıntıları gönderilir.

// 1. Import Azure.Core.Diagnostics
using Azure.Core.Diagnostics;

// 2. Initialize an event source listener instance
using var listener = AzureEventSourceListener.CreateConsoleLogger();
Uri endpoint = new Uri("https://<RESOURCE-NAME>.communication.azure.net");
var (token, communicationUser) = await GetCommunicationUserAndToken();
CommunicationUserCredential communicationUserCredential = new CommunicationUserCredential(token);

// 3. Setup diagnostic settings
var clientOptions = new ChatClientOptions()
{
    Diagnostics =
    {
        LoggedHeaderNames = { "*" },
        LoggedQueryParameters = { "*" },
        IsLoggingContentEnabled = true,
    }
};

// 4. Initialize the ChatClient instance with the clientOptions
ChatClient chatClient = new ChatClient(endpoint, communicationUserCredential, clientOptions);
ChatThreadClient chatThreadClient = await chatClient.CreateChatThreadAsync("Thread Topic", new[] { new ChatThreadMember(communicationUser) });

Çağrı Otomasyonu için erişim kimliklerini kullanma

Çağrı Yönetimi veya kayıt sorunları gibi Çağrı Otomasyonu SDK'sıyla ilgili sorunları giderdiğinizde, başarısız aramayı veya işlemi tanımlamaya yardımcı olan kimlikleri toplamanız gerekir. Aşağıdaki iki kimliklerden birini sağlayabilirsiniz:

  • API yanıtının üst bilgisinden. alanını X-Ms-Skype-Chain-Idbulun.

    X-Ms-Skype-Chain-Id ile yanıt üst bilgisini gösteren ekran görüntüsü.

  • Uygulamanızın bir eylem çalıştırdıktan sonra aldığı geri çağırma olaylarından. Örneğin, bağıntı kimliğini bulmak için veya PlayFailed kullanınCallConnected.

    Bağıntı kimliğiyle bağlantı kesilen bir çağrı olayını gösteren ekran görüntüsü .

Bu kimliklerden birine ek olarak, başarısız kullanım örneği ve hatanın oluştuğu zaman damgası hakkında ayrıntılar sağlamanız gerekir.

İstemci arama kimliğinize erişme

Sesli veya görüntülü arama sorunlarını giderirken bir call IDsağlamanız gerekebilir. Nesnenin id özelliği aracılığıyla bu değere erişin call .

// `call` is an instance of a call created by `callAgent.startCall` or `callAgent.join` methods
console.log(call.id)

SMS ileti kimliğinize erişme

SMS sorunları için, yanıt nesnesinden ileti kimliğini toplayabilirsiniz.

// Instantiate the SMS client
const smsClient = new SmsClient(connectionString);
async function main() {
  const result = await smsClient.send({
    from: "+18445792722",
    to: ["+1972xxxxxxx"],
    message: "Hello World 👋🏻 via Sms"
  }, {
    enableDeliveryReport: true // Optional parameter
  });
console.log(result); // your message ID is in the result
}

Kısa kod programı kısa kimliğinize erişme

Programın kısa kimliğini Azure portalında Kısa Kodlar bölümünde bulabilirsiniz.

Kısa kod programı kısa kimliğini gösteren ekran görüntüsü.

Ücretsiz doğrulama kampanyası kısa kimliğinize erişin

Program kısa kimliğini Azure portalında Mevzuat Belgeleri bölümünde bulabilirsiniz.

Ücretsiz doğrulama kampanyası kısa kimliğini gösteren ekran görüntüsü.

E-posta işlem kimliğinize erişme

E-posta gönderme durumu veya e-posta iletisi durum istekleriyle ilgili sorunları giderirken bir işlem kimliği sağlamanız gerekebilir. Yanıtta bu değere erişebilirsiniz.

var emailSendOperation = await emailClient.SendAsync(
    wait: WaitUntil.Completed,
    senderAddress: sender,
    recipientAddress: recipient,
    subject: subject,
    htmlContent: htmlContent);

/// Get the OperationId so that it can be used for tracking the message for troubleshooting
Console.WriteLine($"Email operation id = {emailSendOperation.Id}");

Arama SDK'sında destek dosyalarına erişme

Çağırma SDK'sı günlük dosyalarına erişmek için kullanışlı yöntemler sağlar. Bu dosyalar Microsoft destek uzmanlarına ve mühendislerine yardımcı olabilir. Bir sorun algıladığınızda bu günlükleri toplamanızı öneririz.

Arama günlüklerini etkinleştirme ve günlüklere erişme

Arama günlüklerini etkinleştirmeyi ve bu günlüklere erişmeyi öğrenin.

JavaScript

Günlük kaydını denetlemek için, Çağırma SDK'sı dahili olarak @azure/günlükçü kitaplığına dayanır.

Günlük çıkış düzeyini yapılandırmak için paketten setLogLevel@azure/logger yöntemini kullanın. Bir günlükçü oluşturun ve oluşturucuya CallClient geçirin.

import { setLogLevel, createClientLogger, AzureLogger } from '@azure/logger';
setLogLevel('verbose');
let logger = createClientLogger('ACS');
const callClient = new CallClient({ logger });

yöntemini geçersiz kılarak Azure SDK'larından günlük çıkışını yeniden yönlendirmek AzureLogger.log için kullanabilirsinizAzureLogger.

Tarayıcı konsolunda, dosyada veya arabellekte oturum açabilirsiniz. Kendi hizmetinize de gönderebilirsiniz. Ağ üzerinden günlükleri kendi hizmetinize gönderecekseniz, bu yöntem tarayıcı performansını olumsuz etkilediğinden günlük satırı başına istek göndermeyin. Bunun yerine, günlük satırlarını biriktirin ve toplu olarak gönderin.

// Redirect log output
AzureLogger.log = (...args) => {
    // To console, file, buffer, REST API, etc...
    console.log(...args); 
};

Yerel SDK (Android/iOS)

Android, iOS ve Windows için Azure İletişim Hizmetleri Arama SDK'sı günlük dosyalarına erişim sağlar.

Yerel SDK'ları Çağırmak için Günlük dosyası erişim öğreticisine bakın.

UI Kitaplıkları (Android, iOS)

Android veya iOS için Azure İletişim Hizmetleri KULLANıCı Arabirimi Kitaplıklarını kullanıyorsanız, yerleşik destek formu aracılığıyla kullanıcı geri bildiriminde bulunabilirsiniz.

Arama kullanıcı arabirimi destek formunun destek işlevleri hakkında daha fazla bilgi için Destek formu tümleştirme öğreticisine bakın. Bu makalede, gerekli olay işleyicisinin nasıl ekleneceği ve destek bilgilerinin merkezi olarak depolanması için temel bir istemci/sunucu uygulamasının nasıl oluşturulacağı gösterilmektedir. Bu makalede, kuruluşunuzun kullandığı destek hizmetleriyle tümleştirme yolu açıklanmaktadır.

ACS tümleştirmelerinizde uçtan uca destek akışları oluşturma

İster Arama SDK'sını ister Arama KULLANıCı Arabirimi SDK'sını kullanın, müşterilerinize destek sağlamak tüm güçlü tümleştirmelerin önemli bir bileşenidir.

Kullanıcı desteği sağlama makalesi, destek geri bildirim döngüsünün her noktasında dikkat edilmesi gereken önemli noktaları vurgular ve daha fazla bilgi edinmek için atlama noktaları sağlar.

Microsoft Entra bilgilerini bulma

Microsoft Entra bilgilerini bulmak için aşağıdaki yordamları kullanın.

Dizin kimliği alma

Dizin (kiracı) kimliğinizi bulmak için şu adımları izleyin:

  1. Azure Portal’ında oturum açın.

  2. Hizmet menüsünde Microsoft Entra Id'yi seçin.

  3. Microsoft Entra Id'deki Genel Bakış sayfasında, dizin kimliğini (Kiracı Kimliği) kopyalayın ve uygulama kodunuzda depolayın.

    Microsoft Entra kiracı kimliğini kopyalamayı ve depolamayı gösteren ekran görüntüsü.

Uygulama kimliği alma

Uygulama kimliğinizi bulmak için şu adımları izleyin:

  1. Azure Portal’ında oturum açın.

  2. Hizmet menüsünde Microsoft Entra Id'yi seçin.

  3. Microsoft Entra Id'deki Uygulama kayıtları uygulamanızı seçin.

  4. Uygulama (istemci) kimliğini kopyalayın ve uygulama kodunuzda depolayın.

    Microsoft Entra uygulama kimliğini kopyalamayı ve depolamayı gösteren ekran görüntüsü.

    Dizin (kiracı) kimliğini uygulamanın Genel Bakış sayfasında da bulabilirsiniz.

Kullanıcı kimliği alma

Kullanıcı kimliğinizi bulmak için şu adımları izleyin:

  1. Azure Portal’ında oturum açın.

  2. Hizmet menüsünde Microsoft Entra Id'yi seçin.

  3. Microsoft Entra Id'deki Kullanıcılar'dan kullanıcınızı seçin.

  4. Microsoft Entra kullanıcılarının Profil sayfasında Nesne Kimliğini kopyalayın ve uygulama kodunuzda depolayın.

    Microsoft Entra kullanıcı kimliğini kopyalamayı ve depolamayı gösteren ekran görüntüsü.

Sabit kaynak kimliği alma

Bazen Azure İletişim Hizmetleri kaynağınızın sabit kaynak kimliğini de sağlamanız gerekir. Bulmak için şu adımları izleyin:

  1. Azure Portal’ında oturum açın.

  2. Azure İletişim Hizmetleri kaynağınızı açın.

  3. Hizmet menüsünde Genel Bakış'ı seçin ve JSON görünümüne geçin.

    Azure İletişim Hizmetleri bir kaynağa genel bakışı JSON görünümüne geçirmeyi gösteren ekran görüntüsü.

  4. Kaynak JSON sayfasında değeri kopyalayın immutableResourceId ve destek ekibinize sağlayın.

    Kaynak JSON sayfasını gösteren ekran görüntüsü.

Teams kullanıcıları için Azure İletişim Hizmetleri desteği kullanmak için Teams lisans uygunluğu doğrulama

Teams kullanıcıları için Azure İletişim Hizmetleri desteği kullanmak için Teams lisansınızın uygunluğunu doğrulamanın iki yolu vardır.

Teams web istemcisi aracılığıyla doğrulama

Teams web istemcisi aracılığıyla Teams lisans uygunluğunuzu doğrulamak için şu adımları izleyin:

  1. Tarayıcınızı açın ve Teams web istemcisine gidin.
  2. Geçerli bir Teams lisansına sahip kimlik bilgileriyle oturum açın.
  3. Kimlik doğrulaması başarılı olursa ve etki alanında kalırsanız https://teams.microsoft.com/ Teams lisansınız uygun olur. Kimlik doğrulaması başarısız olursa veya etki alanına yeniden yönlendirilirseniz https://teams.live.com/v2/ Teams lisansınız Teams kullanıcıları için Azure İletişim Hizmetleri desteği kullanmaya uygun değildir.

Microsoft Graph API'sini kullanarak geçerli Teams lisansınızı denetleme

geçerli Teams lisansınızı licenseDetails kullanarak bulabilirsiniz. Microsoft Graph API'si bir kullanıcıya atanan lisansları döndürür. Bir kullanıcıya atanan lisansları görüntülemek için Graph Explorer aracını kullanmak için bu adımları izleyin.

  1. Tarayıcınızı açın ve Grafik Gezgini'ne gidin.

  2. Kimlik bilgilerini kullanarak Graph Explorer'da oturum açın.

    Graph Explorer'da nasıl oturum açıldığını gösteren ekran görüntüsü.

  3. Sorgu kutusuna aşağıdaki API'yi girin ve Sorguyu Çalıştır'ı seçin.

    https://graph.microsoft.com/v1.0/me/licenseDetails

    Graph Explorer'da BIR API'nin nasıl girildiğini gösteren ekran görüntüsü.

    Veya aşağıdaki API'yi kullanarak kullanıcı kimliğini sağlayarak belirli bir kullanıcıyı sorgulayabilirsiniz:

    https://graph.microsoft.com/v1.0/users/{id}/licenseDetails

  4. Yanıt önizleme bölmesinde çıkış gösterilir.

    Burada gösterilen yanıt nesnesi okunabilirlik için kısaltılmış olabilir.

    {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/assignedLicenses",
    "value": [
        {
            "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968",
            "servicePlans":[
                {
                    "servicePlanId":"57ff2da0-773e-42df-b2af-ffb7a2317929",
                    "servicePlanName":"TEAMS1",
                    "provisioningStatus":"Success",
                    "appliesTo":"User"
                }
            ]
        }
    ]
}

  5. Özelliğin servicePlanName Uygun Teams Lisansları tablosundaki değerlerden birine sahip olduğu lisans ayrıntılarını bulun.

İlgili içerik