Log & Crash Searchは、次のような順序で使用できます。

  • サービス有効化 プロジェクトを作成し、プロジェクトを選択した後、 Log & Crash Searchを有効化します。
  • ログ転送 Log & Crash Search SDKを通して、ログの転送を開始します。
  • ログ確認 ログを転送した後は、ログ検索またはアプリクラッシュ検索画面でチャートや検索など、多様な方式でログを確認できます。

プロジェクト選択

コンソールに接続し、左側メニューを利用して組織(Organization)とプロジェクト(Project)を選択します。組織やプロジェクトがない場合は、作成する必要があります。 - 左側メニューからORGANIZATION > PROJECTをクリックします。

組織とプロジェクトの作成方法はNHN Cloudコンソール使用ガイドを参照してください。

サービス有効化

プロジェクト(Project)を選択した状態で、画面上部にあるサービス選択ボタンをクリックして、Data & Analyticsの下Log & Crash Searchをクリックします。サービスが有効になると、サービス名の横に選択(v)表示が現れます。

[参考]
サービスを有効にした後は、約5分後から転送できます。

Log & Crash Searchが有効になると、左側メニューにData & Analytics > Log & Crash Searchメニューが現れ、Appkeyが作成されます。

Appkey確認

ログを転送するには、Appkeyを確認する必要があります。

  1. 左側のメニューから、Data & Analytics > Log & Crash Search > ログ検索をクリックします。
  2. コンソール画面上部のURL & Appkeyボタンをクリックすると、Log & Crash Search用Appkeyを確認できます。

ログ転送

ログを転送するには、Log & Crash Search SDKが必要です。 SDKはNHN Cloud DownloadsページのData & Analytics > Log & Crash Searchでダウンロードできます。

[参考]
SDK使用時に、クラッシュログと一緒に送信されるセッションログは検索画面に表示されません。
セッションログの送信時、リソース提供ポリシーの日次ログ件数提供量には他のログと同じように合算して反映されますが、API呼び出し料金には反映されません。

ログ検索

転送したログをLog Search機能を利用して検索してみましょう。

  1. コンソール画面の左側にあるメニューからData & Analytics > Log & Crash Search > ログ検索をクリックします。
  2. ログ検索タブには、基本的に24時間のログ量のグラフと詳細内容が表示されます。

ログ検索画面は、次のように構成されています。

lcs_02_ja_20200602

項目 説明
検索クエリー入力 クエリーフィールド検索はLucene文法を使用できます。
(参照:https://docs.toast.com/ko/Data%20&%20Analytics/Log%20&%20Crash%20Search/ko/lucene-query-guide/)
検索対象期間 検索クエリーの期間条件を設定できます。
ログ検索結果 > チャート ログ検索結果を棒グラフで表示し、棒グラフのバーをクリックするとそのバーのログ期間を再検索してログを確認できます。
ログ結果ダウンロード ログ検索結果を任意のフォーマットでダウンロードできます。またクラッシュダンプデータのみ別途ダウンロードが可能です。
選択したフィールド ログフィールドに応じて右側の結果テーブルカラムを変更できます。 追加ボタンを使用して他のフィールドを追加および削除できます。
ログ検索結果 > ログレコード 検索したログの詳細内容が表示される部分です。表示されたログの各項目は、クリックして検索クエリーを変更できます。

ユーザーが設定した検索条件は、検索クエリー入力ウィンドウに反映され、頻繁に使用するクエリの場合はクエリ保存ボタンを使用して保存しておき、後で簡単に呼び出すことができます。保存したクエリは保存クエリリストで確認および管理が可能です。

[参考] データの長さが1,000,000文字を超えるフィールドを含むログは検索ができません。そのため、照会ができないログは問題が解決するまでログダウンロード機能を利用して照会をお願いします。

アプリクラッシュ照会

Android、iOS端末のクラッシュ情報は、Data & Analytics > Log & Crash Search > アプリクラッシュ検索で確認できます。

イシュー照会

イシュー照会タブのエラータイプCrashesを選択すると、イシューを確認できます。

lcs_03_201812

イシュー照会タブのエラータイプHandledを選択すると、handledイシューを確認できます。

lcs_04_201812

項目 説明
チャート イシュー要約とクラッシュ発生件数をタイムラインチャートに表示します。
エラータイプ システムで発生するCrashと、Exceptionブロックでユーザーが発生させるHandledに分類されます。
検索条件 プラットフォーム - アプリプラットフォーム選択
状態–クラッシュイシュー処理状態
アプリバージョン - アプリのバージョン
OSバージョン–OSのバージョン
タグ–タグ
最小発生数–クラッシュ発生最小N件以上のクラッシュ照会フィルタ
例外の種類–例外の種類別最近フィルタ
位置–クラッシュ発生地点別照会フィルタ
イシューリスト イシューリストを表示します。右上のリストボックスを利用してソート順序を変更でき、リスト左側の選択ボックスからイシュー状態を変更できます。

リストでイシューをクリックすると、該当イシューの詳細情報を確認できます。

lcs_05_201812

項目 説明
状態 イシュー状態を未解決、解決、再登録、完了などの状態に設定できます
課題トラッカー設定 GitHub、GitLabなど、外部の課題トラッカーを設定して、該当イシューを外部課題トラッカーに登録できます。
検索ページで表示 クリックするとログ検索ページに移動します
タグ タグを追加したり、追加されたタグを変更、削除できます。
スタック追跡 クラッシュが発生した例外の種類、例外の原因およびスタックトレース情報を表示します。
エラーインスタンス エラーインスタンスリストを表示します。
ユーザー イシューを発生させたユーザーリストを表示します。
意見とヒストリー 該当イシューに対してコメントを作成でき、プロジェクト構成メンバーが作成したコメントリストを表示します。該当イシューに対する管理履歴(状態変更、タグ追加、コメント作成など)をタイムラインで表示します。

|ヒストリーグラフ| イシュー発生件数をタイムラインチャートとワールドマップで表示します。| |マトリックス情報| ネットワーク、OSバージョン、デバイス、サービスプロバイダー、国情報を表示します。|

イシュートレンド

lcs_07_201812

項目 説明
時間条件 統計時間条件を設定できます。
検索条件 エラータイプ - Crashes / Handled選択
プラットフォーム - アプリプラットフォーム選択
トレンドグラフ さまざまなトレンドグラフを見ることができます。
- クラッシュ数
- クラッシュが発生した端末
- OSバージョン別イシュー
- 端末別イシュー
- 国別イシュー

クラッシュレポート

lcs_08_201812

項目 説明
時間条件 統計時間条件を設定できます。
照会オプション 検索件数を調整できます。
検索条件 指標タイプ - 現在「アプリクラッシュ推移」のみ提供
プラットフォーム - アプリプラットフォーム選択
統計時間単位 - グラフ指標の時間単位選択(日間 / 週間)
クラッシュグラフ 検索期間内のクラッシュ発生数を表示します。
クラッシュ指標 検索期間内のアプリバージョン別セッション数/クラッシュ数/発生率(%)/前の期間のクラッシュ数/増加率(%)情報を提供します。

ユーザー別イシュー照会

ユーザー別クラッシュ発生情報を提供します。

  1. SDKでuser_idを設定する場合に使用可能で、保存しない場合、すべてのユーザーは'-'と表示されます。
  2. ユーザーは、ユーザーIDとデバイス名を組み合わせて区別します。すなわち、ユーザーIDが同じでもデバイスが異なれば、違うユーザーとして集計されます。

lcs_11_201812

項目 説明
時間条件 統計時間条件を設定できます。
検索条件 エラータイプ - システムで発生させるCrash統計とExceptionブロックでユーザーが発生させるHandledに区分
プラットフォーム - アプリプラットフォーム
アプリバージョン - アプリバージョン
ユーザー - SDKでuser_idに指定したユーザーID
端末 - デバイス名
ユーザー情報 アプリクラッシュユーザーの情報(デバイス、アプリバージョンなど)を表示します。

イシュー統計

lcs_12_201812

項目 説明
時間条件 統計時間条件を設定できます。
検索条件 エラータイプ - システムで発生させるCrash統計とExceptionブロックでユーザーが発生させるHandledに区分
プラットフォーム - アプリプラットフォーム
アプリバージョン - アプリバージョン
国 - イシューが発生したユーザーの国
OSバージョン - イシューが発生したデバイスのOSバージョン
クラッシュ別発生頻度円グラフ クラッシュ別の発生頻度を表示します。
クラッシュ別発生頻度順位テーブル クラッシュ別の発生頻度順位を表示します。

アラーム

ログおよびクラッシュに対するアラーム設定およびアラーム送信履歴を確認できます。 Data & Analytics > Log & Crash Search > アラームをクリックします。

ログアラーム設定

lcs_13_202108

ログアラームに対するすべての機能を実行できるページです。

  • アラームは発生数に応じたアラームと、ログの増減率に応じたアラームに区分されます。
  • アラームを受信したいログタイプ(Luceneクエリー)を登録し、該当ログが発生したら条件に応じてアラームを送信します。
  • [発生数]、[増減率]の2つのタイプのアラームがあります。
  • アラーム追加ボタンを押すと、アラームを登録できます。

lcs_14_202108

  • アラームの設定方法は次のとおりです。
    • アラームタイトル:アラーム設定リストに表示される名前を入力します。
    • アラームクエリー:アラームを受信したいログタイプをLuceneクエリーで入力します。
    • 説明:アラームの説明を入力します。
    • アラームタイプ:発生数または増減率でアラームタイプを設定します。
    • アラームタイプが発生数の場合
      • アラームルール:しきい値に適用される不等号を選択します。
      • しきい値:「検索条件」を満たすログが「アラームルール」不等号に応じて「しきい値」と同数発生したらアラームを送信します。
      • 発生周期:分単位で入力します。入力した時間値内にログが「しきい値」と同数発生したらアラームを送信します。
    • アラームタイプが増減率の場合
      • しきい値:「検索条件」を満たすログの増減率です。正の値はログが以前の間隔に比べて増加した比率。0は以前の間隔とログ量が同じ。負の値は以前の間隔よりログ量が減少した比率です。
      • 比較時間:時間単位で入力し、入力した時間間隔とそれ以前の間隔の間のログ量を「しきい値」に合わせて比較します。 「比較時間」中に発生したログの増減率が「しきい値」を満たすと、アラームを送信します。
    • スヌーズ:分単位で入力し、最小1分~最大1,440分(24時間)の間の値を設定します。(0は消える)
    • 受信者:アラームを受信する受信者を入力します。受信者ごとにメールとSMSを選択できます。
    • SMSアラーム文言:アラーム送信時にSMSで送信する文言を入力します。
    • コールバックURL:アラーム送信時に呼び出されるURLを入力します。 http(s)://とメール、Doorayフックをサポートします。

ログアラーム履歴

lcs_15_202108

  • 設定したアラームリストが表示されます。
  • リストをクリックすると、該当アラーム発生内容を確認できます。

クラッシュアラーム設定

lcs_16_202108

クラッシュログに対するアラームを別途設定する機能です。プラットフォーム(iOS、Android、Windows、WebGL)別にそれぞれ1つずつ登録できます。

アラーム設定方法は次のとおりです。

  • プラットフォーム:アラーム発生対象プラットフォームをiOS、Android、Windows、WebGLのうち1つを指定します。
  • 新規クラッシュアラーム設定:アラーム発生をOn/Off処理できます。
  • しきい値ベースのクラッシュアラーム設定:設定しきい値を超えると、アラームが作動するように設定します。探知周期は10分です。
    • アラームタイプ:クラッシュ発生数とクラッシュ発生率タイプがあります。
    • しきい値:クラッシュ発生数タイプはログ発生数(回数)を、クラッシュ発生率はログ発生確率(パーセント)を設定します。
  • SMS通知文言使用:有効にすると、障害内容の代わりにSMSアラーム文言に入力した内容がSMSで送信されます。
  • アラーム受信者:プロジェクトメンバーリストから、アラームを受信するユーザーのメール、 SMSを選択します。

クラッシュアラーム履歴

lcs_17_202108

クラッシュログアラームが発生した履歴を照会します。

  • プラットフォーム別に照会できます。
  • 時間条件を設定して照会期間を調整できます。
  • アラーム時間、プラットフォーム、クラッシュタイプ、しきい値、イベント数、配信方法および送信状態を提供します。

ユーザーべースのアラーム設定

lcs_18_202108

クラッシュが発生したユーザー比率がしきい値(%)以上の場合、指定されたユーザーの携帯電話またはメールにアラームを送信する機能を提供します。

アラーム設定方法は次のとおりです。

  • プラットフォーム:アラーム発生対象プラットフォームをiOS、Android、Windows、WebGLの中から1つを指定します。
  • ユーザー基盤アラーム設定:アラーム発生をON/OFF処理できます。
  • しきい値:クラッシュしたユーザー比率がしきい値(%)以上の場合、指定されたユーザーの端末またはメールにアラームを送信します。
  • SMSアラーム文言:有効にすると、障害内容の代わりにSMSアラーム文言に入力された内容がSMSで送信されます。
  • アラーム受信者:プロジェクトメンバーリストから、アラームを受信するユーザーのメール、SMSを選択します。

ユーザー基盤アラーム履歴

lcs_20_ja_20200602

ユーザー基盤アラームが発生した履歴を照会します。

  • プラットフォーム別に照会できます。
  • 時間条件を設定して、照会期間を調節できます。
  • アラーム時間、プラットフォーム、しきい値、クラッシュ発生ユーザー比率、配信方法および転送状態を提供します。

設定

検索フィールド管理、課題トラッカー設定、シンボルファイル管理などのサービスに必要な設定を管理します。

Data & Analytics > Log & Crash Search > 設定をクリックします。

検索フィールド

ログ検索時に使用される検索フィールドを照会する機能です。システムフィールドである基本フィールドリストの他に、ユーザー転送フィールドであるユーザー指定フィールド(カスタムフィールド)を確認できます。

lcs_20_202108

  1. ログ転送時、フィールド名がtxtで始まる場合、分析するかどうかがtrueに設定され、それ以外のフィールドは分析するかどうかがfalseに設定されます。分析するかどうかがfalseの場合、ログ検索の検索フィールドに登録して使用できます。
  2. ログファイルやバイナリファイルを転送して、ログ検索画面でダウンロード > 参照リンクを利用したい場合、 UserBinaryDataまたはUserTxtDataという名前のフィールドにbase64エンコードされた値を入れて転送してください。

イシュートラッキング

課題トラッカーを設定すると、アプリクラッシュ検索 > イシュー照会タブでイシューリストをクリックした時に表示されるError Detailページで、該当エラーを課題トラッカーに登録して管理できます。

lcs_21_202108

  • プラットフォーム: iOS、Android、Windows、WebGLのうち1つのプラットフォームを選択します。課題トラッカーはプラットフォーム別にそれぞれ設定可能です。
  • 課題トラッカー: GitHub、GitLabのうち1つを選択します。
  • GitHubプロジェクトURL:課題トラッカーをGitHubに選択する場合、https://github.com/{user}/{project}形式のURLを入力します。
  • Access token:課題トラッカーをGitHubに選択する場合、GitHubで作成したAccess tokenを入力します。(参照: https://help.github.com/articles/creating-an-access-token-for-command-line-use)
  • GitLabプロジェクトURL:課題トラッカーをGitLabに選択する場合、http://{baseUrl}/{namespace}/{project}形式のURLを入力します。
  • Private token:課題トラッカーをGitLabに選択する場合、GitLabサイトのMy profile - Accountで作成したtoken値を入力します。
  • Issue Title Format:イシュータイトルにバージョンおよび位置情報を含めるかどうかを選択します。
  • テスト:設定が正常かどうかを確認します。

シンボルファイル

Symbolication fileが登録されていると、クラッシュログを確認できます。このメニューではSymbolication fileをアップロード、ダウンロードして削除できます。

lcs_22_202108

[ファイル選択]をクリックして、シンボルファイルをアップロードします。

  • iOS: iOSシンボリケーションファイルをアップロードする時は、ZIP形式でBundleName.app.dSYMファイルを圧縮してください。
  • Android: Androidシンボリケーションをアップロードする時は、mapping.txtファイルをアップロードする必要があります。
  • Android-NDK: Android NDKファイルをアップロードする時は、ZIP形式でlib.soファイルを圧縮してください。
  • Windows: Windowsシンボリケーションファイルをアップロードする時は、ZIP形式でBundleName.symファイルを圧縮してください。
  • シンボルファイルの最大サイズは200MBです。
  • Android NDKシンボリケーションファイルが許可する最大ファイルサイズを超える場合、原本‘lib.so’バイナリファイルのテキスト形式シンボルを含んでいる1つの‘lib.so.sym’を含むZIPファイル形式でアップロードできます。
  • Android Unityの場合、シンボルファイルの登録が必要ありません。ただし、ProGuard適用時にmapping.txt.のアップロードが必要です。

ログ保管期間

ログ保管期間を照会できます。

lcs_23_202305

  • ログ保管期間を変更するにはサポートまでお問い合わせください。
  • ログ保管期間の変更は、翌月1日00時に適用され,保管期間に応じて料金が発生します。

ログ転送設定

サービスごとにログを送信するかどうかを設定します。

lcs_24_202108

  • 一般ログ、クラッシュログ、 Network Insightsログのそれぞれについて送信するかどうかを設定できます。
  • TOASK SDKに対して送信するかどうかを設定できます。
    • 重複ログ、ログレベル、ログタイプ別にフィルタリングできます。
  • 設定を保存した後,アプリを再起動すると適用されます。

ログ外部保管設定

ログ外部保管情報を設定します。

lcs_25_202312

  • 外部OBSにログを保管できます。

  • AWS S3 APIを利用して認証情報の登録および照会でアクセスキー(accessKey)と秘密鍵(secretKey)を取得します。

  • ログ外部保管設定保管設定をクリックします。
  • アクセスキーと秘密鍵をはじめとするデータを入力します。
  • 外部ログ改ざん通知に関する情報は、設定の追加/修正/削除時に全て必要です。
  • すべてのOBS情報を入力した後、保存をクリックします。

    • 連動検証のために設定したバケットに一時ファイルが作成されます。
  • 設定したOBSでログが保存されます。

  • NHN Cloud OBS API案内ガイド

ネットワークインサイト

Log & Crash Search SDKで送信した遅延時間とエラー率をタイムラインチャートとURLリスト、マップで表示します。

Data & Analytics > Log & Crash Search > ネットワークインサイトをクリックします。

  • SDKでは、クライアントからURL設定画面で設定したURLまでのリクエストの遅延時間(Latency)とステータス(Status)をLog & Crash Searchに送信します。
  • モニタリング、指標画面で現在のプラットフォームとフィルタを設定し,遅延時間とエラー率を確認できます。

モニタリング

  • 遅延時間とエラー率をタイムラインチャートとURLリストで表示します。

lcs_26_202108

項目 説明
フィルタ条件 - 最近:最近15分、60分、24時間、48時間の時間別照会フィルタ、ユーザー指定は開始/終了日を選択して照会(最大48時間)
- アプリバージョン:アプリバージョン別照会フィルタ
- OSバージョン: OSバージョン別照会フィルタ
- デバイス:デバイス名を入力
- サービスプロバイダー:サービスプロバイダー名を入力
- 国家:国別照会フィルタ
- URL: URL別照会フィルタ
チャート 遅延時間とエラー率がタイムラインチャートに表示されます。
現在のプラットフォーム ドロップダウンメニューでiOS、Android、WindowsおよびWebGLごとに設定できます。
URL URL設定で追加したURLごとに遅延時間とエラー率を表示します。

マップ

  • 遅延時間とエラー率をマップ上に表示します。

lcs_27_202108

項目 説明
マップタイプ マップタイプ:遅延時間およびエラー率のタイプを選択できます。
フィルタ条件 - 最近:最近15分、60分、24時間、48時間の時間別照会フィルタ、ユーザー指定は開始/終了日を選択して照会(最大48時間)
- アプリバージョン:アプリバージョン別照会フィルタ
- OSバージョン: OSバージョン別照会フィルタ
- デバイス:デバイス名を入力
- サービスプロバイダー:サービスプロバイダー名を入力
- 国家:国別照会フィルタ
- URL: URL別照会フィルタ
マップ 遅延時間とエラー率をマップ上に表示します。
現在のプラットフォームドロップダウンメニューからiOS、Android、Windows、WebGLごとに設定できます。

URL設定

  • 遅延時間とエラー率を測定するWebサイトのURLを設定できます。

lcs_28_202108

項目 説明
URL表 遅延時間とエラー率を測定するWebサイトURLリストを表示します。
右上の入力欄にURLを入力して追加できます。
削除する場合はリストをチェックした後、[選択項目を削除]をクリックすると選択した項目を削除できます。
TOP