モバイル クラッシュ 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 |
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 |
発生オブジェクト
要素 | タイプ | 説明 |
|---|
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 |
スレッドオブジェクト
要素 | タイプ | 説明 |
|---|
スレッド番号 | 長さ | スレッドに割り当てられた番号です。 |
スレッド名 | ストリング | スレッドに割り当てられた名前です。 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 |
スレッドオブジェクト
要素 | タイプ | 説明 |
|---|
スレッド番号 | 長さ | スレッドに割り当てられた番号です。 |
スレッド名 | ストリング | スレッドに割り当てられた名前です。 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 | 成功 | レスポンスが戻ってきた |