ここではLog & Crash Search転送APIを使用する方法を説明します。
Log & Crash Searchで発行したAppKeyでNHN Cloud Logger SDKを初期化します。
アプリ起動直後に発生するクラッシュログも漏れなく転送するにはApplication.onCreate()でNHN Cloud Loggerを初期化する必要があります。
API
+ (void)initialize(Context context, LoggerConfiguration configuration);
Example
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Initialize TOAST Logger
final String LOG_AND_CRASH_APPKEY = "AaBbCcDdEeFfGgHh";
final boolean sendCrashLog = true;
final LoggerConfiguration.Builder configBuilder = LoggerConfiguration.newBuilder(
LOG_AND_CRASH_APPKEY, sendCrashLog);
Gamebase.Logger.initialize(context, configBuilder.build());
}
}
Log & Crash Serverにログを転送します。 NHN Cloud Logger SDKは、下記の5つのレベルのログを転送できます。
ログレベルは次のとおりです。
API
+ (void)debug(String message);
+ (void)info(String message);
+ (void)warn(String message);
+ (void)error(String message);
+ (void)fatal(String message);
+ (void)debug(String message, Map<String, String> userFields);
+ (void)info(String message, Map<String, String> userFields);
+ (void)warn(String message, Map<String, String> userFields);
+ (void)error(String message, Map<String, String> userFields);
+ (void)fatal(String message, Map<String, String> userFields);
+ (void)debug(String format, Object... args);
+ (void)info(String format, Object... args);
+ (void)warn(String format, Object... args);
+ (void)error(String format, Object... args);
+ (void)fatal(String format, Object... args);
Example
// Default
Gamebase.Logger.debug("Message", userField);
// With userFields
final Map<String, String> userField = new HashMap<>();
userField.put("KEY", "VALUE");
Gamebase.Logger.debug("Message", userField);
// Formatted string
final String val1 = "myValue1";
final String val2 = "maValue2";
Gamebase.Logger.debug("VALUE1: %s, VALUE2: %s", val1, val2);
ユーザー定義フィールドを設定します。
ユーザー定義フィールドを設定すると、ログ転送APIを呼び出すたびに設定した値をログと一緒にサーバーに転送します。
API
+ (void)setUserField(String field, Object value);
Example
Gamebase.Logger.setUserField("KEY", "VALUE");
リスナー(listener)を登録すると、ログ転送後、追加作業を進行できます。
API
+ (void)setLoggerListener(LoggerListener listener);
Example
Gamebase.Logger.setLoggerListener(new LoggerListener() {
@Override
public void onSuccess(@NotNull LogEntry logEntry) {
// Sending logs succeeded
}
@Override
public void onFilter(@NotNull LogEntry logEntry, @NotNull LogFilter logFilter) {
// The logs were filtered out and not sent.
}
@Override
public void onSave(@NotNull LogEntry logEntry) {
// If log transmission fails due to network disconnection, the log is saved in a file for log retransmission.(The saved file cannot be checked.)
}
@Override
public void onError(@NotNull LogEntry logEntry, @NotNull GamebaseException exception) {
// Sending logs failed
}
});
Androidプラットフォームでは、try/catch構文で例外に関する内容をNHN Cloud LoggerのHandled Exception APIを使用して送信できます。 このように送信した例外ログは、コンソールでLog & Crash Search > アプリクラッシュ検索をクリックし、エラータイプのHandledをクリックして照会できます。 詳しいLog & Crashコンソールの使用方法はコンソール使用ガイドを参照してください。
API
+ (void)report(String message, Throwable throwable);
+ (void)report(String message, Throwable throwable, Map<String, String> userFields);
Example
try {
// User Codes...
} catch (Exception e) {
final Map<String, Object> userFields = new HashMap<>();
userField.put("KEY", "VALUE");
Gamebase.Logger.report("message", e, userFields);
}