결제 서비스

이 서비스는 주문에 대한 신용카드 결제를 처리하는 역할을 한다. 신용카드가 유효하지 않거나 결제를 처리할 수 없으면 오류를 반환한다.

결제 서비스 소스

제로 코드 계측

이 Node.js 기반 서비스는 오픈텔레메트리(OpenTelemetry) Node.js 제로 코드 계측을 사용하며, 시작 시 @opentelemetry/auto-instrumentations-node/register 모듈을 불러와 설정한다. 내보내기 엔드포인트, 리소스 속성, 서비스 이름은 환경 변수를 기반으로 자동 설정된다. 이는 서비스의 package.json 시작 스크립트나 NODE_OPTIONS를 통해 설정할 수 있다.

"scripts": {
  "start": "node --require @opentelemetry/auto-instrumentations-node/register index.js"
}

트레이스

자동 계측된 스팬에 속성 추가하기

자동 계측된 코드가 실행되는 동안 컨텍스트에서 현재 스팬을 가져올 수 있다.

const span = opentelemetry.trace.getActiveSpan();

스팬에 속성을 추가하려면 스팬 객체의 setAttributes를 사용한다. chargeServiceHandler 함수에서는 속성의 키/값 쌍을 담은 익명 객체(맵)를 사용하여 스팬에 속성을 추가한다.

span?.setAttributes({
  'demo.payment.amount': parseFloat(`${amount.units}.${amount.nanos}`).toFixed(
    2,
  ),
});

스팬 예외 및 상태

스팬 객체의 recordException 함수를 사용하여 처리된 오류의 전체 스택 트레이스를 포함하는 스팬 이벤트를 생성할 수 있다. 예외를 기록할 때는 스팬의 상태도 그에 맞게 설정해야 한다. charge.js의 charge 함수에서 이를 확인할 수 있다.

span.recordException(err);
span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });

메트릭

미터와 인스트루먼트(Instrument) 생성하기

@opentelemetry/api 패키지를 사용하여 미터를 생성할 수 있다. 아래와 같이 미터를 생성한 다음, 생성한 미터를 사용하여 인스트루먼트를 생성할 수 있다.

const { metrics } = require('@opentelemetry/api');

const meter = metrics.getMeter('payment');
const transactionsCounter = meter.createCounter('demo.payment.transactions');

미터와 인스트루먼트는 계속 유지하며 사용해야 한다. 즉, 가능하면 미터나 인스트루먼트를 한 번 가져온 뒤 필요에 따라 재사용해야 한다.

로그

추후 작성 예정

배기지(Baggage)

이 서비스는 오픈텔레메트리 배기지를 사용하여 요청이 합성 요청(부하 생성기에서 보낸 요청)인지 확인한다. 합성 요청에는 요금을 청구하지 않으며, 이를 스팬 속성으로 나타낸다. 실제 결제를 처리하는 charge.js 파일에는 배기지를 확인하는 로직이 있다.

// check baggage for synthetic_request=true, and add charged attribute accordingly
const baggage = propagation.getBaggage(context.active());
if (
  baggage &&
  baggage.getEntry('synthetic_request') &&
  baggage.getEntry('synthetic_request').value === 'true'
) {
  span.setAttribute('demo.payment.charged', false);
} else {
  span.setAttribute('demo.payment.charged', true);
}