モバイル クラッシュ 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 |
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
|
発生オブジェクト
要素 | タイプ | 説明 |
---|
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 |
スレッドオブジェクト
要素 | タイプ | 説明 |
---|
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 |
スレッドオブジェクト
要素 | タイプ | 説明 |
---|
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 | 成功 | レスポンスが戻ってきた |