モバイルークラッシュREST API v1

モバイルクラッシュ API は、New Relic に報告されたモバイルアプリケーションのクラッシュに関する情報を取得する RESTful な方法です。クラッシュの種類や発生状況に応じて、属性やスレッドデータを取得することができます。

APIを利用することができます。

直近のクラッシュタイプをGET
1つのクラッシュタイプからオカレンスIDのリストをGET
特定のオペンションIDのスレッド、ライブラリ、アトリビュートをGET

コンテンツ

前提条件

これらの例でCrash APIを使用するには、以下が必要です。

New Relic Crash APIキー。このキーをX-API-KEYヘッダーの値として渡します。
あなたのNew Relic アカウントID
あなたのモバイルモニタリングアプリケーションID

例えば：

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

ヒント

Note: X-API-KEYは 1 分あたり 600 requestsにレート制限されています。

GET モバイルクラッシュ/

Purpose: 最新のクラッシュタイプを返します。

Resource URL:

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

URL parameters:

Name	Default	Example
`size` オプションです。返すべきクラッシュタイプの数。	25	100
`sort` オプション: 特定のプロパティでソートされた結果の順序: `recent` 、 `occurrence-count` 、 `users-affected` 。	`recent`	`occurrence-count`
`startTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	60分前	1479592610148
`endTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	今	1480530548906

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

crash_typeオブジェクト

要素	タイプ	説明
`crashFingerprint`	ストリング	クラッシュタイプの定義となる識別子。
`crashLocation`	ストリング	フォーマットされたクラッシュの場所の文字列。UIの場合と同じです。一般的に人間が読めるものですが、シンボルがない場合はメモリアドレスのみの場合もあります。
`firstSeen`	長さ	ミリ秒単位のエポックタイムスタンプ。クラッシュが最初に記録された時刻を示す。
`lastSeen`	長さ	ミリ秒単位のエポックタイムスタンプ。クラッシュが最後に記録された時刻を示す。
`usersAffected`	長さ	クラッシュを経験したユーザー数のカウント。
`occurrenceCount`	長さ	衝突の発生回数。
`crashLocationFile`	ストリング	クラッシュが発生したファイルです。 May be null.
`crashLocationLineNumber`	長さ	クラッシュが発生したライン番号。 May be 0.
`crashLocationMethod`	ストリング	クラッシュが発生したメソッドです。 May be null.
`crashLocationClass`	ストリング	クラッシュが発生したクラスです。

メタデータ・オブジェクト

要素	タイプ	説明
`count`	長さ	返されたクラッシュタイプの総数。
`startTime`	長さ	リクエストに使用される、ミリ秒単位の開始エポックタイムスタンプ。
`endTime`	長さ	リクエストに使用された終了時のエポックタイムスタンプ（ミリ秒単位）。
`maxSize`	長さ	返すことのできる要素の最大数。
`sort`	ストリング	特定のプロパティでソートされた結果の順序。

GET mobile-crashes/:crash_fingerprint

Purpose: 最近のクラッシュフィンガープリントの詳細を返します。

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}` 必要です。どのクラッシュを取得するかを指定するクラッシュフィンガープリントID(パスパラメータ）を指定します。	-	f2a7b92ee49279ebb4c379278234b2c0-1-60625
`startTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	60分前	1479592610148
`endTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	今	1480530548906
`size` オプションです。返すべきクラッシュの発生回数です。有効な範囲1 - 100	`20`	`100`
`sort` オプションです。特定のプロパティでソートされた結果の順序。	`recent`	`recent`
`occurrencesWithStackTrace` オプションです。オリジナルのスタックトレースを持つクラッシュのみを返します。	`false`	`true`

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

発生オブジェクト

要素	タイプ	説明
`id`	ストリング	固有のオカレンスを表すユニークな識別子。
`timestamp`	長さ	衝突の発生が記録されたエポックタイム。

メタデータ・オブジェクト

要素	タイプ	説明
`count`	長さ	返されたクラッシュタイプの総数。
`startTime`	長さ	リクエストに使用された最初のエポックタイムスタンプ（単位：ミリ秒）。
`endTime`	長さ	リクエストに使用された終了時のエポックタイムスタンプ（単位：ミリ秒）。
`maxSize`	長さ	返すことのできる要素の最大数。
`sort`	ストリング	特定のプロパティでソートされた結果の順序。

GET crash-details/:occurrence_id

Purpose: 特定のクラッシュ発生に関する詳細を返します。

ヒント

Note: 期間は重要です!クラッシュ発生時にクラッシュの詳細が取得されない場合は、開始時間と終了時間を拡張してみてください。

Resource URL:

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

URL parameters:

Name	Default	Example
`{occurrence_id}` 必要です。取得するクラッシュ・オカレンスを指定するオカレンスID。	-	1936a6c0-68d1-40ec-b73d-24ed5905a36a
`startTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	60分前	1479592610148
`endTime` 任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。	今	1480530548906

Name

Default

Example

{occurrence_id}

必要です。取得するクラッシュ・オカレンスを指定するオカレンスID。

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

startTime

任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。

60分前

1479592610148

endTime

任意です。エポックタイムスタンプ（単位：ミリ秒）。データを取得するためのタイム・ウィンドウを定義します。

今

1480530548906

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

スレッドオブジェクト

要素	タイプ	説明
`threadNumber`	長さ	スレッドに割り当てられた番号です。
`threadName`	ストリング	スレッドに割り当てられた名前。 May be null.
`crashed`	bool	クラッシュしているスレッドを示す。クラッシュするスレッドは1つだけです。
`registers`	辞書	レジスターとその内容（文字列や整数）のキー／バリューペア。
`frames`	配列<フレーム>	スレッドの個々のフレームの配列です。

フレームオブジェクト

要素	タイプ	説明
`library`	ストリング	命令を含むライブラリのパスです。
`libraryAddress`	ヘックス	ライブラリーの開始アドレスです。
`file`	ストリング	命令を含むファイル名。 May be empty or null.
`class`	ストリング	命令を含むクラス名。 May be empty or null.
`method`	ストリング	命令を含むメソッド名。 May be empty or null.
`line`	長さ	命令の行番号。 May be 0.
`instructionAddress`	ヘックス	命令のアドレスです。
`symbolAddress`	ヘックス	命令を含むシンボルのアドレス。 May be empty or null.
`symbolName`	ストリング	シンボルアドレスのシンボル文字列。 May be empty or null.

GET thread-data/:crash_fingerprint

Purpose: 指定されたクラッシュフィンガープリントのシンボル化された (iOS) または難読化解除された (Android) スレッドデータを返します。

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}

必要です。どのクラッシュを取得するかを指定するクラッシュフィンガープリントID(パスパラメータ）を指定します。

f2a7b92ee49279ebb4c379278234b2c0-1-60625

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

スレッドオブジェクト

要素	タイプ	説明
`threadNumber`	長さ	スレッドに割り当てられた番号です。
`threadName`	ストリング	スレッドに割り当てられた名前。 May be null.
`crashed`	bool	クラッシュしているスレッドを示す。クラッシュするスレッドは1つだけです。
`registers`	辞書	レジスターとその内容（文字列や整数）のキー／バリューペア。
`frames`	配列<フレーム>	スレッドの個々のフレームの配列です。

フレームオブジェクト

要素	タイプ	説明
`library`	ストリング	命令を含むライブラリのパスです。
`libraryAddress`	ヘックス	ライブラリーの開始アドレスです。
`file`	ストリング	命令を含むファイル名。 May be empty or null.
`class`	ストリング	命令を含むクラス名。 May be empty or null.
`method`	ストリング	命令を含むメソッド名。 May be empty or null.
`line`	長さ	命令の行番号。 May be 0.
`instructionAddress`	ヘックス	命令のアドレスです。
`symbolAddress`	ヘックス	命令を含むシンボルのアドレス。 May be empty or null.
`symbolName`	ストリング	シンボルアドレスのシンボル文字列。 May be empty or null.

レスポンスコード

ステータスコード	一般的な意味	説明
400	悪いリクエスト	リクエストパラメーターが不正または欠損しています。
401	未承認	APIキーが見つからない、または不正なAPIキー
403	禁断の	APIアクセスが有効になっていない
404	見つからない	リクエストされたリソースIDが見つからない
406	受け入れ不可	クライアントがサポートされていないコンテンツタイプを要求した
422	処理不可能なエンティティ	バリデーションエラー
500	内部サーバエラー	サーバーエラーが発生しました
200	成功	レスポンスが戻ってきた

この機械翻訳は、参考として提供されています。

モバイルークラッシュREST API v1

コンテンツ .css-21sua1{background:none;border:none;width:0;padding:0;}

前提条件

ヒント

GET モバイルクラッシュ/

レスポンス

GET mobile-crashes/:crash_fingerprint

リソース

レスポンス

GET crash-details/:occurrence_id

ヒント

リソース

レスポンス

GET thread-data/:crash_fingerprint

リソース

レスポンス

レスポンスコード

コンテンツ