Экспорт
Важно!
Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.
Узнайте больше о сроках поддержки и альтернативных вариантах.
Центр приложений позволяет непрерывно экспортировать все необработанные данные аналитики в Azure. Данные аналитики можно экспортировать как в хранилище BLOB-объектов, так и в Application Insights (Azure Monitor). Экспортируя данные, вы получаете следующие преимущества:
- Неограниченное хранение данных
- Подробный анализ использования
- Унифицированная панель мониторинга
- Дополнительные функциональные возможности Application Insights, такие как воронки, хранение
Центр приложений постоянно экспортирует данные аналитики в Application Insights с момента настройки экспорта вместе с двумя днями обратно заполненных данных. Благодаря новой обновленной панели мониторинга в Application Insights пользователи Центра приложений могут получить единое представление аналитики приложений и серверной части на одной панели мониторинга.
Центр приложений постоянно экспортирует данные аналитики в хранилище BLOB-объектов с момента настройки экспорта вместе с 28-дневными резервными данными. Дополнительные сведения о хранилище BLOB-объектов
Вы также можете экспортировать данные в большой двоичный объект хранилища Azure общего назначения версии 2. Учетные записи хранения общего назначения версии 2 поддерживают последние возможности службы хранилища Azure и содержат все функции учетных записей общего назначения версии 1 и учетных записей хранилища BLOB-объектов.
Дополнительные сведения о хранилище общего назначения версии 2Подробнее о Application Insights
Хранилище BLOB-объектов Azure — это служба для хранения больших объемов неструктурированных данных объектов, таких как текстовые или двоичные данные, доступные по всему миру по протоколу HTTP или HTTPS. Хранилище BLOB-объектов можно использовать для предоставления данных в открытом доступе или для хранения данных в частном порядке.
Данные экспортируются каждую минуту, и каждый раз создается новая вложенная папка. Данные хранятся в формате год/месяц/день/час/минута (например, ) по умолчанию, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data
если blob_path_format_kind
для задано значение WithoutAppId
. Если свойству config
присвоено значение WithAppId
, данные хранятся в формате appId/год/месяц/день/час/минута , который префиксирует путь по умолчанию appID. Для отображения данных в Хранилище BLOB-объектов Azure потребуется до 5 минут.
Данные делятся на данные "Аналитика" (сеансы, события), "Сбои", "Ошибки" и "Вложения". Дополнительные сведения об экспорте данных диагностика
Содержимое файла BLOB-объекта представляет собой массив json журналов клиентских устройств, который выглядит следующим образом для данных Аналитики:
[
{
"AppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"Timestamp": "2017-12-09T04:02:53.618Z",
"InstallId": "e589a371-ea0c-4479-9a7b-9f834adec040",
"MessageType": "EventLog",
"IngressTimestamp": "2017-12-09T04:02:57.987Z",
"MessageId": "980e21a0-0cbb-48ac-8820-28acf4beb00d",
"EventId": "ad980536-e743-48a9-ab7e-cb043602d2c9",
"EventName": "log_out",
"CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"IsTestMessage": "False",
"SdkVersion": "1.0",
"Model": "PC",
"OemName": "Samsung",
"OsName": "Android",
"OsVersion": "8.1.0",
"OsApiLevel": "2",
"Locale": "EN",
"TimeZoneOffset": "PT2M",
"ScreenSize": "320x240",
"AppVersion": "1.1.0",
"AppBuild": "1",
"AppNamespace": "com.microsoft.test",
"CarrierName": "AT&T",
"CarrierCountry": "US",
"CountryCode": "US",
"WrapperSdkVersion": "1.0",
"WrapperSdkName": "mobilecenter.xamarin","Properties": "{\"extra_00\":\"5bcacf3598ca44ebbbc99e4488cfc854\",\"extra_01\":\"2673e48867c74d51af8dc24c762a8b28\",\"extra_02\":\"5b76c801e5074cd3a13ea37253b94484\",\"extra_03\":\"c1e76aa252c947d4b4bcd4d1d96a7be6\",\"extra_04\":\"caea50034c4f441a963700fa3cf70d03\"}",
"SessionId": "10df497a-4261-4995-b466-3fd77ac47395",
"SdkName": "mobilecenter.android",
"OsBuild": "2",
"WrapperRuntimeVersion": "None",
"LiveUpdateDeploymentKey": "stage",
"LiveUpdatePackageHash": "dsadsdasd3211321233",
"LiveUpdateReleaseLabel": "2.0"
}
]
Application Insights — это служба управления производительностью приложений (APM), которая предлагает возможности запросов, сегментации, фильтрации и аналитики использования для данных событий Центра приложений. Добавив пакет SDK центра приложений в приложение и экспортируя данные в ресурс Application Insights типа приложения Центра приложений, вы получите доступ к следующим функциям:
- Application Insights Analytics. Используйте мощный язык запросов для анализа необработанных данных о событиях и создания визуализаций. Результаты запросов можно экспортировать в Power BI или Excel.
- Пользователи, сеансы и события. Узнайте, сколько людей используют каждую страницу и функцию вашего приложения, а затем сегментируйте по стране, браузеру или другим свойствам, чтобы понять, почему.
- Воронки и потоки пользователей. Узнайте, как пользователи перемещаются по вашему приложению. Выявление узких мест. Найдите способы повышения коэффициента конверсии и устранения проблемных точек.
- Хранение. Узнайте, сколько пользователей возвращаются для использования вашего приложения. Узнайте, где и почему они бросают.
- Workbooks. Создавайте интерактивные книги, которые объединяют визуализации анализа использования, запросы Аналитики Application Insights и текст для обмена аналитическими сведениями в команде.
Поля Центра приложений сопоставляются в формате Application Insights. Ниже приведена эквивалентность сопоставленных полей:
Application Insights | Центр приложений |
---|---|
TIMESTAMP | Время события |
name | Имя настраиваемого события или типа данных |
customDimensions | Сюда входит несколько полей, показанных в таблице ниже |
session_Id | Уникальный идентификатор сеанса |
user_Id | Идентификатор установки |
application_Version | Версия приложения |
client_Type, client_Model | Модель устройства |
client_OS | Тип и версия ОС |
sdkVersion | Версия пакета SDK центра приложений |
В таблице ниже показано сопоставление полей для поля customDimensions.
Application Insights | Центр приложений |
---|---|
AppBuild | Номер сборки приложения |
AppId | Идентификатор приложения Центра приложений |
AppNamespace | Пространство имен приложения |
CarrierCountry | Страна оператора |
CarrierName | Тип носителя |
EventId | Идентификатор события Центра приложений |
IngressTimestamp | Метка времени приема журнала |
Locale | Язык устройства |
MessageType | Тип события (сеанс, событие, ...) |
OsApiLevel | Уровень API ОС |
OsBuild | Номер сборки ОС |
OsName | Имя ОС |
OsVersion | Версия ОС |
Свойства | Свойства, присоединенные к пользовательскому событию |
ScreenSize | Размер экрана устройства |
Имя пакета SDK | Имя пакета SDK центра приложений |
SdkVersion | Версия пакета SDK для Центра приложений |
TimeZoneOffset | Смещение часового пояса |
UserId | Пользовательский идентификатор пользователя (набор разработчика) |
ОболочкаRuntimeVersion | Версия среды выполнения оболочки пакета SDK для Центра приложений |
WrapperSdkName | Имя оболочки пакета SDK для Центра приложений |
WrapperSdkVersion | Версия оболочки пакета SDK для Центра приложений |
Пример запроса ИИ для получения пользовательских событий:
customEvents
| where name == "YourEventName"
| extend Properties = todynamic(tostring(customDimensions.Properties))
| extend YourPropertyName = Properties.YourPropertyName
Дополнительные сведения о Application Insights и Центре приложений:
- Общие сведения о Application Insights
- Блог об интеграции с Центром приложений на искусственном интеллекте
- Узнайте о том, как лучше принимать решения с помощью лучшей аналитики в блоге Центра приложений
Для использования экспорта у вас должна быть подписка Azure; Если у вас нет подписки Azure, создайте бесплатную учетную запись Azure , прежде чем начинать работу.
Примечание
Этот шаг необходим только для стандартного экспорта; Для пользовательского экспорта не требуется подписка Azure.
Для стандартного экспорта данных приложения в Azure в Центре приложений требуется подписка Azure, связанная с приложением Центра приложений. Добавление подписки и связывание ее с приложением должны выполняться владельцем приложения (если приложение не принадлежит организации) или администратором организации.
- Приложение, принадлежащее организации: Если вы являетесь администратором организации, перейдите в раздел Управление в организации, к которой принадлежит приложение.
- Приложение, принадлежащее пользователю: Если вы являетесь владельцем приложения, выполните следующие действия.
- Войдите на портал Центра приложений.
- Перейдите к параметрам пользователя.
- В разделе Azure щелкните Добавить подписку.
- Выберите существующую подписку Azure или создайте новую.
После добавления подписки Azure в учетную запись пользователя или организации необходимо предоставить приложениям доступ, чтобы подписка была использована в этом приложении. Таким образом вы разрешаете любому руководителю или разработчику в этом приложении использовать подписку для экспорта. Это связано с затратами, взимаемых с вашей подписки Azure.
- На портале Центра приложений выберите приложение.
- Перейдите в раздел Параметры приложения.
- Щелкните Экспорт и выберите параметр Создать экспорт .
- Выберите хранилище BLOB-объектов или Application Insights в зависимости от потребностей приложения.
- Выберите нужный тип конфигурации (стандартная и настраиваемая).
Центр приложений предлагает два способа экспорта данных: стандартный экспорт и пользовательский экспорт. Стандартный экспорт позволяет экспортировать данные одним щелчком, используя подписку Azure, связанную с приложением. Пользовательский экспорт обеспечит большую гибкость, а конфигурации будут настроены в Azure.
Стандартный экспорт предоставляет возможность экспорта данных одним щелчком мыши. При использовании этого параметра все необходимые ресурсы автоматически создаются в Azure.
Пользовательский экспорт позволяет пользователям настраивать конфигурацию экспорта в Azure.
Для хранилища BLOB-объектов
- Войдите на портал Azure.
- Нажмите кнопку Создать ресурс.
- Найдите учетную запись хранения в разделе Поиск в Marketplace.
- Нажмите кнопку Создать. Откроется страница Создание учетной записи хранения.
- Выберите подписку Azure.
- Выберите имеющуюся группу ресурсов или создайте новую. (Группа ресурсов — это контейнер, содержащий связанные ресурсы для решения Azure)
- В разделе Типы учетных записей вы увидите следующий раскрывающийся список. Поддерживаются три варианта. Выберите подходящий вариант.
- Щелкните Просмотр и создание.
- После прохождения проверки
- Нажмите Создать.
- После успешного развертывания перейдите к ресурсу.
- Найдите ключи доступа на вкладке "Параметры"
- Скопируйте строка подключения и добавьте его в пользовательские конфигурации Центра приложений.
Для Application Insights
- Войдите на портал Azure.
- Выберите Создать средства > управления ресурсами> Application Insights.
- Появится поле конфигурации
- Задайте для параметра Тип приложения значениеПриложение Центра приложений.
- Скопируйте ключ инструментирования из портал Azure и добавьте его в пользовательские конфигурации Центра приложений. Ключ инструментирования можно найти на странице Обзор в ресурсе Application Insights.
Дополнительные сведения об экспорте см. в кратком руководстве по Application Insights.
При настройке экспорта для нескольких приложений следует создать или обновить конфигурацию с blob_path_format_kind
параметром WithAppId
(часть ExportBlobConfiguration
модели) значением , которое префиксирует путь экспорта соответствующими идентификаторами appID.
Путь к большому двоичному объекту имеет следующий формат:
- если для перечисления задано значение
WithoutAppId=false
year/month/day/hour/minute
- если для перечисления задано значение
WithAppId=true
appId/year/month/day/hour/minute
API создания конфигурации экспорта был описан выше. Для существующих конфигураций ниже приведен API частичного обновления.
PATCH /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}
Распространение изменений займет 5–10 минут, а сущности с этого момента будут записаны с использованием нового формата пути.
По умолчанию новая конфигурация экспорта будет повторно заполнять два последних дня данных для ресурсов ИИ и 30 дней для хранилища BLOB-объектов. Существуют сценарии, когда обратная заполнение не требуется; Например, если это приведет к перезаписи или дублированию данных. В этом случае при создании новой конфигурации присвойте свойству значение backfill
false
.
По умолчанию новая конфигурация экспорта экспортирует только данные аналитики (события, сеансы и т. д.). Данные, связанные с диагностикой, можно экспортировать , задав Entities
для свойства (export_entity
model) сочетание errors
, crashes
и attachments
. Свойство также позволяет исключить данные аналитики из экспорта путем добавления no_logs
значения в Entities
массив.
Центр приложений может автоматически отключить недопустимую конфигурацию экспорта, чтобы предотвратить возможную задержку во всем конвейере экспорта. Например, Центр приложений обрабатывает приведенные ниже сбои из Azure.
- Недопустимый ключ инструментирования Application Insights.
- Ресурс BLOB-объекта не может пройти проверку подлинности или удаленное имя не может быть разрешено.
Примечание
Если экспорт повторно включен, поток данных будет продолжаться с этого момента без обратного заполнения, чтобы избежать возможного переопределения или дублирования данных. Если вам нужно вернуть отсутствующие данные, необходимо повторно создать конфигурацию экспорта. Данные, передаваемые в Application Insights, хранятся в Хранилище BLOB-объектов 48 часов и 30 дней.
Для проверка состояния для выполнения действий по восстановлению можно использовать один из следующих API.
GET /v0.1/apps/{owner_name}/{app_name}/export_configurations
GET /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}
Для включения конфигурации экспорта можно использовать следующий API.
POST /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}/enable
Чтобы настроить экспорт, необходимо создать подписку Azure. Экспорт данных связан с затратами, которые будут зависеть от службы Azure, в которую выполняется экспорт. Подробные сведения о ценах на каждую службу см. по адресу: