CLS (Continuation local storage)

스레드를 활용한 프로그래밍에서는 실행되는 스레드의 컨텍스트로 한 요청에 대한 공통 스토리지(TLS)를 활용할 수 있습니다. 싱글스레드인 자바스크립트의 실행환경인 Node.js 에서는 TLS 와 비슷한 기능을 활용하기 위해 CLS 라는 개념을 만들었고, 이를 이용하면 요청에 대한 컨텍스트를 유지할 수 있습니다.

CLS 는 Thread local storage 처럼 동작하지만 스레드 대신 노드 스타일의 콜백 체인을 기반으로 하는 스토리지입니다. 일반적인 사용방법으로는, cls namespace 를 생성하고 요청에 CLS Context 를 생성하면 실행되는 비동기 리소스에 대해 일련의 체인을 형성합니다. 자세한 사항은 아래에서 확인할 수 있습니다.

cls-hooked: https://github.com/Jeff-Lewis/cls-hooked logging with cls hooked: https://blog.goncharov.page/nodejs-logging-made-right

CLS 는 typeORM, Sequelize 와 같은 ORM 에서의 transaction propagation, logging request ID 유지 등에 사용될 수 있습니다.

EventEmitter

cls-rtracer 와 같은 라이브러리를 보면 내부에서 이벤트를 bind 하는 경우를 확인할 수 있습니다. request / response 에 정의되어있는 몇몇 이벤트는 다른 컨텍스트에서 실행될 수 있다고 합니다.

cls-rtracer: https://github.com/puzpuzpuz/cls-rtracer Proposal: https://github.com/nodejs/node/issues/33723

async_hooks

async_hooks 는 비동기 리소스를 추적할 수 있는 메서드를 제공합니다. Node.js 에서 CLS 를 구현하는 것에 이용됩니다. 아직 Experimental 인 기능이지만, Google 의 Tracer 내부에서 이를 이용하여 CLS 를 구현한 것을 보면 일반적인 경우에는 사용해도 무방할 듯 합니다.

nodejs async_hooks: https://nodejs.org/api/async_hooks.html

비동기 리소스

비동기 리소스는 비동기 작업의 일부로 생성되며, 비동기 작업을 추적하는것에 사용되는 객체입니다. 비동기 작업이 완료되면 콜백이 실행되며 완벽히 종료되면 가비지컬렉팅 됩니다.

https://yceffort.kr/2021/08/async-resources-async-hooks

async_hooks 성능 이슈

https://news.ycombinator.com/item?id=19310213

Todo

async_hooks proposal https://docs.google.com/document/d/1g8OrG5lMIUhRn1zbkutgY83MiTSMx-0NHDs8Bf-nXxM/edit#heading=h.6kknmf22ixwc https://docs.google.com/document/d/1y4lF-iQhhuSOgzlPIBbfCT4IUpg-in3az5Q87C7aY3Q/edit#