ikieEngineeringGet started
All posts

성능iOSAPI

화면은 그대로 두고, 앱이 서버에 덜 묻게 했어요

iOS 앱을 처음 열 때 요청 12개가 4개로, 일정 시트를 열 때 4개가 1개로 줄었어요. 화면과 모델은 따로 부르던 그대로 두고, 서버를 부르는 어댑터 밑에서 같은 순간의 부름을 묶었어요. 그러다 배포가 운영을 3분 멈춘 일까지 적어요.

English

시작은 "일정이 늦게 뜬다"는 느낌이었어요. 고치기 전에 먼저 쟀어요. 실제 계정으로 GET 밖의 요청은 모두 막은 재기용 빌드를 만들고, 서버를 부르는 어댑터 밑에서 실제로 나간 요청을 ms 단위로 찍었어요. 같은 경우를 세 번씩 재서 가운데 값을 썼고, 다 잰 뒤에는 그 빌드를 지웠어요.

처음 본 것은 이랬어요.

  • 앱을 처음 열 때 요청이 12개 나갔어요. 규칙, 캘린더, 플랜, 홈, 달마다 따로였어요.
  • 1분 안에 다시 앱으로 돌아오면 방금 "그대로"라고 답을 받은 달을 또 물었어요.
  • 일정을 하나 고칠 때마다 가지고 있던 다섯 달을 모두 다시 물었어요.

결과부터

처음지금
숫자로 보기
순간처음지금
처음 열기(기기에 아무것도 없을 때)12개4개
다시 열기6개3개
1분 안에 다시 앱으로 돌아오기6개1개
1분 넘어 앱으로 돌아오기7개2개
할 일 체크 한 번3개2개
1초 안에 다른 기기의 고침 푸시 다섯10개1개
300ms 간격으로 일정 셋 옮기기9개4개
일정 시트 열기4개1개
iOS 앱이 실제로 보낸 요청 수예요. 세 번씩 잰 가운데 값이에요. 처음 열기의 4개 중 하나는 언어 설정이 바뀔 때만 가서, 보통은 3개예요. 1분 넘어 돌아오기의 처음 값은 덜 묻기 뒤에 잰 거예요.

화면과 모델 코드는 거의 고치지 않았어요. 화면은 여전히 "이 달을 주세요", "홈을 주세요"를 따로 불러요. 바뀐 것은 덜 묻는 규칙과, 서버를 부르는 어댑터 한 겹이에요.

덜 묻기

첫 단계는 묻지 않아도 되는 것을 묻지 않는 거예요.

  • 1분 안에 답을 받은 달은 다시 묻지 않아요. 넘기기를 멈출 때, 앱을 열 때, 앞으로 돌아올 때 모두 같아요. 1분 안에 다시 앞으로 오면 요청이 6개에서 1개가 됐어요.
  • 고친 뒤에는 지금 달과 고친 달만 물어요. 가진 앞뒤 달은 화면에 보일 때 확인해요.

대신 같은 캘린더를 함께 쓰는 사람이 고친 것은 최대 1분 늦게 보일 수 있어요. 내가 다른 기기나 웹에서 고친 것은 바뀜 푸시가 와서 바로 다시 받아요.

같은 순간의 부름을 하나로

앱을 열면 여러 곳이 거의 같은 순간에 서버를 불러요. 요청마다 로그인 확인과 설정 읽기를 되풀이하고요. 그래서 이 부름들을 묶음 요청 하나(GET /api/v1/view)로 모아 보내고, 답을 찢어 부른 쪽마다 원래 모양으로 돌려줘요. GraphQL 세계에서 잘 알려진 DataLoader 방식이에요. 웹은 오픈소스 dataloader를 그대로 쓰고, iOS는 같은 방식의 작은 어댑터를 썼어요.

묶기는 서버를 부르는 어댑터 안에서만 해요. 화면과 모델은 따로 부르던 그대로이고, 묶음이 있는지 몰라요.

  • 모으는 시간은 아주 짧게. 달과 홈은 10ms 안의 부름만 모아요. 보이는 달이 묶기 때문에 늦어지면 안 되니까요.
  • 급하지 않은 것은 조금 기다려 같은 묶음에. 규칙, 캘린더, 플랜처럼 열 때 한 번 받는 것은 150ms 기다려 판 받기와 같은 묶음에 태워요.
  • 묶음이면 여러 달도 요청 하나. 앞뒤 달을 미리 받을 때 서버에 몰아 보내지 않으려고 둘씩 나눴던 상한을 풀었어요. 묶음 하나에 일곱 달까지 들어가니, 앞뒤 넷도 요청 하나예요.
  • 같은 GET은 하나만, 알림 기기 등록은 바뀔 때만.
숫자로 보기
단계처음 열기
처음12개
같은 순간의 달·홈 묶기7개
열 때의 것·앞뒤 달까지 묶기4개
단계마다 처음 열기의 요청 수예요. 보이는 달이 뜨는 때는 늦어지지 않았어요(2691ms → 2304ms).

묶음이 아닌 길도 그대로 둬요. 부름이 하나면 원래 요청을 그대로 보내고, 달·홈을 따로 받는 길(/days·/home)도 남아 있어요. 쓰기(캘린더 맞추기 같은 POST)는 읽기 묶음에 넣지 않아요. 그리고 묶기를 켠 것과 끈 것의 답이 같은지 시험해요.

고친 뒤와 푸시 뒤

읽기를 묶고 나니 쓰기 뒤가 남았어요.

  • 홈과 달을 같은 순간에. 고친 뒤 다시 받을 홈과 달을 같은 순간에 불러 묶음 하나로 보내요.
  • 연달아 오는 푸시는 한 번에. 웹이나 연결한 도구가 일정을 연달아 고치면 푸시도 연달아 와요. 1.5초 조용해질 때 한 번 받고, 계속 와도 첫 푸시에서 5초 안에는 받아요. 1초 안에 푸시 다섯이 오면 요청 10개가 1개가 됐어요.
  • 연달아 고치면 한 번에. 일정을 연달아 옮기면 500ms 조용해질 때 한 번 받아요. 화면은 먼저 반영으로 이미 바뀌어 있어서 기다리는 동안 보이는 것은 그대로예요.

체크 한 번이 1개가 아니라 2개인 까닭도 있어요. 쓰기 하나와 다시 받기 하나예요. 서버는 iOS가 쓴 것을 그 기기로 다시 푸시하지 않으니, 쓴 기기는 스스로 다시 받아야 해요.

쓰기 응답에 판을 싣지 않은 까닭

체크 한 번을 2개에서 1개로 만드는 길도 있었어요. 쓰기 응답에 바뀐 판을 실어 보내면 다시 받을 필요가 없어요. 이 안은 일부러 버렸어요. 쓰기 응답의 모양에 성능 장치가 들어가면, 쓰기 API를 부르는 모든 곳(웹, iOS, 연결한 도구)이 그 장치를 알게 되니까요.

성능 장치가 도메인에 영향을 주면 안 돼요. 끄면 따로 보내고, 켠 것과 끈 것은 같은 답이어야 해요.

시트 열기 4개를 1개로

일정을 눌러 시트를 열면 상세, 태그, 먼저 할 일, 안에 든 것을 따로 물었어요. 묶음 요청에 항목 하나의 몫을 더하고, 웹은 openapi-fetch의 fetch 자리에서 같은 순간 한 항목에 모인 GET을 묶어요. 시트 코드도, 따로 묻는 길도 그대로예요. 없는 몫은 따로 물을 때처럼 404로 돌려주고, 묶음의 몫이 따로 묻는 길과 같은 답인지 진짜 조립으로 견주는 시험이 지켜요.

iOS는 묶기만으로는 줄지 않았어요. 고르기 값과 태그 읽기가 시트를 그리는 동안 약 620ms 늦게 떠나서 묶음을 놓쳤어요. Swift 6에서 async let으로 띄운 자식 작업이 메인 스레드로 돌아와야 요청이 떠났고, 첫 화면을 그리는 동안 메인이 바빴던 거예요. 요청을 부른 자리에서 바로 떠나게 한 뒤에야 한 묶음에 모였어요. 상세가 떠나는 때도 시트를 연 뒤 620730ms에서 153165ms로 당겨졌어요.

서버도 덜 읽게

  • 로그인 확인은 60초 기억해요. 같은 의도의 다른 방법(Clerk의 60초 토큰, Better Auth의 보조 저장소)과 견주고 60초로 정했어요. 거둔 세션이 최대 60초 살아 있는 것과 맞바꾼 값이에요.
  • 연결한 도구(MCP)는 필요할 때만 읽어요. 플랜은 도구를 부를 때만 읽고, 연결하거나 도구 목록을 볼 때는 읽지 않아요. 도구 한 번이 먼저 읽던 DB 왕복이 56번에서 12번이 됐어요.

여기서 더 줄이지 않은 곳도 있어요. 연결한 도구의 동의는 요청 사이에 기억하면 한 번 더 줄일 수 있어요. 하지만 그러면 사용자가 거둔 권한이 잠시 살아 있어요. 그래서 동의는 한 요청 안에서만 한 번 읽어요.

맞추기의 헛일

운영 로그를 보다 캘린더 맞추기 한 번이 10초 넘게 걸리는 것을 찾았어요. Google의 공휴일 캘린더 둘이 이어 받기(syncToken)에도 일정 151개를 매번 다시 줬어요. 바뀐 것은 0개인데, 그때마다 우리는 묶음, 참석자, 이력을 302번씩 다시 썼어요. 이제 묶어 둔 판(etag)과 같은 판으로 온 일정은 읽지도 쓰지도 않아요.

이 캘린더들은 바뀌면 알려 주는 알림 걸기도 맞출 때마다 거절했어요(pushNotSupportedForRequestedResource). 거절을 사실로 적고, 엿새 동안은 다시 걸어 보지 않아요.

고치기 전고친 뒤
숫자로 보기
무엇고치기 전고친 뒤
맞추기 한 번10.9초2.2~3.7초
그중 DB 시간5.6초0.3~0.9초
쿼리 수1,332개54~126개
운영에서 잰 캘린더 맞추기(POST /api/v1/calendars/sync) 한 번이에요.

배포가 운영을 3분 멈췄어요

이 맞추기 고침을 배포할 때 사고가 있었어요. 표에 칸 하나를 더하는 마이그레이션(alter table)이 다른 연결이 쥔 잠금을 기다렸어요. Postgres에서는 잠금을 기다리는 쪽 뒤로 그 표를 읽는 요청도 모두 줄을 서요. 그래서 그 표를 읽는 판, 캘린더, 연결한 도구 요청이 약 3분 동안 멈췄어요. 판 요청 하나가 116초, 도구 요청 하나가 190초 걸렸어요.

  • 잠금은 3초만 기다려요. 마이그레이션은 lock_timeout을 3초로 두고, 못 잡으면 놓았다가 다시 해요. 8번까지 해도 못 잡으면 빌드를 실패시켜 지금 배포를 그대로 둬요.
  • 함께 지은 빌드끼리는 줄을 세워요. 트랜잭션 잠금(pg_advisory_xact_lock)으로 한 번에 하나만 돌고, 앞 빌드가 적용한 파일은 건너뛰어요.
  • 늦게 합쳐진 파일은 그 파일만. 이름 차례가 앞선 새 파일이 늦게 합쳐지자, "바뀐 파일부터 그 뒤 파일까지 다시"라는 규칙 때문에 이미 적용한 뒤 파일이 다시 돌아 표를 또 잠갔어요. 그 재실행으로 60초가 한 번 더 멈췄어요. 이제 새 파일만 돌려요.

기다리는 값은 모두 한 곳에

10ms, 150ms, 500ms, 1.5초(최대 5초), 1분. 이 글에 나온 기다리는 값은 모두 웹과 iOS가 나눠 쓰는 앱 정책 파일 한 곳에 데이터로 있어요. 화면이나 어댑터 코드에 숫자를 적지 않아요. 웹(TypeScript)과 iOS(Swift)는 각자의 해석기로 이 정책을 읽고, 두 해석기를 같은 시나리오 파일로 함께 시험해요. iOS만 쓰는 값도 같은 파일에 어느 플랫폼이 쓰는지와 함께 적혀 있어요.

배운 것

  • "보이는 달 먼저"는 처음 그릴 때만 뜻이 있어요. 이미 그려져 있으면 나눠 보내는 것이 손해예요. 그래서 이미 그린 달은 앞뒤 달과 함께 받아요.
  • 모으기에는 두 값이 필요해요. 마지막 것 뒤의 조용함, 그리고 첫 것에서의 최대 기다림이요. 그리고 기다리는 값은 실제 손 빠르기로 재서 경계에 걸리지 않게 정해요.
  • 묶었는데 줄지 않으면 떠나는 때를 봐요. 묶음은 같은 순간에 떠난 부름만 모아요. iOS에서는 동시성 모델 때문에 부름이 늦게 떠나고 있었어요.
  • 보안 불변식이 최적화를 이겨요. 거둔 권한이 살아 있게 하는 기억은 빨라도 하지 않아요.
  • 재는 장치부터 믿을 수 있게. 실제 계정은 읽기만 하는 빌드로 쟀어요. 숫자를 믿을 수 있어야 고친 것도 믿을 수 있어요.

1만 명을 채워 본 글에서 서버 쪽 이야기를, 이 글에서 앱이 서버에 묻는 쪽 이야기를 했어요.

The ikie teamikie is a calendar for your events and to-dos in one place. Here we write about the problems we run into while building it, and how we solve them.