Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
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.
Ha nem szeretné használni az SDK-t, vagy nem szeretne egyéni platformra fejleszteni, feltölthet összeomlási jelentést. Töltsön fel egy összeomlási, hiba- vagy mellékletnaplót az App Centerbe, és tekintse meg a részleteket az App Center diagnosztikai felhasználói felületén. Az alábbi szakaszok ismertetik, hogyan tölthet fel összeomlásokat, hibákat és mellékleteket.
Megjegyzés:
Az App Center legfeljebb 60 összeomlást fogad el, és percenkénti hibákat kezel egyedi alkalmazásonként. Nem fogjuk feldolgozni azokat az összeomlásokat vagy hibákat, amelyek túllépik ezt a korlátot.
Jelentés feltöltéséhez hívja meg az App Center betöltési végpontját https://in.appcenter.ms/logs?Api-Version=1.0.0 a következő fejlécekkel:
-
Content-Type: a törzs formátumát írja le. Az App Center jelenleg csak a JSON formátumot támogatja. -
App-Secret: sztring, amely az egyes alkalmazások egyedi azonosítója. Az alkalmazás titkos kódját az alkalmazás beállításai között találja. -
Install-ID: karaktersorozat, amely bármilyen GUID lehet a számlálások nyomon követéséhez.
Naplótulajdonságok:
-
type: kötelező karakterlánc naplótípussal – "appleError" az Apple összeomlásai esetén, "managedError" egyéb összeomlások esetén, "handledError" a hibák esetén, és a hibamellékletek esetén pedig "errorAttachment". -
timestamp: opcionális karakterlánc napló időbélyeg dátum - időponttal, pl. "2017-03-13T18:05:42Z" – ha be van állítva, a felvétel időpontjához képest legfeljebb 72 órával lehet előrébb -
appLaunchTimestamp: kötelező sztring, amely meghatározza az alkalmazás indításának időbélyegét, például "2017-03-13T18:05:42Z". -
device: szükséges objektum eszközjellemzőkkel-
appVersion: kötelező karakterlánc az alkalmazás verziójának nevével, például "1.1.0" -
appBuild: kötelező karakterlánc az alkalmazás buildszámával, például "42" -
sdkName: kötelező karakterlánc az SDK nevével. Az SDK és a platform nevéből áll, például "appcenter.android" Androidhoz és "appcenter.custom" egyéni platformokhoz. -
sdkVersion: kötelező karakterlánc az SDK szemantikus verzió formátumban, például "1.2.0" vagy "0.12.3-alpha.1" -
osName: kötelező szöveg az operációs rendszer neve, például "android" -
osVersion: kötelező karaktersorozat az operációs rendszer verziójával, például "9.3.0" -
model: opcionális karaktersorozat az eszközmodell számára, például "iPad2" -
locale: kötelező sztring nyelvkóddal, például "en-US" -
timeZoneOffset: az eszköz időzónája számára a koordinált világidőtől (UTC) való opcionális eltolás percekben (-840 és 840 között). Beleértve a nyári időszámítást, például 120.
-
-
userId: nem kötelező sztring a naplók felhasználókkal való társításához -
exception: kötelező objektum kivétel részleteivel-
type: kötelező karakterlánc kivétel típussal -
frame: nem kötelező tömb veremkeretekkel -
message: opcionális karakterlánc a kivétel okával -
stackTrace: nem kötelező karakterlánc nyers veremnyomkövetéssel -
innerException: választható tömb belső kivételekkel
-
Alább példákat talál az összeomlási jelentések, hibajelentések és mellékletek feltöltésére. További specifikációkért a teljes fájlt itt találja.
Megjegyzés:
A megőrzési szabályzatok miatt a jelentésnek timestamp legfeljebb 25 napnak kell lennie az elmúlt vagy a jövőben 3 napnál.
Összeomlási jelentés feltöltése
Összeomlási jelentés feltöltéséhez a következő tulajdonságok szükségesek:
-
processId: szükséges egész szám folyamatazonosítóval -
id: kötelező sztring, amely rendelkezik kivétel azonosítóval, és a jelentés egyedi azonosítójának kell lennie -
fatal: kötelező logikai érték, amely jelzi, hogy a kivétel összeomlást eredményezett-e -
processName: karakterlánc a folyamat nevével -
appNamespace: androidos alkalmazásokhoz szükséges, más esetben a csomagazonosítóval, csomagazonosítóval vagy névtérrel rendelkező opcionális sztring, attól függően, hogy milyen platformot használ.
Ha az Apple formátumától eltérő összeomlási jelentést szeretne feltölteni, győződjön meg arról, hogy a napló típusa "managedError" értékre van állítva.
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs": [
{
"type": "managedError",
"timestamp": "2019-10-08T04:22:23.516Z",
"appLaunchTimestamp": "2019-09-29T22:22:23.516Z",
"processId": "123",
"id": "bca65f46-46ee-451b-83bb-2e358c3f45bf",
"fatal": true,
"processName": "com.microsoft.appcenter.demo.project",
"device": {
"appVersion": "12.0",
"appBuild": "1",
"sdkName": "custom.android",
"sdkVersion": "1.0.0",
"osName": "android",
"osVersion": "9.3",
"model": "Pixel",
"locale": "en-US",
"appNamespace": "com.contoso.myapp"
},
"userId": "TestID",
"exception": {
"type": "java.lang.RuntimeException",
"frames": [
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2575,
"methodName": "performResumeActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2603,
"methodName": "handleResumeActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2089,
"methodName": "handleLaunchActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 130,
"methodName": "access$600"
},
{
"className": "android.app.ActivityThread$H",
"fileName": "ActivityThread.java",
"lineNumber": 1195,
"methodName": "handleMessage"
},
{
"className": "android.os.Handler",
"fileName": "Handler.java",
"lineNumber": 99,
"methodName": "dispatchMessage"
},
{
"className": "android.os.Looper",
"fileName": "Looper.java",
"lineNumber": 137,
"methodName": "loop"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 4745,
"methodName": "main"
}
],
"innerExceptions": [
{
"type": "java.lang.RuntimeException",
"frames": [
{
"className": "android.app.Activity",
"fileName": "Activity.java",
"lineNumber": 5084,
"methodName": "performResume"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2565,
"methodName": "performResumeActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2603,
"methodName": "handleResumeActivity"
}
]
}
]
}
}
]
}'
Apple összeomlási napló feltöltése
Az Apple összeomlási naplójának feltöltéséhez győződjön meg arról, hogy a napló típusa "appleError" értékre van állítva. A következő tulajdonságokra is szükség van:
-
primaryArchitectureId: kötelező egész szám, elsődleges CPU-architektúrával -
applicationPath: kötelező karakterlánc az alkalmazás elérési útjához -
osExceptionType: szükséges sztring az operációs rendszer kivételtípusával -
osExceptionCode: a kötelező karakterlánc az operációs rendszer kivételkódjával -
osExceptionAddress: kötelező karaktersor OS kivétel címmel -
binaries: a hibahoz társított bináris fájlokat tartalmazó szükséges tömb
Például:
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs":
[
{
"type": "appleError",
"timestamp": "2019-10-08T02:44:55.000Z",
"appLaunchTimestamp": "2019-09-29T22:22:23.516Z",
"id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"applicationPath": "iOS/salesforce",
"osExceptionType": "CustomerIssue (TestIssue)",
"osExceptionCode": "0",
"osExceptionAddress": "0x00",
"processName": "salesforce",
"fatal": true,
"isTestMessage": false,
"device": {
"appVersion": "10.0",
"appBuild": "1",
"sdkName": "custom.ios",
"sdkVersion": "1.0.0",
"osName": "iOS",
"osVersion": "9.3",
"model": "iPhone9,1",
"locale": "en-US"
},
"userId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"fatal": true,
"threads": [
{
"id": 0,
"frames": [
{
"address": "0x000000018ada4d70",
"code": "0x18ad87000 + 122224"
},
{
"address": "0x0000000104463884",
"code": "0x10445c000 + 30852"
},
{
"address": "0x000000010438f640",
"code": "0x104388000 + 30272"
},
{
"address": "0x00000001b859fb64",
"code": "0x1b8229000 + 3631972"
}
]
},
{
"id": 1,
"frames": [
{
"address": "0x000000018bb4fce0",
"code": "0x18baa2000 + 711904"
},
{
"address": "0x000000018bbf7078",
"code": "0x18baa2000 + 1396856"
},
{
"address": "0x000000018baa8258",
"code": "0x18baa2000 + 25176"
},
{
"address": "0x000000018bb1c49c",
"code": "0x18baa2000 + 500892"
}
]
},
{
"id": 3,
"frames": [
{
"address": "0x000000018b755b9c",
"code": "0x18b732000 + 146332"
},
{
"address": "0x000000018b7dcd00",
"code": "0x18b7ce000 + 60672"
}
]
}
],
"binaries": [
{
"id": "d449e33d-7e74-379d-8b79-15ee104ed1df",
"startAddress": "0x0000000104388000",
"endAddress": "0x0000000104413fff",
"name": "CrashProbeiOS",
"path": "/var/containers/Bundle/Application/023013EA-0D58-4F6D-8B98-49E1372F4044/CrashProbeiOS.app/CrashProbeiOS",
"primaryArchitectureId": 16777228,
"architectureVariantId": 0
},
{
"id": "5da23653-d126-39f0-bdcf-994b3019f92c",
"startAddress": "0x000000010445c000",
"endAddress": "0x0000000104467fff",
"name": "CrashLibiOS",
"path": "/private/var/containers/Bundle/Application/023013EA-0D58-4F6D-8B98-49E1372F4044/CrashProbeiOS.app/Frameworks/CrashLibiOS.framework/CrashLibiOS",
"primaryArchitectureId": 16777228,
"architectureVariantId": 0
}
]
}
]
}'
Egyéni összeomlási napló feltöltése
Ha egy egyéni platform összeomlását szeretné feltölteni, győződjön meg arról, hogy a napló típusa "managedError", az sdkName pedig "appcenter.custom" értékre van állítva. Például:
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs": [
{
"type": "managedError",
"id": "a7bea41b-1e4d-4e42-ae76-1025f4fdfc4f",
"userId": "TestID",
"timestamp": "2019-11-26T02:00:04Z",
"appLaunchTimestamp": "2019-11-26T02:00:04Z",
"architecture": "armeabi-v7a",
"fatal": true,
"processId": 4871,
"processName": "com.microsoft.appcenter.sasquatch.project",
"sid": "bca65f46-46ee-451b-83bb-2e358c3f45bf",
"errorThreadId": 1,
"errorThreadName": "main",
"device": {
"appBuild": "1337",
"appVersion": "7.1.0",
"appNamespace": "com.microsoft.appcenter.sasquatch.project",
"carrierCountry": "us",
"locale": "en_US",
"model": "Galaxy Nexus",
"oemName": "samsung",
"osApiLevel": 16,
"osBuild": "JRO03O",
"osName": "Android",
"osVersion": "5.0.0",
"screenSize": "720x1184",
"sdkName": "appcenter.custom",
"sdkVersion": "1.9.1",
"timeZoneOffset": -480
},
"exception": {
"frames": [
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2575,
"methodName": "performResumeActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2603,
"methodName": "handleResumeActivity"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2089,
"methodName": "handleLaunchActivity"
}
],
"innerExceptions": [
{
"frames": [
{
"className": "android.app.CustomActivity",
"fileName": "CustomActivity.java",
"lineNumber": 8673,
"methodName": "performCustomResume"
},
{
"className": "android.app.ActivityThread",
"fileName": "ActivityThread.java",
"lineNumber": 2565,
"methodName": "performResumeActivity"
}
],
"message": "Activity {com.microsoft.appcenter.sasquatch.project/com.microsoft.appcenter.sasquatch.activities.CrashSubActivity2} did not call through to super.onResume()",
"type": "android.app.CustomNotCalledException"
}
],
"message": "Unable to resume activity {com.microsoft.appcenter.sasquatch.project/com.microsoft.appcenter.sasquatch.activities.CrashSubActivity2}: android.app.SuperNotCalledException: Activity {com.microsoft.appcenter.sasquatch.project/com.microsoft.appcenter.sasquatch.activities.CrashSubActivity2} did not call through to super.onResume()",
"type": "java.lang.RuntimeException"
},
"threads": [
{
"frames": [
{
"className": "dalvik.system.NativeStart",
"fileName": "NativeStart.java",
"lineNumber": -2,
"methodName": "run"
}
],
"id": 369,
"name": "Binder_3"
},
{
"frames": [
{
"className": "dalvik.system.NativeStart",
"fileName": "NativeStart.java",
"lineNumber": -2,
"methodName": "run"
}
],
"id": 345,
"name": "Compiler"
}
]
}
]
}'
Töltsön fel egy Breakpad összeomlási naplót és egy Minidump fájlt.
Feltölthet egyedi Breakpad összeomlásokat Android és Windows rendszerekre. Például:
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs":
[
{
"type": "managedError",
"id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"userId": "TestID",
"processId": 9448,
"processName": "Contoso.UWP.Puppet.exe",
"fatal": true,
"timestamp": "2019-10-08T06:22:23.530Z",
"architecture": "X64",
"timestamp": "2019-10-08T06:22:23.516Z",
"sid": "d4608adf-83b9-4f69-90ad-8bb0234080a7",
"device": {
"sdkName": "appcenter.custom",
"sdkVersion": "2.4.1-SNAPSHOT",
"model": "Parallels Virtual Platform",
"oemName": "Parallels Software International Inc.",
"osName": "WINDOWS",
"osVersion": "10.0.18363",
"osBuild": "10.0.18363.418",
"locale": "en-US",
"timeZoneOffset": -300,
"screenSize": "4608x2470",
"appVersion": "1.0",
"appBuild": "1.0",
"appNamespace": "10805zumoTestUser.AppCenter-Contoso.UWP.Puppet",
"carrierCountry": "us",
"wrapperSdkName": "custom.ndk"
},
"exception": {
"type": "minidump",
"wrapperSdkName": "custom.ndk"
}
},
{
"contentType": "application/octet-stream",
"errorId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"fileName": "minidump.dmp",
"id": "7b975468-5656-40a5-8242-c1907b26fc31",
"sid": "03693776-cdd4-46b8-bbda-12af457f1732",
"timestamp": "2019-10-08T06:22:23.516Z",
"type": "errorAttachment",
"device": {
"sdkName": "appcenter.custom",
"sdkVersion": "2.4.1-SNAPSHOT",
"model": "Parallels Virtual Platform",
"oemName": "Parallels Software International Inc.",
"osName": "WINDOWS",
"osVersion": "10.0.18363",
"osBuild": "10.0.18363.418",
"locale": "en-US",
"timeZoneOffset": -300,
"screenSize": "4608x2470",
"appVersion": "1.0",
"appBuild": "1.0",
"appNamespace": "10805zumoTestUser.AppCenter-Contoso.UWP.Puppet",
"carrierCountry": "us",
"wrapperSdkName": "custom.ndk"
},
"data": "<base64 encoded minidump>"
}
]
}'
Figyelmeztetések
A Breakpad összeomlásának feltöltéséhez a wrapperSdkName mezőt "custom.ndk" értékre kell állítani, és az összeomlási jelentéshez mellékletként csatolnia kell a minidump fájlt. Ebből a cikkből megtudhatja, hogyan küldhet mellékletet a lap mellékletek szakaszában .
Az összeomlás részleteinek dekódolásához fel kell töltenie a szimbólumokat a CLI-n keresztül, vagy az API-val az API-dokumentációnknak megfelelően. Ha a Breakpadet Androiddal használja, az Android NDK-dokumentációban megadott mindkét lehetőség támogatott; ha a Breakpadet Windows rendszeren használja, csak a 2. lehetőség támogatott: a "Breakpad szimbólumok feltöltése" lehetőség.
Megjegyzés:
Ha macOS-ről tölti fel a szimbólumokat, akkor meg kell tisztítania szimbólumait a felesleges mappáktól, például a __MACOS mappa keletkezik, amit törölhet zip -d <symbols.zip> __MACOSX/\*.
Hibajelentés feltöltése
A kezelt hibák jelenleg csak Android, Xamarin, Unity, UWP, WPF és WinForms alkalmazások esetén támogatottak. Hibajelentés feltöltéséhez győződjön meg arról, hogy a napló típusa "handledError" értékre van állítva.
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs":
[
{
"type": "handledError",
"timestamp": "2019-10-08T06:22:23.516Z",
"appLaunchTimestamp": "2019-09-29T22:22:23.516Z",
"id": "118dee14-9193-4ac3-9ef0-f6c11b43f2c4",
"device": {
"appVersion": "11.0",
"appBuild": "1",
"sdkName": "custom.android",
"sdkVersion": "1.0.0",
"osName": "android",
"osVersion": "9.3",
"model": "Pixel",
"locale": "en-US"
},
"userId": "TestID",
"exception": {
"type": "System.IO.IOException",
"message": "Server did not respond",
"stackTrace": " at Contoso.Forms.Puppet.FakeService+<>c.<DoStuffInBackground>b__0_0 () [0x00000] in <7ad93f134a5d4c00a8db8be9aa9c0f76>:0 \n at System.Threading.Tasks.Task`1[TResult].InnerInvoke () [0x0000f] in <b38d4262627948c1b945a72f56ce6466>:0 \n at System.Threading.Tasks.Task.Execute () [0x00010] in <b38d4262627948c1b945a72f56ce6466>:0 \n--- End of stack trace from previous location where exception was thrown ---\n at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw () [0x0000c] in <b38d4262627948c1b945a72f56ce6466>:0 \n at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess (System.Threading.Tasks.Task task) [0x0003e] in <b38d4262627948c1b945a72f56ce6466>:0 \n at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification (System.Threading.Tasks.Task task) [0x00028] in <b38d4262627948c1b945a72f56ce6466>:0",
"innerExceptions": [
{
"type": "System.IO.IOException",
"message": "Network down",
"stackTrace": " at Contoso.Forms.Demo.CrashesContentPage.SendHttp () [0x00002] in <4fd9174f6e18457b9721bfba2cd78098>:0 ",
"wrapperSdkName": "appcenter.xamarin"
},
{
"type": "System.ArgumentException",
"message": "Invalid parameter",
"innerExceptions": [
{
"type": "System.ArgumentOutOfRangeException",
"message": "It is over 9000!",
"stackTrace": " at Contoso.Forms.Demo.CrashesContentPage.ValidateLength () [0x00002] in <4fd9174f6e18457b9721bfba2cd78098>:0 ",
}
],
}
],
}
}
]
}'
Melléklet feltöltése
Minden mellékletet összeomlási jelentéshez kell társítani. Feltöltheti az összeomlási jelentéssel ellátott mellékletet egy hívás keretében vagy két külön hívás során.
Mellékletspecifikus tulajdonságok:
-
contentType: kötelező karakterlánc tartalomtípussal, például "text/plain" for text. A támogatott típusra itt talál példákat -
data: kötelező karakterlánc base64 formátumban kódolt adatokkal -
errorId: a melléklet társított hibajelentésének egyedi azonosítóját tartalmazó kötelező sztring -
fileName: Az NDK-összeomlásokhoz szükséges karaktersor, ami a "minidump.dmp" értékre van beállítva.
Megjegyzés:
A mellékletek méretkorlátja jelenleg 7 MB. Ha nagyobb mellékletet kísérel meg elküldeni, hiba lép fel.
Az alábbiakban egy példa egy összeomlási jelentés és egy melléklet feltöltésére egy hívásban.
curl -X POST \
'https://in.appcenter.ms/logs?Api-Version=1.0.0' \
-H 'Content-Type: application/json' \
-H 'app-secret: <app secret>' \
-H 'install-id: 00000000-0000-0000-0000-000000000001' \
-d '{
"logs": [
{
"type": "managedError",
"timestamp": "2019-10-01T02:22:23.516Z",
"appLaunchTimestamp": "2019-09-29T22:22:23.516Z",
"id": "bca65f46-46ee-451b-83bb-2e358c3f45bf",
"fatal": true,
"processName": "com.microsoft.appcenter.sasquatch.project",
"device": {
"appVersion": "13.0",
"appBuild": "1",
"sdkName": "appcenter.android",
"sdkVersion": "1.0.0",
"osName": "android",
"osVersion": "9.3",
"model": "Pixel",
"locale": "en-US"
},
"userId": "118dee14",
"fatal": true,
"exception": {
"type": "CustomerIssue",
"frames": []
}
},
{
"type": "errorAttachment",
"contentType": "text/plain",
"timestamp": "2019-10-01T02:22:23.516Z",
"data": "aGVsbG8=",
"errorId": "bca65f46-46ee-451b-83bb-2e358c3f45bf",
"id": "7caaea8e-dab1-4588-993c-95de2d9a4fd1",
"device": {
"appVersion": "13.0",
"appBuild": "1",
"sdkName": "appcenter.android",
"sdkVersion": "1.0.0",
"osName": "android",
"osVersion": "9.3",
"model": "Pixel",
"locale": "en-US"
}
}
]
}'