상태와 메트릭

Akan 앱이 느리거나 응답하지 않을 때는 두 가지 런타임 endpoint부터 확인하세요. Health는 앱이 살아있는지 알려주고, metrics는 얼마나 바쁜지 알려줍니다.

`/_akan/app/health`는 gateway와 child process 상태를 확인합니다.
`/_akan/app/metrics`는 request, socket, room, memory를 확인합니다.
숫자의 이유가 필요하면 metrics 다음에 log를 확인하세요.

Health 확인

앱이 열리지 않는다면 health를 먼저 보세요. Gateway가 실행 중인지, child server가 준비되었는지 확인할 수 있습니다.

Health endpoint

단순화한 응답 예시

Metrics 확인

앱은 살아있지만 바빠 보일 때 metrics를 보세요. 트래픽, WebSocket 부하, room, 프로세스 메모리를 빠르게 볼 수 있습니다.

Metrics endpoint

단순화한 응답 예시

읽는 방법

`activeRequests`는 현재 처리 중인 request입니다. 계속 높다면 느린 endpoint가 작업을 막고 있을 수 있습니다.
`activeWebSockets`와 `rooms`는 realtime 연결 부하를 이해하는 데 도움이 됩니다.
`rssBytes`와 `heapUsedBytes`는 메모리 크기를 보여줍니다. 한 번의 값보다 추세를 보세요.
`rscPendingRenderCount`는 서버 렌더링 작업이 대기 중인지 볼 때 힌트가 됩니다.

메모리 로그

한 번의 metrics 응답으로 메모리 문제를 잡기 어렵다면 주기적인 메모리 로그를 켜고 값이 시간에 따라 어떻게 바뀌는지 보세요.

유용한 env

`AKAN_MEMORY_LOG=1`은 메모리 요약을 주기적으로 출력합니다.
`AKAN_MEMORY_LOG_INTERVAL_MS`는 출력 주기를 바꿉니다.
`AKAN_MEMORY_GC_ON_REPORT=1`은 보고 전에 GC를 실행해 진단에 도움을 줍니다.

확인 순서

Health를 봅니다. Child가 ready가 아니거나 unhealthy라면 먼저 시작 문제를 해결합니다.
Metrics를 봅니다. Active request, socket, room, memory를 확인합니다.
메모리가 계속 늘면 memory log를 켜고 여러 샘플을 비교합니다.
어떤 endpoint, queue, render path가 원인인지 app log로 확인합니다.

상태와 메트릭

Akan 앱이 느리거나 응답하지 않을 때는 두 가지 런타임 endpoint부터 확인하세요. Health는 앱이 살아있는지 알려주고, metrics는 얼마나 바쁜지 알려줍니다.

`/_akan/app/health`는 gateway와 child process 상태를 확인합니다.
`/_akan/app/metrics`는 request, socket, room, memory를 확인합니다.
숫자의 이유가 필요하면 metrics 다음에 log를 확인하세요.

Health 확인

앱이 열리지 않는다면 health를 먼저 보세요. Gateway가 실행 중인지, child server가 준비되었는지 확인할 수 있습니다.

Health endpoint

단순화한 응답 예시

Metrics 확인

앱은 살아있지만 바빠 보일 때 metrics를 보세요. 트래픽, WebSocket 부하, room, 프로세스 메모리를 빠르게 볼 수 있습니다.

Metrics endpoint

단순화한 응답 예시

읽는 방법

`activeRequests`는 현재 처리 중인 request입니다. 계속 높다면 느린 endpoint가 작업을 막고 있을 수 있습니다.
`activeWebSockets`와 `rooms`는 realtime 연결 부하를 이해하는 데 도움이 됩니다.
`rssBytes`와 `heapUsedBytes`는 메모리 크기를 보여줍니다. 한 번의 값보다 추세를 보세요.
`rscPendingRenderCount`는 서버 렌더링 작업이 대기 중인지 볼 때 힌트가 됩니다.

메모리 로그

한 번의 metrics 응답으로 메모리 문제를 잡기 어렵다면 주기적인 메모리 로그를 켜고 값이 시간에 따라 어떻게 바뀌는지 보세요.

유용한 env

`AKAN_MEMORY_LOG=1`은 메모리 요약을 주기적으로 출력합니다.
`AKAN_MEMORY_LOG_INTERVAL_MS`는 출력 주기를 바꿉니다.
`AKAN_MEMORY_GC_ON_REPORT=1`은 보고 전에 GC를 실행해 진단에 도움을 줍니다.

확인 순서

Health를 봅니다. Child가 ready가 아니거나 unhealthy라면 먼저 시작 문제를 해결합니다.
Metrics를 봅니다. Active request, socket, room, memory를 확인합니다.
메모리가 계속 늘면 memory log를 켜고 여러 샘플을 비교합니다.
어떤 endpoint, queue, render path가 원인인지 app log로 확인합니다.