モバイル クラッシュ 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
成功
レスポンスが戻ってきた