Mobile crash REST API v1

La API de fallos móviles es una forma RESTful de recuperar información sobre los fallos de su aplicación móvil que se han informado a New Relic. Reúne los datos de atributos y subprocesos disponibles para un conjunto determinado de tipos y ocurrencias de fallas.

Puede utilizar la API para:

GET tus tipos de fallos más recientes
GET una lista de ID de ocurrencias de un solo tipo de falla
GET Thread, biblioteca y atributo para un ID de ocurrencia particular

Contenido

Requisitos previos

Para utilizar la API Crash en estos ejemplos, necesita:

Su clave de API de Crash de New Relic. Pasa esta clave como el valor del encabezado X-API-KEY.
Su ID de cuentade New Relic
Su monitoreo de móviles ID de la aplicación

Para encontrar el ID de tu cuenta y el ID de la aplicación móvil, abre tu aplicación móvil en one.newrelic.com, haga clic en el ícono (i) y lea los valores de la pestaña Metadata.

Sugerencia

Note: X-API-KEYs tienen un límite de 600 requests por minuto.

GET mobile-crashes/

Purpose: Devuelve los tipos de fallos más recientes.

Resource URL:

https://mobile-data-api.newrelic.com/v1/mobile-crashes/{account_id}/{mobile_application_id}

URL parameters:

Name	Default	Example
`size` Opcional: el número de tipos de fallos que se devolverán.	25	100
`sort` Opcional: el orden de los resultados clasificados por una propiedad en particular: `recent`, `occurrence-count`, `users-affected`.	`recent`	`occurrence-count`
`startTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	hace 60 minutos	1479592610148
`endTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	ahora	1480530548906

{
  data: [
    {
      :crash_type
    },
    ...
  ],
  meta: {
    :metadata
  }
}

objeto crash_type

Elemento	Tipo	Descripción
`crashFingerprint`	cadena	El identificador que define el tipo de accidente.
`crashLocation`	cadena	Cadena de ubicación de fallas formateada. Igual que en la UI. Generalmente legible por humanos, pero si no hay símbolos disponibles, pueden ser solo direcciones de memoria.
`firstSeen`	largo	Timestamp epoch, en milisegundos. Indica cuándo se registró el accidente por primera vez.
`lastSeen`	largo	Timestamp epoch, en milisegundos. Indica cuándo se registró el accidente por última vez.
`usersAffected`	largo	Recuento del número de usuarios que han experimentado el bloqueo.
`occurrenceCount`	largo	Recuento de accidentes.
`crashLocationFile`	cadena	El archivo en el que ocurrió el accidente. May be null.
`crashLocationLineNumber`	largo	El número de línea en el que ocurrió el accidente. May be 0.
`crashLocationMethod`	cadena	El método en el que ocurrió el accidente. May be null.
`crashLocationClass`	cadena	La clase en la que ocurrió el accidente.

objeto de metadatos

Elemento	Tipo	Descripción
`count`	largo	Número total de tipos de fallos devueltos.
`startTime`	largo	Timestamp epoch inicial en milisegundos utilizada para la solicitud.
`endTime`	largo	Timestamp epoch final en milisegundos utilizados para la solicitud.
`maxSize`	largo	Número máximo de elementos que se pueden devolver.
`sort`	cadena	El orden de los resultados ordenados según una propiedad particular.

GET mobile-crashes/:crash_fingerprint

Purpose: Devuelve detalles sobre huellas dactilares de accidentes recientes.

Resource URL:

https://mobile-data-api.newrelic.com/v1/mobile-crashes/{account_id}/{mobile_application_id}/{crash_fingerprint}

URL parameters:

Name	Default	Example
`{crash_fingerprint}` Obligatorio: ID de huella digital de fallas que especifica qué fallas recuperar. (Parámetro de ruta).	-	f2a7b92ee49279ebb4c379278234b2c0-1-60625
`startTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	hace 60 minutos	1479592610148
`endTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	ahora	1480530548906
`size` Opcional: el número de incidencias de fallos que se devolverán. Rango válido: 1 - 100	`20`	`100`
`sort` Opcional: el orden de los resultados ordenados en una propiedad particular.	`recent`	`recent`
`occurrencesWithStackTrace` Opcional: Solo devuelve crashes que tengan su rastreo del stack original.	`false`	`true`

{
  data: [
    :occurrence,
    ...
  ],
  meta: {
    :metadata
  },
}

objeto de ocurrencia

Elemento	Tipo	Descripción
`id`	cadena	Un identificador único para una ocurrencia única.
`timestamp`	largo	Tiempo epoch en la que se registró el accidente.

objeto de metadatos

Elemento	Tipo	Descripción
`count`	largo	Número total de tipos de fallos devueltos.
`startTime`	largo	Timestamp epoch de inicio en ms. utilizado para la solicitud.
`endTime`	largo	Timestamp epoch final en ms. utilizado para la solicitud.
`maxSize`	largo	Número máximo de elementos que se pueden devolver.
`sort`	cadena	El orden de los resultados ordenados según una propiedad particular.

GET crash-details/:occurrence_id

Purpose: Devuelve detalles sobre un accidente específico.

Sugerencia

Note: ¡El período de tiempo importa! Si no obtiene ningún detalle sobre el fallo de un suceso, intente ampliar las horas de inicio y finalización.

Resource URL:

https://mobile-data-api.newrelic.com/v1/crash-details/{account_id}/{application_id}/{occurrence_id}

URL parameters:

Name	Default	Example
`{occurrence_id}` Obligatorio: el ID de ocurrencia que especifica qué ocurrencia de falla recuperar.	-	1936a6c0-68d1-40ec-b73d-24ed5905a36a
`startTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	hace 60 minutos	1479592610148
`endTime` Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.	ahora	1480530548906

Name

Default

Example

{occurrence_id}

Obligatorio: el ID de ocurrencia que especifica qué ocurrencia de falla recuperar.

1936a6c0-68d1-40ec-b73d-24ed5905a36a

startTime

Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.

hace 60 minutos

1479592610148

endTime

Opcional: timestamp epoch en ms. Define la ventana de tiempo para la recuperación de datos.

ahora

1480530548906

{
  data: [
    threads: [
      :thread,
      {
        frames: [
          :frame,
          ...
        ]
      },
      ...
    ],
    libraries: [
      :library,
      ...
    ],
    attributes: {
      :insights_attributes
    }
  ]
}

objeto de thread

Elemento	Tipo	Descripción
`threadNumber`	largo	El número asignado al thread.
`threadName`	cadena	El nombre asignado al hilo. May be null.
`crashed`	bool	Indica el hilo que falla. Sólo un hilo fallará.
`registers`	Diccionario	Clave/valor de registros y su contenido (cadenas y números enteros).
`frames`	Array<Frame>	Una matriz de los fotogramas individuales de un hilo.

objeto de marco

Elemento	Tipo	Descripción
`library`	cadena	La ruta de la biblioteca que contiene la instrucción.
`libraryAddress`	hex	La dirección inicial de la biblioteca.
`file`	cadena	El nombre del archivo que contiene la instrucción. May be empty or null.
`class`	cadena	El nombre de la clase que contiene la instrucción. May be empty or null.
`method`	cadena	El nombre del método que contiene la instrucción. May be empty or null.
`line`	largo	El número de línea de la instrucción. May be 0.
`instructionAddress`	hex	La dirección de la instrucción.
`symbolAddress`	hex	La dirección del símbolo que contiene la instrucción. May be empty or null.
`symbolName`	cadena	La cadena de símbolos de la dirección del símbolo. May be empty or null.

GET thread-data/:crash_fingerprint

Purpose: Devuelve datos de subprocesos simbolizados (iOS) o desofuscados (Android) para una huella digital de falla determinada.

Resource URL:

https://mobile-data-api.newrelic.com/v1/thread-data/{account_id}/{mobile_application_id}/{crash_fingerprint}

URL parameters:

Name

Default

Example

{crash_fingerprint}

Obligatorio: ID de huella digital de fallas que especifica qué fallas recuperar. (Parámetro de ruta).

f2a7b92ee49279ebb4c379278234b2c0-1-60625

{
  data: [
    threads: [
      :thread,
      {
        frames: [
          :frame,
          ...
        ]
      },
      ...
    ],
    libraries: [
      :library,
      ...
    ]
  ]
}

objeto de thread

Elemento	Tipo	Descripción
`threadNumber`	largo	El número asignado al thread.
`threadName`	cadena	El nombre asignado al hilo. May be null.
`crashed`	bool	Indica el hilo que falla. Sólo un hilo fallará.
`registers`	Diccionario	Clave/valor de registros y su contenido (cadenas y números enteros).
`frames`	Array<Frame>	Una matriz de los fotogramas individuales de un hilo.

objeto de marco

Elemento	Tipo	Descripción
`library`	cadena	La ruta de la biblioteca que contiene la instrucción.
`libraryAddress`	hex	La dirección inicial de la biblioteca.
`file`	cadena	El nombre del archivo que contiene la instrucción. May be empty or null.
`class`	cadena	El nombre de la clase que contiene la instrucción. May be empty or null.
`method`	cadena	El nombre del método que contiene la instrucción. May be empty or null.
`line`	largo	El número de línea de la instrucción. May be 0.
`instructionAddress`	hex	La dirección de la instrucción.
`symbolAddress`	hex	La dirección del símbolo que contiene la instrucción. May be empty or null.
`symbolName`	cadena	La cadena de símbolos de la dirección del símbolo. May be empty or null.

Códigos de respuesta

Código de estado	Significado general	Descripción
400	Solicitud incorrecta	Parámetro de solicitud mal formado o faltante.
401	No autorizado	Falta una clave de API o una clave de API incorrecta
403	Prohibido	Acceso API no habilitado
404	Extraviado	ID de recurso solicitado no encontrado
406	Inaceptable	El cliente solicitó un tipo de contenido no compatible
422	Entidad inprocesable	Error de validacion
500	Error Interno del Servidor	Ha ocurrido un error de servidor
200	Éxito	Respuesta devuelta

Te ofrecemos esta traducción automática para facilitar la lectura.

Contenido

Requisitos previos

Sugerencia

GET mobile-crashes/

Recurso

Respuesta

objeto crash_type

objeto de metadatos

GET mobile-crashes/:crash_fingerprint

Recurso

Respuesta

objeto de ocurrencia

objeto de metadatos

GET crash-details/:occurrence_id

Sugerencia

Recurso

Respuesta

objeto de thread

objeto de marco

GET thread-data/:crash_fingerprint

Recurso

Respuesta

objeto de thread

objeto de marco

Códigos de respuesta

Te ofrecemos esta traducción automática para facilitar la lectura.

Mobile crash REST API v1

Contenido .css-21sua1{background:none;border:none;width:0;padding:0;}

Requisitos previos

Sugerencia

GET mobile-crashes/

Respuesta

GET mobile-crashes/:crash_fingerprint

Recurso

Respuesta

GET crash-details/:occurrence_id

Sugerencia

Recurso

Respuesta

GET thread-data/:crash_fingerprint

Recurso

Respuesta

Códigos de respuesta

Contenido