Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


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

Wizualizacja danych w Azure Blob Storage

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": "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"
    }
]

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:

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. Obsługiwane konta usługi Blob Storage
  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.

Dodawanie parametry połączenia w centrum aplikacji

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.

Dodawanie klucza instrumentacji w centrum aplikacji

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