Exportálás

Fontos

A Visual Studio App Center 2025. március 31-én megszűnt, kivéve az Elemzési és diagnosztikai funkciókat, amelyek 2026. június 30-ig továbbra is támogatottak lesznek. Tudj meg többet.

Az App Center lehetővé teszi, hogy folyamatosan exportálja az Analytics nyers adatot az Azure-ba. Az Elemzési adatokat a Blob Storage-ba és az Application Insightsba (Azure Monitor) is exportálhatja. Az adatok exportálásával a következő előnyöket élvezheti:

• Korlátlan adatmegőrzés
• Részletes használati elemzés
• Egyesített irányítópult
• Az Application Insights további gazdag funkciói, például tölcsérek, adatmegőrzés

Az App Center folyamatosan exportálja az Elemzési adatokat az Application Insightsba attól a pillanattól kezdve, hogy konfigurálta az exportálást, valamint két napnyi háttérbe töltött adatot. Az Application Insights új frissített irányítópultjával az App Center felhasználói egységes nézetet kaphatnak az Application és a Backend Analytics szolgáltatásról egy irányítópulton.

Az App Center folyamatosan exportálja az Analytics-adatokat a Blob Storage-ba az exportálás konfigurálásának pillanatától kezdve, valamint a 28 napos háttérbe töltött adatokkal együtt. További információ a Blob Storage-ról

Adatokat exportálhat az Azure General Purpose v2 Storage Blobba is. Az általános célú v2-tárfiókok támogatják a legújabb Azure Storage-funkciókat, és tartalmazzák az általános célú v1- és Blob Storage-fiókok összes funkcióját.

További információ az Általános célú v2Storage-ról További információ az Application Insightsról

Azure Blob Storage

Az Azure Blob Storage egy olyan szolgáltatás, amely nagy mennyiségű strukturálatlan objektumadatokat, például szöveges vagy bináris adatokat tárol világszerte HTTP vagy HTTPS használatával. A Blob Storage használatával nyilvánosan közzéteheti az adatokat, vagy privát módon tárolhatja az adatokat.

A rendszer percenként exportálja az adatokat, és minden alkalommal létrehoz egy új almappát. Az adatok alapértelmezés szerint a év/hónap/nap/óra/perc formátumban tárolódnak (például https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data), amikor a blob_path_format_kindWithoutAppId értékére van beállítva. config A tulajdonság beállításakor WithAppId az adatok appId/év/hónap/nap/óra/perc formátumban tárolódnak, amely az alapértelmezett elérési út elé helyezi az appId-t. Az adatok az Azure Blob Storage-ban való megjelenítése akár 5 percet is igénybe vehet.

Az adatok "Elemzési" adatokra (munkamenetekre, eseményekre), "Összeomlásokra", "Hibákra" és "Mellékletekre" vannak osztva. További információ a diagnosztikai adatok exportálásáról

A blobfájl tartalma az ügyféleszköz-naplók JSON-tömbje, amely így néz ki az Analytics-adatok esetében:

[
    {
        "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

Az Application Insights egy alkalmazásteljesítmény-kezelési (APM) szolgáltatás, amely lekérdezési, szegmentálási, szűrési és használati elemzési képességeket kínál az App Center eseményadatain. Ha hozzáadja az App Center SDK-t az alkalmazáshoz, és az adatokat egy App Center alkalmazástípusú Application Insights-erőforrásba exportálja, a következő funkciókhoz férhet hozzá:

• Application Insights Analytics. Használjon hatékony lekérdezési nyelvet a nyers eseményadatok elemzéséhez és vizualizációk létrehozásához. A lekérdezések eredményeit exportálhatja a Power BI-ba vagy az Excelbe.
• Felhasználók, munkamenetek és események. Megtudhatja, hogy hányan használják az alkalmazás egyes lapját és funkcióit, majd ország, böngésző vagy egyéb tulajdonságok szerint szegmentáltak annak megértéséhez, hogy miért.
• Tölcsérek és felhasználói folyamatok. Ismerje meg, hogyan navigálhatnak a felhasználók az alkalmazásban. Azonosítsa a szűk keresztmetszeteket. Fedezze fel a konverziós sebesség növelésének és a fájdalompontok megszüntetésének módjait.
• Megőrzés. Megtudhatja, hogy hány felhasználó tér vissza az alkalmazás használatához. Megtudhatja, hogy hol és miért kerülnek ki.
• Munkafüzetek Olyan interaktív munkafüzeteket hozhat létre, amelyek használatelemzési vizualizációkat, Application Insights Analytics-lekérdezéseket és szöveget kombinálva osztanak meg elemzéseket a csapatán.

Az App Center mezői Application Insights formátumban vannak leképezve. Íme a megfeleltetett mezők közötti egyenértékűség:

Application Insights	App Center
timestamp	Az esemény időpontja
név	Az egyéni esemény vagy adattípus neve
egyéni méretek	Ez több mezőt is tartalmaz az alábbi táblázatban
munkamenet_azonosító	Egyedi munkamenet-azonosító
user_Id	Telepítési azonosító
alkalmazás_verziója	Az alkalmazás verziója
ügyfél_típus, ügyfél_model	Eszközmodell
kliens_operációs rendszer	Operációs rendszer típusa és verziója
SDK verzió	App Center SDK-verzió

Az alábbi táblázat a "customDimensions" mező mezőleképezését mutatja.

Application Insights	App Center
AppBuild	Alkalmazás buildszáma
AppId	App Center alkalmazásazonosító
AppNamespace	Alkalmazásnévtér
Szállítóország	Fuvarozó országa
Fuvarozó neve	Szállító típusa
EventId	Az App Center eseményazonosítója
BeérkezésiIdőbélyeg	Naplóbetöltés időbélyege
Helyszín	Eszköz nyelve
Üzenettípus	Esemény típusa (munkamenet, esemény, ...)
OsApiLevel	OPERÁCIÓS RENDSZER API-szintje
OsBuild	Operációs rendszer buildszáma
OsName	Operációs rendszer neve
OsVersion	Operációs rendszer verziója
Tulajdonságok	Egyéni eseményhez csatolt tulajdonságok
Képernyőméret	Az eszköz képernyőmérete
SdkName	App Center SDK neve
SDK verzió	App Center SDK-verzió
Időzóna-eltolás	Időzóna eltérése
UserId	Egyéni felhasználói azonosító (fejlesztői csoport)
WrapperRuntimeVersion	App Center SDK burkoló futtatókörnyezet verziója
WrapperSdkName	App Center SDK burkoló neve
WrapperSdkVersion	Az App Center SDK burkolójának verziója

Minta AI-lekérdezés egyéni események lekéréséhez:

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

További információ az Application Insightsról és az App Centerről:

• Az Application Insights ismertetése általában
• Tudnivalók az App Centerrel való integrációról az AI-blogon
• További információ a jobb döntésekről a Better Analytics segítségével az App Center blogján

Előfeltételek

Az Exportálás használatához Azure-előfizetéssel kell rendelkeznie; Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot .

Azure-előfizetés összekapcsolása

Megjegyzés:

Ez a lépés csak a standard exportáláshoz szükséges; Az egyéni exportáláshoz nincs szükség Azure-előfizetésre.

Az App Center alkalmazásadatok Azure-ba történő szabványos exportálásához az App Center alkalmazáshoz társított Azure-előfizetésre van szükség. Az előfizetés hozzáadását és az alkalmazáshoz való csatolását az alkalmazás tulajdonosának kell elvégeznie (ha az alkalmazás nem egy szervezethez tartozik), vagy a szervezet rendszergazdájának kell elvégeznie.

Azure-előfizetés hozzáadása

• Szervezethez tartozó alkalmazás: Ha Ön a szervezet rendszergazdája, lépjen a Kezelés szakaszra annak a szervezetnek a alatt , amelyhez az alkalmazás tartozik.
• Felhasználóhoz tartozó alkalmazás: Ha Ön az alkalmazás tulajdonosa, kövesse az alábbi lépéseket.

1. Jelentkezzen be az App Center portálra.
2. Nyissa meg a felhasználói beállításokat.
3. Az Azure-ban kattintson az Előfizetés hozzáadása elemre
4. Válasszon ki egy meglévő Azure-előfizetést, vagy hozzon létre egy újat.

Alkalmazás csatolása Azure-előfizetéshez

Miután hozzáadta az Azure-előfizetést a felhasználói vagy szervezeti fiókhoz, hozzáférést kell biztosítania az alkalmazásoknak, hogy az előfizetés az alkalmazásban használható legyen. Ezzel lehetővé teszi, hogy az alkalmazás bármely kezelője/fejlesztője exportálási célokra használja az előfizetést. Ez az Azure-előfizetéshez kapcsolódó költséggel jár.

Exportálás beállítása

1. Az App Center portálon válassza ki az alkalmazást.
2. Nyissa meg az alkalmazásbeállításokat.
3. Kattintson az Exportálás gombra, és válassza az Új exportálás lehetőséget.
4. Válassza ki a blobtárolót vagy az Application Insightst az alkalmazás igényei alapján.
5. Válassza ki a kívánt konfigurációtípust (standard és egyéni).

Az App Center kétféleképpen exportálhatja az adatokat: a standard exportálást és az egyéni exportálást. A standard exportálással egyetlen kattintással exportálhatja az adatokat az alkalmazáshoz csatolt Azure-előfizetés használatával. Az egyéni exportálás nagyobb rugalmasságot biztosít, és a konfigurációk testre lesznek szabva az Azure-ban.

Alapértelmezett export

A Standard Export egykattintásos felületet biztosít az adatok exportálásához. Ezzel a beállítással az összes szükséges erőforrás automatikusan létrejön az Azure-ban.

Egyéni exportálás

Az egyéni exportálás lehetővé teszi, hogy a felhasználók testre szabhassák az exportálási konfigurációjukat az Azure-ban.

Blob Storage esetén

1. Jelentkezzen be a Azure portalra.
2. Kattintson az Új erőforrás létrehozása elemre
3. Marketplace-ben keresse a Tárfiókot.
4. Kattintson a Létrehozás lehetőségre. Ekkor megnyílik a Tárfiók létrehozása lap.
5. Válasszon ki egy Azure-előfizetést.
6. Válasszon ki egy meglévő erőforráscsoportot, vagy hozzon létre egy újat. (Az erőforráscsoport egy azure-megoldáshoz kapcsolódó erőforrásokat tartalmazó tároló)
7. Fióktípusok esetén a következő legördülő lista jelenik meg. Három lehetőség támogatott. Válassza ki az Önnek megfelelőt.
8. Kattintson a Véleményezés + létrehozás gombra
9. Az ellenőrzés befejezése után
10. Kattintson a Létrehozás gombra
11. Ha az üzembe helyezés sikeres volt, lépjen az erőforrásra
12. Hozzáférési kulcsok keresése a Beállítások lapon
13. Másolja ki a kapcsolati sztringet , és adja hozzá az App Center egyéni konfigurációihoz.

Application Insights esetén

1. Jelentkezzen be a Azure portalra.
2. Válassza a "Forrás létrehozása"> a "Management Tools" és > az "Application Insights" lehetőséget.
3. Megjelenik egy konfigurációs mező
4. Állítsa az alkalmazástípustApp Center-alkalmazásra.
5. Másolja ki a rendszerállapotkulcsot az Azure Portalról, és adja hozzá az App Center egyéni konfigurációihoz. Az instrumentálási kulcsot az Application Insights erőforrásának Áttekintés lapján találja.

Az exportálásról további információt az Application Insights rövid útmutatójában talál.

Több alkalmazás exportálása ugyanarra a tárfiókra

Ha több alkalmazás exportját konfigurálja, akkor létre kell hoznia vagy frissítenie kell egy konfigurációt, amelyben a blob_path_format_kind (a ExportBlobConfiguration modell része) beállítva van WithAppId-ra, így az export elérési útvonala az adott alkalmazásazonosítóval kezdődik.

A blob elérési útja a következőképpen van formázva:

• ha az enumerálás értéke WithoutAppId=false be van állítva year/month/day/hour/minute
• ha az enumerálás értéke WithAppId=true be van állítva appId/year/month/day/hour/minute

Az exportkonfiguráció-létrehozási API-t a fentiekben ismertették. A meglévő konfigurációk esetében a részleges frissítési API a következő:

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

A módosítások propagálása 5–10 percet vesz igénybe, és az onnan származó entitások az új elérési út formátumával lesznek megírva.

Visszatöltés kizárása

Alapértelmezés szerint egy új exportálási konfiguráció az AI-erőforrások két utolsó napját, a Blob Storage esetében pedig 28 napot tölt vissza. Vannak olyan forgatókönyvek, amikor nincs szükség a visszatöltésre; Ha például így tesz, az adatok felülírását vagy duplikálását eredményezné. Ebben az esetben backfill tulajdonságot állítsa be false értékre egy új konfiguráció létrehozásakor.

Az exportálandó adatok típusának kiválasztása

Alapértelmezés szerint egy új exportálási konfiguráció csak az Analytics-adatokat exportálja (eseményeket, munkameneteket stb.). A diagnosztikai adatok akkor exportálhatók, ha a Entities tulajdonságot a export_entity modellben úgy állítjuk be, hogy az egy errors, crashes és attachments kombináció legyen. A tulajdonság lehetővé teszi az Analytics-adatok exportálásának kizárását is, ha értéket ad no_logs hozzá a Entities tömbhöz.

Automatikus kikapcsolási mechanizmus

Az App Center automatikusan letilthatja a hibás exportálási konfigurációt, hogy megakadályozza a teljes exportálási folyamat esetleges késését. Az App Center például az Azure-ból érkező alábbi hibákat kezeli.

• Az Application Insights rendszerállapotkulcsa érvénytelen.
• A Blob-erőforrás nem hitelesíthető, vagy a távoli név nem feloldható.

Megjegyzés:

Ha az exportálás újra engedélyezve van, az adatfolyam ettől a pillanattól kezdve háttérbetöltés nélkül folytatódik, hogy elkerülje az adat felülbírálását vagy duplikálását. Ha vissza kell töltenie a hiányzó adatokat, újra létre kell hoznia az exportálási konfigurációt. Az Application Insightsba irányuló adatok a Blob Storage esetében 48 órát és 28 napot maradnak.

A visszaállítási művelet végrehajtásához az alábbi API-k egyikével ellenőrizheti az állapotot.

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

Az alábbi API-val engedélyezheti az exportálási konfigurációt

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

Árképzés

Az Exportálás beállításához létre kell hoznia egy Azure-előfizetést. Az adatok exportálásának költsége az exportálandó Azure-szolgáltatástól függ. Az egyes szolgáltatások díjszabásának részletei a következő címen találhatók:

Az Application Insights díjszabása

Blob Storage díjszabás