크래시는 아닌데… 문제가 발생한 나의 코드, 어떻게 찾을까?

* 해당 포스트는  [이럴 땐 이렇게! 크래시편] 의 추가 가이드입니다.

앱에서 발생하는 장애의 종류는 매우 다양합니다. 하지만 이러한 장애로 인해 앱이 꺼지면 절대로 안 되겠죠.
IMQA는 앱 크래시가 발생한 경우 크래시 데이터를 자동으로 수집합니다. 그래서 고객이 앱을 사용하다 강제 종료되면, 그때 발생한 크래시 정보를 상세히 확인할 수 있습니다.

실제로 앱을 운영하다 보면 앱이 꺼지는 크래시가 아닌 비즈니스 로직에서 발생한 Exception이 고객의 장애로 이어지는 경우가 많은데요. 요즘 앱 사용 시 흔히 발생하는 장애를 통해 한번 확인해 볼까요?

💬 신입 개발자 복호 씨의 이야기

신입 개발자 복호 씨는 카카오 로그인 API의 APP_KEY가 만료되어 교체하여 앱을 배포하라는 업무를 받았습니다. debug 버전으로 깔끔하게 테스트를 하고, release 버전으로 Build Type을 바꾼 후 앱을 빌드 하여 마켓에 업로드하여 앱 버전을 업데이트 후 퇴근하였죠.

하지만 다음날 출근하니 로그인이 되지 않는 장애가 발생하고 있었고, 확인해 보니 debug 모드의 string.xml 파일과 release 모드의 string.xml 파일이 따로 존재하고 있음을 알게 되었습니다. debug 모드의 string.xml에 있는 app_key만 변경한 것입니다.

신입 개발자 복호 씨는 팀장님한테 크게 혼이 났고 IMQA로 Crash를 확인해 보았으나 수집된 크래시가 없다는 걸 확인하게 되었습니다.

요즘은 앱에서 로그인할 때 카카오나 네이버, 페이스북 등 간편한 로그인 연동을 대부분 이용하는데요. 위 사례처럼 오류가 발생한다면 고객이 이탈할 뿐만 아니라 브랜드 이미지까지 하락하기 때문에 반드시 관리가 필요합니다.

그렇다면, IMQA는 이러한 로그인 장애를 모니터링할 수 없었던 것일까요?

복호 씨의 앱을 살펴보죠.

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        KakaoSdk.init(this, "KAKAO_NATIVE_APP_KEY");
    }

}

앱의 Application 코드에서 KakaoSdk.init 을 통해 카카오 SDK를 올리고 있습니다.

이번 샘플 코드에서는 일부러 위와 같이 잘못된 APPKEY 값을 넣어보겠습니다.

public class MainActivity extends AppCompatActivity {
    private ImageButton btn_login;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        btn_login = findViewById(R.id.btn_login);

        btn_login.setOnClickListener(new View.OnClickListener(){
            @Override
            public void onClick(View v) {
                UserApiClient.getInstance().loginWithKakaoTalk(MainActivity.this,(oAuthToken, error) -> {
                    if (error != null) {
                        Log.e(TAG, "로그인 실패", error);
                    } else if (oAuthToken != null) {
                        Log.i(TAG, "로그인 성공(토큰) : " + oAuthToken.getAccessToken());

                        UserApiClient.getInstance().me((user, meError) -> {
                            if (meError != null) {
                                Log.e(TAG, "사용자 정보 요청 실패", meError);
                            } else {
                                System.out.println("로그인 완료");
                                Log.i(TAG, user.toString());
                                {
                                    Log.i(TAG, "사용자 정보 요청 성공" +
                                            "\\n회원번호: "+user.getId() +
                                            "\\n이메일: "+user.getKakaoAccount().getEmail());
                                }
                                Account user1 = user.getKakaoAccount();
                                System.out.println("사용자 계정" + user1);
                            }
                            return null;
                        });
                    }
                    return null;
                });

            }
        });

...

Activity 코드에서는 버튼에 카카오 로그인을 연결하는 로직을 넣었는데요.
디버깅을 위해 로그인 성공과 실패에 따라 로그를 넣어봤습니다.

일부러 잘못된 APPKEY를 넣고 앱을 실행하고 로그를 확인해 보겠습니다.

2022-09-14 20:41:53.235 com.kakaologin_sample E/사용자: 로그인 실패

다음과 같이 Logcat에서 로그인 실패 로그가 뜨는데요. 하지만 앱이 꺼지진 않았습니다.

이 경우, IMQA를 연동하면 해당 에러가 수집될까요?
IMQA CRASH는 크래시 정보를 수집하기 때문에 앱이 꺼지지 않으면 자동으로 수집하지 않습니다. 그렇다면, 크래시는 아니지만 위와 같은 장애는 과연 어떻게 수집할 수 있을까요?

답은 커스텀 에러를 설정하는 것입니다!

다음 소스코드에 커스텀 에러를 설정해 보겠습니다.

@Override
            public void onClick(View v) {
                UserApiClient.getInstance().loginWithKakaoTalk(MainActivity.this,(oAuthToken, error) -> {
                    if (error != null) {
                        Log.e(TAG, "로그인 실패", error);
                        **IMQACrashAgent.SendException((Exception) error, "ERROR TAG", ErrorRank.Major);**
                    } else if (oAuthToken != null) {
                        Log.i(TAG, "로그인 성공(토큰) : " + oAuthToken.getAccessToken());

                        UserApiClient.getInstance().me((user, meError) -> {
                            if (meError != null) {
                                Log.e(TAG, "사용자 정보 요청 실패", meError);
                            } else {
                                System.out.println("로그인 완료");
                                Log.i(TAG, user.toString());
                                {
                                    Log.i(TAG, "사용자 정보 요청 성공" +
                                            "\\n회원번호: "+user.getId() +
                                            "\\n이메일: "+user.getKakaoAccount().getEmail());
                                }
                                Account user1 = user.getKakaoAccount();
                                System.out.println("사용자 계정" + user1);
                            }
                            return null;
                        });
                    }
                    return null;
                });

            }

해당 코드의 5번째 라인 코드에 커스텀 에러를 전송하는 코드를 넣었습니다.

IMQACrashAgent.SendException((Exception) error, "ERROR TAG", ErrorRank.Major);

그럼, IMQA Crash에서 다음과 같이 Crash를 수집할 수 있게 됩니다.
이때 Major로 파라미터를 넣으면, 메이저 등급이 표시되는데요. 해당 크래시를 클릭하여 상세페이지로 접속하면 다음과 같이 에러가 발생한 스택 트레이스도 확인할 수 있습니다.

커스텀 로그도 기존 크래시 로그처럼 모든 기능을 똑같이 사용할 수 있습니다.

Intent를 통한 외부 앱 연동이나 요즘 많이 발생하는 3rd party 라이브러리에서의 에러는 크래시 솔루션에서 확인할 수 없습니다.

예를 들어, 고객이 결제 버튼을 눌렀는데 비즈니스 Exception이 발생하여 결제 실패를 할 수 있겠죠.
또한 금융권에서는 안전성을 위해 여러 가지 보안 인증 관련된 툴(백신, 위 변조 방지 프로그램, 난독화 솔루션 등)을 도입하는데요. 이러한 보안 모듈에서 통신 오류나 보안 KEY 연동 이슈로 장애가 발생합니다.
이 경우 앱이 종료된 것이 아니기 때문에 크래시로 확인할 수 없죠. 이 외에도 다양한 장애가 발생하지만, 단지 크래시 솔루션에는 수집되지 않기 때문에 놓치고 있는 것입니다.

위와 같은 상황에서 발생한 콜백 정보를 넣어서 커스텀 에러를 활용하면, 크래시 외 비즈니스에서 발생하는 모든 에러들을 모니터링할 수 있습니다.

여러분 앱  try~catch 블록에 IMQA의 커스텀 에러를 추가하면 어떨까요?커스텀 에러 설정 가이드도 확인해 보세요!
- 가이드 확인하기 (Android)
- 가이드 확인하기 (iOS)