Eksportowanie

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Usługa App Center umożliwia ciągłe eksportowanie wszystkich danych pierwotnych analizy na platformę Azure. Dane usługi Analytics można wyeksportować zarówno do usługi Blob Storage, jak i usługi Application Insights (Azure Monitor). Eksportując dane, możesz skorzystać z następujących korzyści:

• Nieograniczone przechowywanie danych
• Szczegółowa analiza użycia
• Ujednolicony pulpit nawigacyjny
• Dodatkowe zaawansowane funkcje usługi Application Insights, takie jak lejki, przechowywanie

Usługa App Center stale eksportuje dane analizy do usługi Application Insights od momentu skonfigurowania eksportu wraz z dwoma dniami wypełnionych danych. Dzięki nowemu zaktualizowanemu pulpitowi nawigacyjnemu w usłudze Application Insights użytkownicy usługi App Center mogą uzyskać ujednolicony widok analizy aplikacji i zaplecza na jednym pulpicie nawigacyjnym.

Usługa App Center stale eksportuje dane analizy do usługi Blob Storage od momentu skonfigurowania eksportu wraz z 28-dniowymi wypełnionymi danymi. Dowiedz się więcej o usłudze Blob Storage

Możesz również wyeksportować dane do obiektu blob usługi Azure Ogólnego przeznaczenia w wersji 2. Konta magazynu ogólnego przeznaczenia w wersji 2 obsługują najnowsze funkcje usługi Azure Storage i obejmują wszystkie funkcje kont ogólnego przeznaczenia w wersji 1 i usługi Blob Storage.

Dowiedz się więcej o usłudze Ogólnego przeznaczenia Storage w wersji 2 Dowiedz sięwięcej o usłudze Application Insights

Azure Blob Storage

Azure Blob Storage to usługa do przechowywania dużych ilości danych obiektów bez struktury, takich jak dane tekstowe lub binarne, dostępne na całym świecie za pośrednictwem protokołu HTTP lub HTTPS. Usługa Blob Storage umożliwia publiczne uwidocznienie danych lub przechowywanie danych prywatnie.

Dane są eksportowane co minutę, a nowy podfolder jest tworzony za każdym razem. Dane są przechowywane w formacie rok/miesiąc/dzień/godzina/minuta (na przykład https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data) domyślnie, gdy blob_path_format_kind parametr ma wartość WithoutAppId. config Gdy właściwość jest ustawiona na WithAppIdwartość , dane są przechowywane w formacie appId/year/month/day/hour/minute, który prefiksuje domyślną ścieżkę za pomocą identyfikatora appID. Dane będą wyświetlane w Azure Blob Storage do 5 minut.

Dane są podzielone na dane "Analiza" (sesje, zdarzenia), "Awarie", "Błędy" i "Załączniki". Dowiedz się więcej o eksportowaniu danych diagnostycznych

Zawartość pliku obiektu blob jest tablicą JSON dzienników urządzeń klienckich, która wygląda następująco w przypadku danych usługi Analytics:

[
    {
        "AppId": "046d56b8-ea26-4653-97ba-12b8f99c3ef5",
        "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": "83a2daa9-e5b4-4082-ba4a-ce34b95ab859",
        "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"
    }
]

Azure Application Insights

Application Insights to usługa zarządzania wydajnością aplikacji (APM), która oferuje możliwości wykonywania zapytań, segmentacji, filtrowania i analizy użycia w danych zdarzeń centrum aplikacji. Dodając zestaw SDK centrum aplikacji do aplikacji i eksportując dane do zasobu usługi Application Insights typu app Center, uzyskasz dostęp do następujących funkcji:

• Analiza usługi Application Insights. Użyj zaawansowanego języka zapytań, aby analizować nieprzetworzone dane zdarzeń i tworzyć wizualizacje. Możesz wyeksportować wyniki zapytań do usługi Power BI lub programu Excel.
• Użytkownicy, sesje i zdarzenia. Dowiedz się, ile osób korzysta z każdej strony i funkcji aplikacji, a następnie segmentuj według kraju, przeglądarki lub innych właściwości, aby zrozumieć, dlaczego.
• Przepływy lejków i użytkowników. Dowiedz się, jak użytkownicy przechodzą przez aplikację. Zidentyfikuj wąskie gardła. Odkryj sposoby zwiększania współczynników konwersji i eliminowania bólu.
• Przechowywanie. Dowiedz się, ilu użytkowników powraca do korzystania z aplikacji. Dowiedz się, gdzie i dlaczego wypadają.
• Skoroszyty. Twórz interaktywne skoroszyty, które łączą wizualizacje analizy użycia, zapytania usługi Application Insights Analytics i tekst, aby udostępniać szczegółowe informacje zespołowi.

Pola centrum aplikacji są mapowane na format usługi Application Insights. Oto równoważność między zamapowanych pól:

Application Insights	App Center
sygnatura czasowa	Czas zdarzenia
name	Nazwa zdarzenia niestandardowego lub typu danych
customDimensions	Obejmuje to kilka pól przedstawionych w poniższej tabeli
Session_id	Unikatowy identyfikator sesji
User_id	Identyfikator instalacji
application_Version	Wersja aplikacji
client_Type, client_Model	Model urządzenia
client_OS	Typ i wersja systemu operacyjnego
sdkVersion	Wersja zestawu SDK usługi App Center

W poniższej tabeli przedstawiono mapowanie pól dla pola "customDimensions".

Application Insights	App Center
AppBuild	Numer kompilacji aplikacji
AppId	Identyfikator aplikacji usługi App Center
AppNamespace	Przestrzeń nazw aplikacji
CarrierCountry	Kraj przewoźnika
Nazwa operatora	Typ operatora
EventId	Identyfikator zdarzenia centrum aplikacji
IngressTimestamp	Sygnatura czasowa pozyskiwania dzienników
Regionalne	Język urządzenia
MessageType	Typ zdarzenia (sesja, zdarzenie, ...)
OsApiLevel	Poziom interfejsu API systemu operacyjnego
OsBuild	Numer kompilacji systemu operacyjnego
OsName	Nazwa systemu operacyjnego
OsVersion	Wersja systemu operacyjnego
Właściwości	Właściwości dołączone do zdarzenia niestandardowego
Rozmiar ekranu	Rozmiar ekranu urządzenia
Nazwa zestawu SDK	Nazwa zestawu SDK centrum aplikacji
SdkVersion	Wersja zestawu SDK usługi App Center
TimeZoneOffset	Przesunięcie strefy czasowej
UserId	Niestandardowy identyfikator użytkownika (zestaw deweloperów)
WrapperRuntimeVersion	Wersja środowiska uruchomieniowego otoki zestawu SDK usługi App Center
WrapperSdkName	Nazwa otoki zestawu SDK usługi App Center
WrapperSdkVersion	Wersja otoki zestawu SDK usługi App Center

Przykładowe zapytanie sztucznej inteligencji służące do pobierania zdarzeń niestandardowych:

customEvents
    | where name == "YourEventName"
    | extend Properties = todynamic(tostring(customDimensions.Properties))
    | extend YourPropertyName = Properties.YourPropertyName

Więcej informacji o usłudze Application Insights i Centrum aplikacji:

• Ogólne informacje o usłudze Application Insights
• Dowiedz się więcej o integracji z usługą App Center na blogu dotyczącym sztucznej inteligencji
• Dowiedz się więcej o lepszych decyzjach dzięki lepszej analizie na blogu usługi App Center

Wymagania wstępne

Aby korzystać z funkcji Eksportuj, musisz mieć subskrypcję platformy Azure; Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure .

Łączenie subskrypcji platformy Azure

Uwaga

Ten krok jest wymagany tylko w przypadku eksportu w warstwie Standardowa; Eksport niestandardowy nie wymaga subskrypcji platformy Azure.

Standardowy eksport danych aplikacji usługi App Center na platformę Azure wymaga subskrypcji platformy Azure połączonej z aplikacją App Center. Dodanie subskrypcji i połączenie jej z aplikacją musi zostać wykonane przez właściciela aplikacji (jeśli aplikacja nie należy do organizacji) lub przez administratora organizacji.

Dodawanie subskrypcji platformy Azure

• Aplikacja należąca do organizacji: Jeśli jesteś administratorem organizacji, przejdź do sekcji Zarządzanie w organizacji, do której należy aplikacja.
• Aplikacja należąca do użytkownika: Jeśli jesteś właścicielem aplikacji, wykonaj następujące kroki.

1. Zaloguj się do portalu Centrum aplikacji.
2. Przejdź do ustawień użytkownika.
3. W obszarze Azure kliknij pozycję Dodaj subskrypcję
4. Wybierz istniejącą subskrypcję platformy Azure lub utwórz nową.

Łączenie aplikacji z subskrypcją platformy Azure

Po dodaniu subskrypcji platformy Azure do konta użytkownika lub organizacji należy zapewnić aplikacjom dostęp, aby subskrypcja mogła być używana w ramach tej aplikacji. W ten sposób zezwalasz dowolnemu menedżerowi/deweloperowi w tej aplikacji na korzystanie z subskrypcji na potrzeby eksportowania. Ma to skojarzony koszt związany z subskrypcją platformy Azure.

Konfigurowanie eksportu

1. W portalu Centrum aplikacji wybierz aplikację.
2. Przejdź do obszaru Ustawienia aplikacji.
3. Kliknij pozycję Eksportuj i wybierz opcję Nowy eksport .
4. Wybierz magazyn obiektów blob lub usługę Application Insights w zależności od potrzeb aplikacji.
5. Wybierz żądany typ konfiguracji (standardowa a niestandardowa).

Usługa App Center oferuje dwa sposoby eksportowania danych: eksport standardowy i eksport niestandardowy. Eksport w warstwie Standardowa umożliwia eksportowanie danych za pomocą środowiska jednym kliknięciem przy użyciu subskrypcji platformy Azure połączonej z aplikacją. Eksport niestandardowy zapewni większą elastyczność, a konfiguracje zostaną dostosowane na platformie Azure.

Eksport w warstwie Standardowa

Eksportowanie w warstwie Standardowa zapewnia jednokrotne środowisko eksportowania danych. Dzięki tej opcji wszystkie wymagane zasoby są tworzone automatycznie na platformie Azure.

Eksport niestandardowy

Eksport niestandardowy umożliwia użytkownikom dostosowywanie konfiguracji eksportu na platformie Azure.

W przypadku usługi Blob Storage

1. Zaloguj się w witrynie Azure Portal.
2. Kliknij pozycję Utwórz nowy zasób
3. Wyszukaj pozycję Konto magazynu w obszarze Wyszukaj w witrynie Marketplace.
4. Kliknij pozycję Utwórz. Spowoduje to otwarcie strony Tworzenie konta magazynu.
5. Wybierz subskrypcję platformy Azure.
6. Wybierz istniejącą grupę zasobów lub utwórz nową. (Grupa zasobów to kontener, który zawiera powiązane zasoby dla rozwiązania platformy Azure)
7. W obszarze Rodzaje kont zostanie wyświetlona następująca lista rozwijana. Obsługiwane są trzy opcje. Wybierz, co jest odpowiednie dla Ciebie.
8. Kliknij pozycję Przejrzyj i utwórz
9. Po pomyślnym zakończeniu walidacji
10. Kliknij pozycję Utwórz
11. Po pomyślnych wdrożeniach przejdź do zasobu
12. Lokalizowanie kluczy dostępu na karcie Ustawienia
13. Skopiuj parametry połączenia i dodaj ją do niestandardowych konfiguracji usługi App Center.

W przypadku usługi Application Insights

1. Zaloguj się w witrynie Azure Portal.
2. Wybierz pozycję Utwórz zasób Narzędzia > do zarządzania zasobami > Application Insights.
3. Zostanie wyświetlone pole konfiguracji
4. Ustaw wartość Typ aplikacji na aplikację Centrum aplikacji.
5. Skopiuj klucz instrumentacji z Azure Portal i dodaj go do niestandardowych konfiguracji usługi App Center. Klucz instrumentacji znajduje się na stronie Przegląd w zasobie usługi Application Insights.

Aby uzyskać więcej informacji na temat eksportowania, zapoznaj się z przewodnikiem Szybki start usługi Application Insights.

Eksportowanie wielu aplikacji do tego samego konta magazynu

Podczas konfigurowania eksportu dla wielu aplikacji należy utworzyć lub zaktualizować konfigurację blob_path_format_kind przy użyciu (części ExportBlobConfiguration modelu) ustawionej na WithAppId, która prefiksuje ścieżkę eksportu z odpowiednimi identyfikatorami appID.

Ścieżka do obiektu blob jest formatowana w następujący sposób:

• gdy wyliczenie jest ustawione na WithoutAppId=falseyear/month/day/hour/minute
• gdy wyliczenie jest ustawione na WithAppId=trueappId/year/month/day/hour/minute

Interfejs API tworzenia konfiguracji eksportu został opisany powyżej. W przypadku istniejących konfiguracji oto interfejs API częściowej aktualizacji:

PATCH /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}

Propagacja zmian potrwa od 5 do 10 minut, a jednostki od tego momentu zostaną zapisane przy użyciu nowego formatu ścieżki.

Rezygnacja z wypełniania wstecznego

Domyślnie nowa konfiguracja eksportu będzie wypełniać dane z ostatnich dwóch dni dla zasobów sztucznej inteligencji i 30 dni dla magazynu obiektów blob. Istnieją scenariusze, w których wypełnienie wsteczne nie jest konieczne; na przykład jeśli to zrobi, spowoduje zastąpienie lub zduplikowanie danych. W takim przypadku ustaw backfill właściwość na false wartość podczas tworzenia nowej konfiguracji.

Wybieranie rodzaju danych do wyeksportowania

Domyślnie nowa konfiguracja eksportu eksportuje tylko dane analizy (zdarzenia, sesje itd.) Dane diagnostyczne mogą być eksportowane przez ustawienie Entities właściwości (export_entity modelu) do kombinacji errors, crashesi attachments. Właściwość umożliwia również wykluczanie danych usługi Analytics z eksportowania przez dodanie no_logs wartości do tablicy Entities .

Mechanizm automatycznego wyłączania

Usługa App Center może automatycznie wyłączyć nieprawidłową konfigurację eksportu, aby zapobiec ewentualnym opóźnieniom w całym potoku eksportu. Na przykład usługa App Center obsługuje poniższe błędy z platformy Azure.

• Klucz instrumentacji usługi Application Insights jest nieprawidłowy.
• Nie można uwierzytelnić zasobu obiektu blob lub nie można rozpoznać nazwy zdalnej.

Uwaga

Jeśli eksport zostanie ponownie włączony, przepływ danych będzie kontynuowany od tego momentu bez wypełniania kopii zapasowej, aby uniknąć ewentualnego zastąpienia lub duplikowania danych. Jeśli musisz wypełnić brakujące dane, musisz ponownie utworzyć konfigurację eksportu. Dane przechodzące do usługi Application Insights pozostają po 48 godzinach i 30 dniach w usłudze Blob Storage.

Aby sprawdzić stan w celu wykonania akcji przywracania, możesz użyć jednego z następujących interfejsów API.

GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations
GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}

Aby włączyć konfigurację eksportu, możesz użyć następującego interfejsu API

POST /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}/enable

Cennik

Aby skonfigurować eksportowanie, musisz utworzyć subskrypcję platformy Azure. Eksportowanie danych ma skojarzony koszt, który będzie zależeć od usługi platformy Azure, do której eksportujesz. Szczegółowe informacje na temat cen poszczególnych usług można znaleźć na stronie:

Cennik usługi Application Insights

Cennik usługi Blob Storage