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 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 WithAppId
wartość , 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": "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 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
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 .
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.
- 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.
- Zaloguj się do portalu Centrum aplikacji.
- Przejdź do ustawień użytkownika.
- W obszarze Azure kliknij pozycję Dodaj subskrypcję
- Wybierz istniejącą subskrypcję platformy Azure lub utwórz nową.
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.
- W portalu Centrum aplikacji wybierz aplikację.
- Przejdź do obszaru Ustawienia aplikacji.
- Kliknij pozycję Eksportuj i wybierz opcję Nowy eksport .
- Wybierz magazyn obiektów blob lub usługę Application Insights w zależności od potrzeb aplikacji.
- 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.
Eksportowanie w warstwie Standardowa zapewnia jednokrotne środowisko eksportowania danych. Dzięki tej opcji wszystkie wymagane zasoby są tworzone automatycznie na platformie Azure.
Eksport niestandardowy umożliwia użytkownikom dostosowywanie konfiguracji eksportu na platformie Azure.
W przypadku usługi Blob Storage
- Zaloguj się w witrynie Azure Portal.
- Kliknij pozycję Utwórz nowy zasób
- Wyszukaj pozycję Konto magazynu w obszarze Wyszukaj w witrynie Marketplace.
- Kliknij pozycję Utwórz. Spowoduje to otwarcie strony Tworzenie konta magazynu.
- Wybierz subskrypcję platformy Azure.
- 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)
- W obszarze Rodzaje kont zostanie wyświetlona następująca lista rozwijana. Obsługiwane są trzy opcje. Wybierz, co jest odpowiednie dla Ciebie.
- Kliknij pozycję Przejrzyj i utwórz
- Po pomyślnym zakończeniu walidacji
- Kliknij pozycję Utwórz
- Po pomyślnych wdrożeniach przejdź do zasobu
- Lokalizowanie kluczy dostępu na karcie Ustawienia
- Skopiuj parametry połączenia i dodaj ją do niestandardowych konfiguracji usługi App Center.
W przypadku usługi Application Insights
- Zaloguj się w witrynie Azure Portal.
- Wybierz pozycję Utwórz zasób Narzędzia > do zarządzania zasobami > Application Insights.
- Zostanie wyświetlone pole konfiguracji
- Ustaw wartość Typ aplikacji na aplikację Centrum aplikacji.
- 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.
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=false
year/month/day/hour/minute
- gdy wyliczenie jest ustawione na
WithAppId=true
appId/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.
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.
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
, crashes
i attachments
. Właściwość umożliwia również wykluczanie danych usługi Analytics z eksportowania przez dodanie no_logs
wartości do tablicy Entities
.
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
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: