결제 서비스
이 서비스는 주문에 대한 신용카드 결제를 처리하는 역할을 한다. 신용카드가 유효하지 않거나 결제를 처리할 수 없으면 오류를 반환한다.
제로 코드 계측
이 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);
}
피드백
이 페이지가 도움이 되었나요?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!