Поделиться через

Устранение неполадок в Службах коммуникации Azure

В этой статье описаны проблемы, которые могут возникнуть в решении Службы коммуникации Azure. При устранении неполадок с SMS можно включить отчеты о доставке с помощью Azure Event Grid для сбора сведений о доставке SMS.

Проверка состояния работоспособности Службы коммуникации Azure

Вы можете просмотреть работоспособность решения Службы коммуникации Azure на портале Работоспособности служб Azure. Если у вас возникли проблемы с решением Службы коммуникации Azure, сначала проверьте портал работоспособности служб. Затем вы можете определить, существует ли известная проблема, для которой уже разрабатывается решение, прежде чем вызывать службу поддержки или тратить время на устранение неполадок.

Портал "Работоспособность служб Azure" предоставляет персонализированное представление о работоспособности служб Azure и регионов, которые вы используете. Портал состояния служб — это лучшее место для информации о сбоях, запланированных работах по обслуживанию и других рекомендациях по состоянию. После входа в систему опыт работоспособности службы для аутентифицированных пользователей знает, какие службы и ресурсы вы сейчас используете.

Лучший способ использования службы Service Health — это настроить оповещения Service Health, чтобы уведомлять вас через предпочитаемый канал связи. Вы получаете уведомления о проблемах службы, плановом обслуживании или других изменениях, влияющих на службы и регионы Azure.

Если вы не можете войти на портал работоспособности служб, вы можете использовать общедоступную страницу состояния Azure для проверки известных проблем. Обзор состояния Azure предоставляет глобальное представление служб Azure и регионов из состояния Azure.

Страница состояния является хорошим источником информации о масштабных инцидентах. Рекомендуется, чтобы текущие пользователи Azure просматривали портал работоспособности служб Azure, чтобы оставаться в курсе инцидентов и обслуживания Azure. Аутентифицированная функциональность Azure Service Health знает, какие службы и ресурсы вы используете в настоящее время.

Если Службы коммуникации Azure имеет сбой, который влияет на метрики, используемые в соглашении об уровне обслуживания (SLA), служба создает уведомление на портале работоспособности служб Azure и состоянии Azure. Дополнительные сведения о соглашении об уровне обслуживания Службы коммуникации Azure см. в соглашениях об уровне обслуживания.

Как правило, сбой возникает, когда любая API Служб связи Azure возвращает неустранимые ошибки более чем в 3% полученных вызовов API на протяжении продолжительного времени.

Мы рекомендуем узнать, как реализовать план аварийного восстановления и стратегию высокого уровня доступности. Дополнительные сведения см. в статье "Аварийное восстановление" и высокий уровень доступности для приложений Azure.

Получить помощь

Мы советуем разработчикам отправлять вопросы, предлагать функции и сообщать о проблемах. Дополнительные сведения см. на странице специальных параметров поддержки и справки.

Чтобы устранить некоторые проблемы, может потребоваться один или несколько следующих элементов информации:

  • ID MS-CV: устранение проблем с вызовами и сообщениями.
  • Идентификатор вызова: идентифицировать вызовы Службы коммуникации Azure.
  • Идентификатор SMS-сообщения: определение и распознавание SMS-сообщений.
  • Идентификатор краткого кода программы: определение краткого кода программы.
  • Краткий идентификатор кампании проверки бесплатной проверки: определение краткого приложения для бесплатной проверки.
  • Идентификатор сообщения электронной почты: определение запросов на отправку электронной почты .
  • Идентификатор корреляции. Определение коррелированных запросов, выполненных с помощью службы автоматизации вызовов.
  • Журналы вызовов: используйте подробные сведения для устранения проблем с вызовами и сетью.

Для получения дополнительной информации об ограничении скорости и лимитах, см. раздел "Лимиты службы".

Получите доступ к идентификатору MS-CV

Вы можете получить доступ к идентификатору MS-CV, настроив диагностику в экземпляре объекта clientOptions при инициализации ваших SDK. Вы можете настроить диагностику для любого пакета SDK Azure, включая чат, удостоверение и VoIP-звонки.

Пример параметров клиента

В указанных ниже фрагментах кода показана конфигурация диагностики. Если вы включаете диагностику для SDK, сведения о диагностике поступают к настроенному прослушивателю событий.

// 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) });

Использование идентификаторов доступа для автоматизации вызовов

При устранении неполадок с пакетом SDK службы автоматизации вызовов( например, проблемы с управлением вызовами или записью), необходимо собрать идентификаторы, которые помогают определить неудачный вызов или операцию. Вы можете указать один из следующих двух идентификаторов:

  • Из заголовка ответа API. Найдите поле X-Ms-Skype-Chain-Id.

    Снимок экрана: заголовок ответа с идентификатором X-Ms-Skype-Chain-Id.

  • Из событий обратного вызова, получаемых приложением после выполнения действия. Например, используйте CallConnected или PlayFailed найдите идентификатор корреляции.

    Снимок экрана: событие отключения вызова с идентификатором корреляции .

Помимо одного из этих идентификаторов, необходимо указать сведения о неудачном варианте использования и метке времени при возникновении сбоя.

Доступ к идентификатору вызова клиента

При устранении неполадок голосовых или видеозвонков вам может потребоваться предоставить call ID. К этому значению можно получить доступ через свойство id объекта call.

Внимание

A call ID является уникальным и идентифицирует конкретный вызов, call ID то же самое для всех участников этого вызова. call ID Начальное значение задается локальным клиентом, а затем может измениться после подключения локального клиента к вызову, который уже продолжается. Если локальный клиент первым инициировал вызов, call ID станет call ID, который сервер и другие участники вызова будут использовать в дальнейшем в вызове.

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

Получите доступ к вашему ID SMS-сообщений

При проблемах с SMS идентификатор сообщения можно получить из объекта ответа.

// 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
}

Получите доступ к вашему краткому идентификатору программы кода

Найдите краткий идентификатор программы в портал Azure в разделе "Короткие коды".

Снимок экрана, показывающий краткий идентификатор программы на коде.

Доступ к краткому идентификатору кампании проверки бесплатного доступа

Найдите краткий идентификатор программы в портал Azure в разделе "Нормативные документы".

Снимок экрана, показывающий краткий ID кампании по бесплатной проверке.

Доступ к идентификатору операции электронной почты

При устранении неполадок с состоянием отправки электронной почты или запросами на состояние сообщения электронной почты может потребоваться указать идентификатор операции. Вы можете получить доступ к этому значению в ответе.

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}");

Доступ к файлам поддержки в пакете SDK для вызовов

Пакет SDK для вызова предоставляет удобные методы для доступа к файлам журнала. Эти файлы могут помочь специалистам и инженерам службы поддержки Майкрософт. Мы рекомендуем собирать эти журналы при обнаружении проблемы.

Включение журналов вызовов и доступ к ним

Узнайте, как включить и получить доступ к журналам вызовов.

JavaScript

Журналы клиентов могут помочь при получении дополнительных сведений при отладке проблемы. Для сбора журналов клиентов можно использовать @azure/средство ведения журнала, которое используется внутренним пакетом SDK для вызовов WebJS.

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

// Redirect ACS Calling SDK's logs
AzureLogger.log = (...args) => {
    // To console, file, buffer, REST API, etc...
    console.log(...args); 
};

// Application logging
logger.info('....');

@azure/loger поддерживает четыре разных уровня журнала:

  • verbose
  • info
  • предупреждение
  • ошибка

Для отладки ведение журнала уровня info в большинстве случаев достаточно.

В среде браузера @azure/loger выводит журналы в консоль по умолчанию. Журналы можно перенаправлять, если переопределить метод AzureLogger.log. Дополнительные сведения см. в разделе @azure/logger.

Приложение может хранить журналы в памяти, если он имеет функцию скачивания файла журнала. Если это так, необходимо задать ограничение по размеру журнала. Отсутствие ограничения может привести к проблемам с памятью при длительных вызовах.

Кроме того, если вы отправляете журналы в удаленную службу, рассмотрите такие механизмы, как сжатие и планирование. Если у клиента недостаточно пропускной способности, отправка большого количества данных журнала в течение короткого периода времени может повлиять на качество вызова.

Собственный пакет SDK (Android/iOS)

Для Android, iOS и Windows пакет SDK для вызовов Службы коммуникации Azure предоставляет доступ к файлам журналов.

Для вызова родных SDK см. руководство по доступу к файлам журнала.

Библиотеки пользовательского интерфейса (Android, iOS)

Если вы используете библиотеки пользовательского интерфейса Службы коммуникации Azure для Android или iOS, вы можете запросить отзывы пользователей с помощью встроенной формы поддержки.

Дополнительные сведения о функциях поддержки в форме поддержки пользовательского интерфейса вызова см. в руководстве по интеграции формы поддержки. В этой статье показано, как добавить необходимый обработчик событий и создать базовую реализацию клиента или сервера для централизованного хранения сведений о поддержке. В этой статье описывается путь интеграции со службами поддержки, которые использует ваша организация.

Создание потоков поддержки от начала до конца в интеграциях ACS

Независимо от того, используете ли вы пакет SDK для вызовов или пакет SDK для пользовательского интерфейса для вызовов, предоставляя клиентам поддержку, является ключевым компонентом любой надежной интеграции.

В статье "Предоставление поддержки пользователей" рассматриваются ключевые аспекты каждого цикла отзывов о поддержке и предоставляются дополнительные сведения.

Поиск сведений о Microsoft Entra

Используйте следующие процедуры для поиска сведений о Microsoft Entra.

Получите идентификатор каталога

Чтобы найти идентификатор каталога (клиента), выполните следующие действия.

  1. Войдите на портал Azure.

  2. В меню службы выберите идентификатор Microsoft Entra.

  3. На странице Overview в Microsoft Entra ID скопируйте идентификатор каталога (Tenant ID) и сохраните его в коде приложения.

    Снимок экрана, на котором показано, как скопировать идентификатор клиента Microsoft Entra и сохранить его.

Получение идентификатора приложения

Чтобы найти идентификатор приложения, выполните следующие действия.

  1. Войдите на портал Azure.

  2. В меню службы выберите идентификатор Microsoft Entra.

  3. В Регистрация приложений в идентификаторе Microsoft Entra выберите приложение.

  4. Скопируйте идентификатор приложения (клиента) и сохраните его в коде приложения.

    Снимок экрана, на котором показано, как скопировать идентификатор приложения Microsoft Entra и сохранить его.

    Вы также можете найти идентификатор каталога (арендатора) на странице обзора приложения.

Получение идентификатора пользователя

Чтобы найти идентификатор пользователя, выполните следующие действия.

  1. Войдите на портал Azure.

  2. В меню службы выберите идентификатор Microsoft Entra.

  3. В разделе "Пользователи " в идентификаторе Microsoft Entra выберите пользователя.

  4. На странице профиля для пользователей Microsoft Entra скопируйте идентификатор объекта и сохраните его в коде приложения.

    Снимок экрана, на котором показано, как скопировать идентификатор пользователя Microsoft Entra и сохранить его.

Получение неизменяемого идентификатора ресурса

Иногда необходимо также указать неизменяемый идентификатор ресурса Службы коммуникации Azure. Чтобы найти его, выполните следующие действия.

  1. Войдите на портал Azure.

  2. Откройте ресурс Службы коммуникации Azure.

  3. В меню службы выберите Обзор и переключитесь на вид JSON.

    Снимок экрана, на котором показано, как переключить обзор ресурсов Службы коммуникации Azure в представление JSON.

  4. На странице Resource JSON скопируйте значение immutableResourceId, и предоставьте его группе поддержки.

    Снимок экрана: страница JSON ресурса.

Проверка соответствия лицензии Teams для использования поддержки пользователей Teams в Службе коммуникации Azure

Существует два способа проверить право на получение лицензии Teams для использования службы поддержки Azure Communication Services для пользователей Teams.

Проверка через веб-клиент Teams

Чтобы проверить соответствие лицензии Teams через веб-клиент Teams, выполните следующие действия.

  1. Откройте браузер и перейдите в веб-клиент Teams.
  2. Войдите с учетными данными, имеющими действительную лицензию Teams.
  3. Если проверка подлинности выполнена успешно и вы остаетесь в домене https://teams.microsoft.com/, ваша лицензия Teams действительна. Если проверка подлинности не удается или вас перенаправляют на домен https://teams.live.com/v2/, лицензия Teams не подходит для использования поддержкой Azure Communication Services для пользователей Teams.

Проверка текущей лицензии Teams с помощью API Microsoft Graph

Текущую лицензию Teams можно найти с помощью licenseDetails. API Microsoft Graph возвращает лицензии, назначенные пользователю. Выполните следующие действия, чтобы использовать средство обозревателя Graph для просмотра лицензий, назначенных пользователю.

  1. Откройте браузер и перейдите в обозреватель Graph.

  2. Войдите в обозреватель Graph с помощью учетных данных.

    Снимок экрана: вход в Graph Explorer.

  3. В поле запроса введите следующий API и выберите "Выполнить запрос".

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

    Снимок экрана, на котором показано, как ввести API в обозревателе Graph.

    Или вы можете запросить конкретного пользователя, предоставив идентификатор пользователя с помощью следующего API:

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

  4. В области предварительного просмотра ответа отображаются выходные данные.

    Объект ответа, показанный здесь, может быть сокращен для удобства.

    {
    "@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. Найдите сведения о лицензии, где свойство servicePlanName имеет одно из значений в таблице лицензий для команд, имеющих право .

Связанный контент

  • Last updated on