Game > Gamebase > Android SDK使用ガイド > Logger

ここではLog & Crash Search転送APIを使用する方法を説明します。

Initialize

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());
    }
}

Send Logs

Log & Crash Serverにログを転送します。 NHN Cloud Logger SDKは、下記の5つのレベルのログを転送できます。

  • DEBUG
  • INFO
  • WARN
  • ERROR
  • FATAL

ログレベルは次のとおりです。

  • DEBUG > INFO > WARN > ERROR > FATAL

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);

Set User-Defined Fields

ユーザー定義フィールドを設定します。

ユーザー定義フィールドを設定すると、ログ転送APIを呼び出すたびに設定した値をログと一緒にサーバーに転送します。

API

+ (void)setUserField(String field, Object value);

Example

Gamebase.Logger.setUserField("KEY", "VALUE");

Further Tasks after Sending Logs

リスナー(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
    }
});

Use Handled Exception API

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);
}
TOP