Mobile crash REST API v1

A API de travamento móvel é uma forma RESTful de recuperar informações sobre travamentos de seu aplicativo móvel que foram relatados à New Relic. Reúne os dados de atributos e threads disponíveis para um determinado conjunto de tipos e ocorrências de falhas.

Você pode usar a API para:

GET seus tipos de falhas mais recentes
GET uma lista de IDs de ocorrência de um único tipo de falha
GET Thread, biblioteca e atributo para um determinado ID de ocorrência

Conteúdo

Pré-requisitos

Para usar a API Crash nestes exemplos, você precisa:

Sua chave de API New Relic Crash. Passe esta chave como o valor do cabeçalho X-chave da API.
ID da sua contaNew Relic
Seu monitoramento de Mobile ID do aplicativo

Por exemplo:

https://rpm.newrelic.com/accounts/{account_ID}/mobile/{mobile_application_ID}

Dica

Note: X-chave de API têm taxa limitada a 600 solicitações por minuto.

GET mobile-crashes/

Purpose: Retorna os tipos de falhas mais recentes.

Resource URL:

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

URL parameters:

Name	Default	Example
`size` Opcional: O número de tipos de falha a serem retornados.	25	100
`sort` Opcional: A ordem dos resultados classificados em uma propriedade específica: recente, contagem de ocorrências, afetado pelo usuário.	recente	occurrence-count
`startTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	60 minutos atrás	1479592610148
`endTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	agora	1480530548906

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

objeto crash_type

Elemento	Tipo	Descrição
crashFingerprint	corda	O identificador definidor do tipo de falha.
crashLocation	corda	Localização formatada da string de travamento. O mesmo que na interface. Geralmente legível por humanos, mas se nenhum símbolo estiver disponível, podem ser apenas endereços de memória.
firstSeen	longo	Timestamp epoch, em milissegundos. Indica quando a falha foi registrada pela primeira vez.
lastSeen	longo	Timestamp epoch, em milissegundos. Indica quando a falha foi registrada mais recentemente.
usersAffected	longo	Contagem do número de usuários que sofreram a falha.
occurrenceCount	longo	Contagem de ocorrências de falhas.
crashLocationFile	corda	O arquivo em que ocorreu a falha. May be null.
crashLocationLineNumber	longo	O número da linha em que ocorreu a falha. May be 0.
crashLocationMethod	corda	O método em que ocorreu a falha. May be null.
crashLocationClass	corda	A turma em que ocorreu o acidente.

objeto de metadados

Elemento	Tipo	Descrição
count	longo	Número total de tipos de falha retornados.
startTime	longo	Timestamp epoch inicial em milissegundos usado para a solicitação.
endTime	longo	Timestamp epoch final em milissegundos usado para a solicitação.
maxSize	longo	Número máximo de elementos que podem ser retornados.
organizar	corda	A ordem dos resultados classificados em uma propriedade específica.

GET mobile-crashes/:crash_fingerprint

Purpose: Retorna detalhes sobre impressões digitais de falhas recentes.

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}` Obrigatório: ID de impressão digital de falha que especifica quais falhas serão recuperadas. (Parâmetro do caminho).	-	f2a7b92ee49279ebb4c379278234b2c0-1-60625
`startTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	60 minutos atrás	1479592610148
`endTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	agora	1480530548906
`size` Opcional: O número de ocorrências de falha a serem retornadas. Intervalo válido: 1 - 100	20	100
`sort` Opcional: a ordem dos resultados classificados em uma propriedade específica.	recente	recente
`occurrencesWithStackTrace` Opcional: retorne apenas falhas que tenham seu stack trace original.	false	verdadeiro

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

objeto de ocorrência

Elemento	Tipo	Descrição
id	corda	Um identificador exclusivo para uma ocorrência única.
Timestamp	longo	Tempo epoch em que a ocorrência do acidente foi registrada.

objeto de metadados

Elemento	Tipo	Descrição
count	longo	Número total de tipos de falha retornados.
startTime	longo	Timestamp epoch inicial em ms. usado para a solicitação.
endTime	longo	Timestamp epoch final em ms. usado para a solicitação.
maxSize	longo	Número máximo de elementos que podem ser retornados.
organizar	corda	A ordem dos resultados classificados em uma propriedade específica.

GET crash-details/:occurrence_id

Purpose: Retorna detalhes sobre uma ocorrência específica de falha.

Dica

Note: O período de tempo é importante! Se você não obtiver detalhes de travamento de uma ocorrência, tente expandir os horários de início e término.

Resource URL:

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

URL parameters:

Name	Default	Example
`{occurrence_id}` Obrigatório: o ID da ocorrência que especifica qual ocorrência de falha será recuperada.	-	1936a6c0-68d1-40ec-b73d-24ed5905a36a
`startTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	60 minutos atrás	1479592610148
`endTime` Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.	agora	1480530548906

Name

Default

Example

{occurrence_id}

Obrigatório: o ID da ocorrência que especifica qual ocorrência de falha será recuperada.

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

startTime

Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.

60 minutos atrás

1479592610148

endTime

Opcional: timestamp epoch em ms. Define a janela de tempo para recuperação de dados.

agora

1480530548906

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

objeto de thread

Elemento	Tipo	Descrição
threadNumber	longo	O número atribuído ao thread.
threadName	corda	O nome atribuído ao thread. May be null.
crashed	bool	Indica o thread com falha. Apenas um thread estará travando.
registers	Dicionário	Chave/valor par de registradores e seu conteúdo (strings e inteiros).
frames	Array<Frame>	Uma matriz de quadros individuais de um thread.

objeto de moldura

Elemento	Tipo	Descrição
library	corda	O caminho da biblioteca que contém a instrução.
libraryAddress	hex	O endereço inicial da biblioteca.
arquivo	corda	O nome do arquivo que contém a instrução. May be empty or null.
class	corda	O nome da classe que contém a instrução. May be empty or null.
método	corda	O nome do método que contém a instrução. May be empty or null.
line	longo	O número da linha da instrução. May be 0.
instructionAddress	hex	O endereço da instrução.
symbolAddress	hex	O endereço do símbolo que contém a instrução. May be empty or null.
symbolName	corda	A sequência de símbolos do endereço do símbolo. May be empty or null.

GET thread-data/:crash_fingerprint

Purpose: Retorna dados de thread simbolizados (iOS) ou desofuscados (Android) para uma determinada impressão digital de falha.

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}

Obrigatório: ID de impressão digital de falha que especifica quais falhas serão recuperadas. (Parâmetro do caminho).

f2a7b92ee49279ebb4c379278234b2c0-1-60625

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

objeto de thread

Elemento	Tipo	Descrição
threadNumber	longo	O número atribuído ao thread.
threadName	corda	O nome atribuído ao thread. May be null.
crashed	bool	Indica o thread com falha. Apenas um thread estará travando.
registers	Dicionário	Chave/valor par de registradores e seu conteúdo (strings e inteiros).
frames	Array<Frame>	Uma matriz de quadros individuais de um thread.

objeto de moldura

Elemento	Tipo	Descrição
library	corda	O caminho da biblioteca que contém a instrução.
libraryAddress	hex	O endereço inicial da biblioteca.
arquivo	corda	O nome do arquivo que contém a instrução. May be empty or null.
class	corda	O nome da classe que contém a instrução. May be empty or null.
método	corda	O nome do método que contém a instrução. May be empty or null.
line	longo	O número da linha da instrução. May be 0.
instructionAddress	hex	O endereço da instrução.
symbolAddress	hex	O endereço do símbolo que contém a instrução. May be empty or null.
symbolName	corda	A sequência de símbolos do endereço do símbolo. May be empty or null.

Códigos de resposta

Código de status	Significado geral	Descrição
400	Pedido ruim	Parâmetro de solicitação malformado ou ausente.
401	Não autorizado	Chave de API ausente ou chave de API incorreta
403	Proibido	Acesso à API não ativado
404	Não encontrado	ID do recurso solicitado não encontrado
406	Não aceitável	O cliente solicitou um tipo de conteúdo não compatível
422	Entidade não processável	Erro de validação
500	Erro do Servidor Interno	Ocorreu um erro no servidor
200	Sucesso	Resposta retornada

Esta tradução de máquina é fornecida para sua comodidade.

Conteúdo

Pré-requisitos

Dica

GET mobile-crashes/

Recurso

Resposta

objeto crash_type

objeto de metadados

GET mobile-crashes/:crash_fingerprint

Recurso

Resposta

objeto de ocorrência

objeto de metadados

GET crash-details/:occurrence_id

Dica

Recurso

Resposta

objeto de thread

objeto de moldura

GET thread-data/:crash_fingerprint

Recurso

Resposta

objeto de thread

objeto de moldura

Códigos de resposta

Esta tradução de máquina é fornecida para sua comodidade.

Mobile crash REST API v1

Conteúdo .css-21sua1{background:none;border:none;width:0;padding:0;}

Pré-requisitos

Dica

GET mobile-crashes/

Resposta

GET mobile-crashes/:crash_fingerprint

Recurso

Resposta

GET crash-details/:occurrence_id

Dica

Recurso

Resposta

GET thread-data/:crash_fingerprint

Recurso

Resposta

Códigos de resposta

Conteúdo