This is a slide to explain how to manage error logs and analytics logs in Android. This slide was presented at Genestream Android tips study group.

1. ログ管理でウキウキ
Android Life
2014/11/20
Mercari Inc.
今井智章

2. 自己紹介
• 株式会社メルカリ Android エンジニア(2014.3~)
!
!
!
!
!
!
フリマアプリの機能開発、USアプリ開発
• 以前はSIerでインフラ系DBエンジニア(たまにjava開発)
2
twitter: tomoaki_imai
github: tomoima525
qiita: tomoima525

3. Agenda
• ウキウキするエラー系ログ管理のお話
• ウキウキする分析系ログ管理のお話
3

4. エラーログとは

5. ユーザーの声にならない
叫び

6. ユーザーの声として上がるのはほんの一部です

7. エラーログ、見ましょう
バグ、駆逐しましょう

8. メルカリでのエラー監視
• Google Developer Console
• Crashlytics
• 自前でのリアルタイムエラーレポート
8

9. Google Developer Console
• apkをGoogle playに上げる時に時のアレ
• アプリがクラッシュし、ユーザーがエラーレポー
ト送付してくれた内容が見られる
- なので大体氷山の一角
• Crashlyticsで拾えないネイティブクラッシュが
確認できる
9

10. Crashlytics
• 言わずと知れた有名エラーレポートサービス
• 導入が超簡単。レポートも詳細。
• テスト配信機能も有り
• 最近はアカウント作成待10ちの行列ができてる

11. 使い方
• 一番最初に起動するActivityで呼ぶだけ
!
@Override
public void onCreate(Bundle savedInstanceState) {
com.crashlytics.android.Crashlytics.start(this);
!
• クラッシュ時の情報を添付することもできる
11
}
com.crashlytics.android.Crashlytics.setString(
"last_activity", this.getClass().getName());

12. 使い方
!
• メルカリではdev,stg,productでパッケージ名を分け、
それぞれでログ監視
• テスト、QAレベルでエラーログを拾う
12

13. 自前エラーレポート
• エラー用Apiでクラッシュ時に送信
• より詳細に状況を把握し、バグ解消に活かす
• 以下の３点が実装のポイント
①予期せずエラーが起きてもレポートを飛ばす仕組み
②既知のバグの発生条件を調査できる仕組み
③レポートを貯めて送る仕組み
13

14. 仕組み
①予期せずエラーが起きてもレポートを飛ばす
仕組み
public class ThisApplication extends Application
implements Thread.UncaughtExceptionHandler {
@Override
public void uncaughtException(Thread thread, final Throwable ex) {
new Thread() {
public void run() {
ByteArrayOutputStream b = new ByteArrayOutputStream();
ex.printStackTrace(new PrintStream(b));
String errMessage = b.toString();
gotoErrorActivityAndReport(errMessage); //エラーレポートをAPIに送る
System.exit(1);
};
}.start();
14
}
Applicationクラス内でThread.UncaughtExceptionHandlerを実装

15. 仕組み
②既知のバグの発生条件を調査できる仕組み
すでにErrorが発生すると判明している部分で、try/catchし、
catch内で調査に必要な情報を送る
try {
return BitmapFactory.decodeFileDescriptor(fileDescriptor, null, options);
} catch (OutOfMemoryError ooe) {
postErrorReport(getCurrentActivity().getClass().getName()
, options.inSampleSize
, options.outWidth
, reqWidth); //画像処理系で画像サイズ情報を送信
15
}

16. レポートをプリファレンスに保存し、レポート送信前にクラッシュ
したり通信できなくても、次回起動時に送付できるようにする
public void sendErrorReportInternal(final JSONObject errReport) {
String errMessage = JSONUtil.getString(errReport, S.message);
if (errMessage != null) {
Api.process(errReport, new responseListener<JSONObject>() {
@Override
public void onResponse(JSONObject response) {}
@Override
public void onErrorResponse(JSONObject response) {
ErrorStore.addErrReport(errReport); //プリファレンスに保存 }
//以下略
仕組み
③レポートを貯めて送る仕組み
public void onResume() {
sendOldErrorReports(); //以前のレポートがあった場合は送信
}
16

17. まとめ
• Crashlyticsで届かないかゆいところに自前エ
ラーレポートを組み合わせるとバグ駆逐が捗る
Google
Analytics Crashlytics 自前
17
ログのわかりや
すさ△ ◯ ◎
カスタマイズ性☓ △ ◎
導入容易性default ◯ △

18. ウキウキしましたか？

19. 続いて、分析ログの話

20. What is 分析ログ？
• インストール率, DAU, 売上, A/B testing etc.
を分析するためのログ
• 用途によって様々なサービスがある
20

21. 分析ログ(サービス)の問題点
• それぞれの分析サービスのApiに標準性がない
- 似たようなトラッキングコードをひたすら書かされる
- その割にApiごとに癖があって実装に困る
- 新しいライブラリを追加する度に導入の調査が必要になる
21

22. そうだ、Segment
使おう

23. Segment
• 複数の分析サービスを統合できる
• シンプルなAPIで導入が簡単
• けどかなり詳細に分析データを送信できる！
23

24. Segment
• SegmentのApiで多くの分析サービスをカバー
• ユーザーはコンソールから分析サービスを選ぶ
だけ
24

25. 実装例
• 事前準備
- アカウントの用意
- https://segment.com/
- プロジェクトの作成
- 組織単位でproject作成が可能
- API keyを確認
25
こちらにまとめました↓
http://qiita.com/tomoima525/items/bab086d341b686b9f8a1

26. 実装例
• gradleのdependencies追加(Android Studio)
dependencies {
compile('com.segment.analytics.android:core:+@aar') {
transitive = true
}
//必要なライブラリのみ追加
compile 'com.google.android.gms:play-services:+'
compile ‘com.mixpanel.android:mixpanel-android:+@aar'
}
!
!
!
Eclipse向けにjarファイルもある(ただしバージョンは古い)
!
• AndroidManifest.xmlへの設定
<uses-permission android:name=“android.permission.INTERNET”/> //必須
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.READ_LOGS"/>
<uses-permission android:name="android.permission.GET_TASKS"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
26

27. 実装例
• res/values/analytics.xmlにAPI keyを設定
<resources>
<string name="analytics_write_key">YOUR_WRITE_KEY</string>
<string name="analytics_logging">true</string>
<integer name="analytics_queue_size">20</integer>
</resources>
analytics_write_key:
コンソールで確認したApi key
analytics_logging:
logに送信データが出力
うまく確認できなかった。iOSでは見られる？
analytics_queue_size:
一度のキューで送信するイベントの数
キューがたまらなくても一定時間で送信されている様子
27

28. 代表的なトラッキングメソッド
• identify
アプリユーザーのIDを設定する
Analytics.with(context).identify(user_id);
複数のTraits(特徴)を設定することも可能
Analytics.with(context).identify(new Traits().putName(“Moge Hoge"));
Analytics.with(context).identify(
new Traits().putEmail(moge@hoge.com"));
Traitsはage, gender等多数あり、分析サービスに応じて設定可能
https://segment.com/docs/api/tracking/identify/#special-traits

29. 代表的なトラッキングメソッド
• Alias
会員登録前後のIDを紐つけ、会員登録前のイベントを関連付けする
Mixpanel、Flurryといった分析サービスで利用
Analytics.with(context).alias(uuid, new_id);
//会員登録前のIDがない場合はSegment内のanonymousIDが紐付けられる
※Segmentのエンジニア曰く統合がまだ十分でないらしく、
今後も変わる可能性あり

30. 代表的なトラッキングメソッド
• Track
あらゆるイベントにプロパティ、トラック名をつけてトラックする
Properties properties = new Properties()
.putValue("price", price)
.putValue("category", CategoryId); //オブジェクト型を設定できる
Analytics.with(context).track(trackName, properties);
プロパティは任意のキーを設定できる

31. デバッガー
• コンソールデバッガーで値を確認できる
{
"messageId": "09361829-c11c-451d-83d0-d1e2e9fc9063",
"type": "track",
"anonymousId": "d6c327e4-76c3-418c-907e-4b0eba89ec40",
// 中略
"timestamp": "2014-11-19T11:34:54.000Z",
"event": "Eat Curry",
"properties": {
"price": 1200,
"category": "Indian",
"condition": "good",
},
}
値はjsonでも取得可能

32. 分析
• コンソールから分析サービスを選ぶ
それぞれの分析サービスに必要なIDやkeyを設定するだけ

33. 分析ツールの追加があっても
ライブラリ、ソースコードの
追加は(ほとんど)不要

34. スッキリ

35. ちょっと注意
• 成長中のサービスなので、開発がさかん
• Documentの記述が食い違っている所もある
• ソースコードが食い違っている所がある(!)
• オープンソースなのでおかしかったら迷わずPR
35

36. まとめ
• エラーログ管理はカスタマイズするとバグ駆逐
が捗ってウキウキ
• 分析ログはSegment使うと楽ちん、スッキリで
ウキウキ
36

37. メルカリではAndroid/iOSエンジニア募集中！