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

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

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

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

コンテンツ

前提条件

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

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

例えば：

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

ヒント

注意事項: X-API-KEYは1分間に600回のリクエストに制限されています。

GET モバイルクラッシュ/

目的： 最新のクラッシュタイプを返します。

リソースのURLです。

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

URLパラメータです。

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

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

crash_typeオブジェクト

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

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

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

GET mobile-crashes/:crash_fingerprint

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

リソースのURLです。

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

URLパラメータです。

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

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

発生オブジェクト

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

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

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

GET crash-details/:occurrence_id

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

ヒント

Note: Time period matters!事故の詳細が得られない場合は、開始時刻と終了時刻を拡大してみてください。

リソースのURLです。

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

URLパラメータです。

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

名前

デフォルト

例

{occurrence_id}

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

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

startTime

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

60分前

1479592610148

endTime

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

今

1480530548906

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

スレッドオブジェクト

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

フレームオブジェクト

要素	タイプ	説明
ライブラリー	ストリング	命令を含むライブラリのパスです。
ライブラリアドレス	ヘックス	ライブラリーの開始アドレスです。
ファイル	ストリング	命令を含むファイル名空またはNULLの場合があります。
クラス	ストリング	命令を含むクラス名空またはNULLの場合があります。
メソッド	ストリング	命令を含むメソッド名空またはNULLの場合があります。
ライン	長さ	命令の行番号 0の場合もあります。
instructionAddress	ヘックス	命令のアドレスです。
symbolAddress	ヘックス	命令を含むシンボルのアドレス空またはNULLでもよい。
シンボルネーム	ストリング	シンボルアドレスのシンボル文字列空またはNULLでも可。

GET thread-data/:crash_fingerprint

目的： 与えられたクラッシュフィンガープリントに対して、記号化された（iOS）または難読化された（Android）スレッドデータを返します。

リソースのURLです。

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

URLパラメータです。

名前

デフォルト

例

{crash_fingerprint}

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

f2a7b92ee49279ebb4c379278234b2c0-1-60625

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

スレッドオブジェクト

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

フレームオブジェクト

要素	タイプ	説明
ライブラリー	ストリング	命令を含むライブラリのパスです。
ライブラリアドレス	ヘックス	ライブラリーの開始アドレスです。
ファイル	ストリング	命令を含むファイル名空またはNULLの場合があります。
クラス	ストリング	命令を含むクラス名空またはNULLの場合があります。
メソッド	ストリング	命令を含むメソッド名空またはNULLの場合があります。
ライン	長さ	命令の行番号 0の場合もあります。
instructionAddress	ヘックス	命令のアドレスです。
symbolAddress	ヘックス	命令を含むシンボルのアドレス空またはNULLでもよい。
シンボルネーム	ストリング	シンボルアドレスのシンボル文字列空またはNULLでも可。

レスポンスコード

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

この機械翻訳は参考用に提供されます。

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

コンテンツ

前提条件

ヒント

GET モバイルクラッシュ/

レスポンス

GET mobile-crashes/:crash_fingerprint

リソース

レスポンス

GET crash-details/:occurrence_id

ヒント

リソース

レスポンス

GET thread-data/:crash_fingerprint

リソース

レスポンス

レスポンスコード