Carga de bloqueos a través de la API
Importante
Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.
Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.
Puede cargar un informe de bloqueo si no desea usar nuestro SDK o desarrollar para una plataforma personalizada. Cargue un registro de bloqueo, error o datos adjuntos en App Center y vea los detalles en la interfaz de usuario de diagnóstico de App Center. En las secciones siguientes se explica cómo cargar bloqueos, errores y datos adjuntos.
Nota
App Center solo acepta hasta 60 bloqueos y errores controlado por minuto por aplicación única. No ingeriremos bloqueos ni errores que superen este límite.
Para cargar un informe, llame al punto de conexión de ingesta de App Center en https://in.appcenter.ms/logs?Api-Version=1.0.0 con los encabezados siguientes:
-
Content-Type: describe el formato del cuerpo. Actualmente, App Center solo admite el formato JSON. -
App-Secret: cadena que es el identificador único de cada aplicación. Puede encontrar el secreto de la aplicación en la configuración de una aplicación. -
Install-ID: cadena que puede ser cualquier GUID que se usa para realizar un seguimiento de los recuentos.
Propiedades del registro:
-
type: cadena requerida con tipo de registro: "appleError" para bloqueos de Apple, "managedError" para otros bloqueos, "handledError" para errores y "errorAttachment" para los datos adjuntos de error. -
timestamp: cadena opcional con la marca de tiempo de registro de fecha y hora, por ejemplo, "2017-03-13T18:05:42Z", si se establece, debe ser como máximo 72 horas en el futuro de la ingesta. -
appLaunchTimestamp: cadena requerida que especifica la fecha y hora de marca de tiempo en que se inició la aplicación, por ejemplo"2017-03-13T18:05:42Z". -
device: objeto obligatorio con características del dispositivo.-
appVersion: cadena requerida con el nombre de la versión de la aplicación, por ejemplo "1.1.0" -
appBuild: cadena necesaria con el número de compilación de la aplicación, por ejemplo" "42". -
sdkName: cadena necesaria con el nombre del SDK. Consta del nombre del SDK y la plataforma, por ejemplo, "appcenter.android" para Android y "appcenter.custom" para plataformas personalizadas. -
sdkVersion: cadena necesaria con la versión del SDK en formato de control de versiones semántico, por ejemplo"1.2.0" o "0.12.3-alpha.1" -
osName: cadena necesaria con el nombre del sistema operativo, por ejemplo" "android". -
osVersion: cadena necesaria con la versión del sistema operativo, por ejemplo"9.3.0". -
model: cadena opcional con el modelo de dispositivo, por ejemplo, "iPad2" -
locale: cadena necesaria con código de idioma, por ejemplo, "en-US" -
timeZoneOffset: desplazamiento opcional en minutos (entre -840 y 840) desde la hora universal coordinada (UTC) para la zona horaria del dispositivo. Incluye el horario de verano, por ejemplo, 120.
-
-
userId: cadena opcional que se usa para asociar registros con usuarios. -
exception: objeto obligatorio con detalles de excepción-
type: cadena necesaria con tipo de excepción. -
frame: matriz opcional con marcos de pila -
message: cadena opcional con motivo de excepción. -
stackTrace: cadena opcional con seguimiento de pila sin formato -
innerException: matriz opcional con excepciones internas.
-
Puede encontrar ejemplos de cómo cargar un informe de bloqueo, un informe de errores y los datos adjuntos siguientes. Para obtener más especificaciones, puede encontrar el archivo completo aquí.
Nota
Debido a las directivas de retención, el informe timestamp no debe tener más de 25 días en los últimos o 3 días en el futuro.
Carga de un informe de bloqueo
Las siguientes propiedades son necesarias para cargar un informe de bloqueo:
-
processId: entero necesario con el identificador de proceso. -
id: la cadena necesaria con el identificador de excepción debe ser un identificador único para este informe. -
fatal: booleano obligatorio que indica si la excepción produjo un bloqueo. -
processName: cadena necesaria con el nombre del proceso. -
appNamespace: es necesario para las aplicaciones Android; de lo contrario, es una cadena opcional con el identificador de lote, el identificador del paquete o el espacio de nombres, en función de qué plataforma se use.
Para cargar un informe de bloqueo distinto del formato de Apple, asegúrese de que el tipo de registro esté establecido en "managedError".
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"
}
]
}
]
}
}
]
}'
Carga de un registro de bloqueos de Apple
Para cargar un registro de bloqueos de Apple, asegúrese de que el tipo de registro está establecido en "appleError". También se requieren las siguientes propiedades:
-
primaryArchitectureId: entero necesario con la arquitectura principal de CPU. -
applicationPath: cadena necesaria con la ruta de acceso a la aplicación. -
osExceptionType: cadena necesaria con el tipo de excepción del sistema operativo. -
osExceptionCode: cadena necesaria con código de excepción del sistema operativo. -
osExceptionAddress: cadena necesaria con la dirección de excepción del sistema operativo. -
binaries: matriz necesaria con archivos binarios asociados al error.
Por ejemplo:
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
}
]
}
]
}'
Carga de un registro de bloqueo personalizado
Para cargar un bloqueo para una plataforma personalizada, asegúrese de que el tipo de registro está establecido en "managedError" y sdkName está establecido en "appcenter.custom". Por ejemplo:
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"
}
]
}
]
}'
Carga de un registro de bloqueos de Breakpad y Minidump
Puede cargar un bloqueo personalizado del Breakpad para Android y Windows. Por ejemplo:
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>"
}
]
}'
Advertencias
Para cargar un bloqueo del Panel de interrupción, el wrapperSdkName campo debe establecerse en "custom.ndk" y debe adjuntar el archivo minivolcado como datos adjuntos al informe de bloqueo. Obtenga información sobre cómo enviar datos adjuntos en la sección de datos adjuntos de esta página.
Para simbolizar el bloqueo, debe cargar los símbolos a través de la CLI o la API según nuestros documentos de API. Si usa Breakpad con Android, se admiten ambas opciones especificadas en nuestros documentos de NDK de Android ; Si usa Breakpad con Windows, solo se admite la opción 2: "Cargar símbolos del Panel de interrupción".
Nota
Si va a cargar los símbolos desde macOS, debe limpiar los símbolos de cualquier carpeta extraña, por ejemplo, __MACOS se genera y para eliminarlo, puede usar zip -d <symbols.zip> __MACOSX/\*.
Cargar un informe de errores
Los errores controlados solo se admiten para aplicaciones Android, Xamarin, Unity, UWP, WPF y WinForms hoy en día. Para cargar un informe de errores, asegúrese de que el tipo de registro está establecido en "handledError".
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 ",
}
],
}
],
}
}
]
}'
Cargar datos adjuntos
Todos los datos adjuntos deben estar asociados a un informe de bloqueo. Puede cargar datos adjuntos con un informe de bloqueo en una llamada o en dos llamadas independientes.
Propiedades específicas de los datos adjuntos:
-
contentType: cadena necesaria con tipo de contenido, por ejemplo, "texto/sin formato" para texto. Puede encontrar ejemplos de tipo admitido que se enumeran aquí. -
data: cadena necesaria con datos codificados como base 64. -
errorId: cadena necesaria que contiene el identificador único del informe de errores asociado a los datos adjuntos. -
fileName: cadena necesaria para bloqueos de NDK que se establece en "minidump.dmp"
Nota
El límite de tamaño de los datos adjuntos es actualmente de 7 MB. Si se intenta enviar un archivo adjunto mayor, se producirá un error.
A continuación se muestra un ejemplo de cómo cargar un informe de bloqueo y un archivo adjunto en una llamada.
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"
}
}
]
}'