푸터 콘텐츠로 바로가기
  1. Node.js용 IronPDF
  2. Node.js용 IronPDF 블로그
  3. 노드 도움말
  4. Jaeger Node.js
노드 도움말

Jaeger Node.js (개발자를 위한 작동 방식)

다리우스 세란트
다리우스 세란트
업데이트됨:

문서를 쉽게 생성하고 시스템 상호 작용을 추적할 수 있는 기능은 효율성과 민첩성이 최우선시되는 현대 웹 개발에서 필수적입니다. 다양한 분야의 기업들은 송장, 보고서, 증명서 발행과 같은 역동적인 문서 제작 작업에 의존합니다. 또한, 애플리케이션 내 마이크로서비스 간의 복잡한 상호 작용을 모니터링하고 디버깅해야 합니다.

개발자들은 이러한 요구 사항을 충족하기 위해 효과적인 문서 생성과 더불어 철저한 추적 기능을 제공하는 신뢰할 수 있는 솔루션을 찾고 있습니다. Jaeger for Node.js 와 IronPDF 의 조합은 놀라울 정도로 효과적이며, 개발자에게 Node.js 애플리케이션에서 문서 생성 및 추적을 효율적으로 관리할 수 있는 방법을 제공합니다. Jaeger for Node.js 와 IronPDF 가 어떻게 함께 작동하는지 살펴보면 개발자는 안정적이고 확장 가능하며 효율적인 애플리케이션을 만들 수 있습니다.

Jaeger 분산 추적 시스템의 핵심 구성 요소인 Jaeger for Node.js 는 Node.js 애플리케이션에 강력한 추적 기능을 제공합니다. 이를 통해 개발자는 마이크로서비스 전반에 걸친 요청 및 상호 작용의 흐름을 매우 자세하게 이해할 수 있습니다. Jaeger for Node.js 개발자에게 유용한 도구인 주요 특징들을 살펴보겠습니다.

Jaeger Node.js (개발자를 위한 작동 방식): 그림 1

미들웨어 통합

Jaeger for Node.js 는 HTTP 경로 추적을 위한 계측을 간소화하는 미들웨어를 제공합니다. Express.js와 같은 인기 있는 Node.js 프레임워크와 원활하게 통합되어 개발자가 애플리케이션에 분산 추적 기능을 쉽게 추가할 수 있습니다.

분산 컨텍스트 전파

Jaeger for Node.js 는 마이크로서비스 간의 분산 컨텍스트 전파를 지원하여 서비스 간에 추적 데이터를 손쉽게 전송할 수 있도록 합니다. 이 기능을 통해 개발자는 시스템 내 서비스 경계를 ​​넘나드는 요청을 추적하고 추적 기록을 생성할 수 있습니다.

샘플링 전략

Jaeger for Node.js 유연한 샘플링 전략을 제공하여 개발자가 사용자 지정 샘플링 함수, 경로 및 요청 헤더를 포함한 다양한 기준에 따라 수집되는 추적 데이터의 양을 제어할 수 있도록 합니다. 이를 통해 트래픽이 많은 상황에서도 추적 오버헤드를 제어할 수 있습니다.

OpenTracing 호환성

Jaeger for Node.js OpenTracing 표준을 준수하므로 개발자는 기존 OpenTracing 라이브러리와 계측 도구를 활용할 수 있습니다. 이러한 휴대성은 Jaeger를 기존 분산 추적 생태계에 쉽게 통합할 수 있도록 하며 다른 추적 시스템과의 상호 운용성을 보장합니다.

풍부한 시각화 및 분석

Jaeger for Node.js의 사용자 친화적인 웹 인터페이스를 통해 개발자는 추적 데이터를 시각화하고 분석할 수 있습니다. 이 인터페이스는 시스템 성능에 대한 유용한 정보를 제공하여 병목 현상을 파악하고 문제를 해결하는 데 도움을 줍니다. 종속성 그래프, 추적 집계 및 서비스 수준 모니터링과 같은 기능은 개발자가 시스템 성능을 최적화하는 데 도움이 됩니다.

확장성 및 복원력

Jaeger for Node.js 는 수평 확장성을 자랑하며, 개발자가 대량의 추적 데이터를 효과적으로 관리할 수 있도록 지원합니다. 이 플랫폼은 Elasticsearch, Cassandra, Kafka와 같은 스토리지 백엔드를 지원하므로 개발자는 확장성과 복원력 요구 사항에 맞는 솔루션을 유연하게 선택할 수 있습니다.

지역사회 지원 및 생태계

활발한 개발자 및 기여자 커뮤니티가 Node.js 용 Jaeger의 개발 및 유지 관리에 적극적으로 참여하고 있습니다. Jaeger for Node.js 는 널리 사용되는 모니터링 및 관찰 도구와 통합되어 기존 워크플로 및 툴체인에 쉽게 통합할 수 있습니다.

Node.js 용 Jaeger를 생성하고 구성합니다.

Node.js 용 Jaeger를 생성하고 구성하는 데에는 여러 단계가 포함됩니다. 여기에는 Jaeger 수집기로 추적 데이터를 전송하도록 클라이언트를 설정하는 것, Jaeger 클라이언트를 Node.js 애플리케이션에 통합하는 것, 그리고 Jaeger 인프라를 구성하는 것이 포함됩니다. 다음은 Node.js 용 Jaeger 설정 방법에 대한 안내입니다.

예거 설치

Node.js에 대한 Jaeger 클라이언트를 설치하려면 npm을 사용하세요:

npm install jaeger-client
npm install jaeger-client
SHELL

Jaeger 인프라 설정

Jaeger를 Node.js 애플리케이션에 통합하기 전에 Jaeger 인프라를 설정해야 합니다. 여기에는 Jaeger 수집기, 쿼리 서비스 및 스토리지 백엔드(예: Elasticsearch 또는 Cassandra) 배포가 포함됩니다. Docker, Kubernetes를 사용하거나 Jaeger 백엔드 구성 요소를 수동으로 인프라에 배포할 수 있습니다. Jaeger 백엔드에 대한 자세한 설정 지침은 Jaeger 설명서에서 확인할 수 있습니다.

Jaeger 클라이언트 초기화 및 구성

Node.js 애플리케이션에서 Jaeger 클라이언트를 초기화하고 구성하십시오. 일반적으로 애플리케이션이 시작될 때 이 작업을 수행합니다. 다음은 Jaeger 인스턴스 구성 설정 예시입니다.

const { initTracer } = require('jaeger-client');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
  },
};

// Initialize Jaeger tracer
const tracer = initTracer(config);
const { initTracer } = require('jaeger-client');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
  },
};

// Initialize Jaeger tracer
const tracer = initTracer(config);
JAVASCRIPT

이 예시에서는 다음과 같습니다.

  • serviceName은(는) Node.js 서비스의 이름을 지정합니다.
  • sampler은(는) 추적 데이터에 대한 샘플링 전략을 구성합니다. 이 예제에서는 샘플링 속도가 1인 고정 샘플러를 사용하므로 모든 트레이스가 기록됩니다.
  • reporter은(는) 추적 데이터 보고를 구성하고, logSpans이(가) true로 설정되면 콘솔에 추적 스팬을 기록합니다.

추적을 위한 애플리케이션 도구를 준비하세요

Jaeger 에이전트가 실행되면 애플리케이션에 계측 도구를 추가하여 추적 정보를 수집하십시오. 이는 HTTP 엔드포인트 요청 처리기 또는 함수 호출과 같은 코드의 핵심 부분에 추적 도구를 추가하는 것을 의미합니다.

다음은 Express.js 라우트 핸들러 내에서 HTTP 계측을 사용하는 예입니다.

app.get('/api/users', (req, res) => {
  const span = tracer.startSpan('get_users');
  // Business logic
  span.finish();
  res.send('Users data');
});
app.get('/api/users', (req, res) => {
  const span = tracer.startSpan('get_users');
  // Business logic
  span.finish();
  res.send('Users data');
});
JAVASCRIPT

이 예제에서는 tracer.startSpan()이(가) /api/users 라우트 핸들러의 스팬을 생성하며, span.finish()이(가) 핸들러 실행이 완료되면 스팬을 완료합니다.

Jaeger 클라이언트가 추적 데이터를 전송하도록 구성

Jaeger 클라이언트가 추적 데이터를 Jaeger OpenTelemetry 수집기로 전송하도록 구성합니다. 일반적으로 이는 수집기의 주소와 필요한 인증 자격 증명을 지정하는 것을 포함합니다.

const { initTracer } = require('jaeger-client');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
    collectorEndpoint: 'http://jaeger-collector:14268/api/traces', // Address of Jaeger collector
  },
};

const tracer = initTracer(config);
const { initTracer } = require('jaeger-client');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
    collectorEndpoint: 'http://jaeger-collector:14268/api/traces', // Address of Jaeger collector
  },
};

const tracer = initTracer(config);
JAVASCRIPT

이 경우 collectorEndpoint은(는) 추적 데이터가 전송될 Jaeger 수집 노드의 주소를 나타냅니다.

시작하기

IronPDF 란 무엇인가요?

Iron Software의 IronPDF 는 프로그래머가 .NET 애플리케이션 내에서 PDF 문서를 생성, 수정 및 표시할 수 있도록 하는 강력한 .NET 라이브러리입니다. IronPDF 사용하면 개발자는 HTML 텍스트, URL, 이미지 및 기존 PDF 파일을 포함한 다양한 소스에서 PDF 문서를 프로그래밍 방식으로 생성할 수 있습니다.

Jaeger Node.js (개발자를 위한 작동 방식): 그림 2

IronPDF의 기능을 좀 더 자세히 살펴보겠습니다.

HTML을 PDF로 변환

IronPDF 개발자가 HTML 콘텐츠를 PDF 파일로 간단하게 변환할 수 있도록 해줍니다. 개발자는 HTML 입력을 제공함으로써 서식, 그래픽 및 스타일을 적용하여 시각적으로 풍부한 PDF 문서를 만들 수 있습니다.

URL을 PDF로 변환

IronPDF 사용하면 개발자는 URL에서 직접 PDF 문서를 생성할 수 있으므로 웹 페이지 콘텐츠 또는 웹 애플리케이션에서 동적으로 생성된 콘텐츠를 캡처하는 데 이상적입니다.

이미지를 PDF로 변환

IronPDF 이미지 파일(PNG, JPEG, BMP)을 PDF 문서로 변환할 수 있습니다. 이 기능은 사진 앨범을 만들거나 PDF 파일에 이미지를 삽입하는 데 유용합니다.

PDF 문서 편집 및 조작

IronPDF 기존 PDF 문서를 편집하고 조작할 수 있습니다. 개발자는 프로그래밍 방식으로 PDF 문서에 텍스트, 이미지, 주석, 워터마크 및 기타 요소를 추가하여 필요에 맞게 문서를 사용자 지정할 수 있습니다.

IronPDF를 설치하세요

Node.js 애플리케이션에서 IronPDF에 필요한 종속성을 설치하려면 npm을 사용하세요:

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

Node.js 용 Jaeger와 IronPDF 를 통합하여 PDF를 생성하는 방법

Jaeger for Node.js 와 IronPDF 결합하면 문서 생성 프로세스를 개선하고 시스템 동작에 대한 통찰력을 얻고자 하는 개발자에게 강력한 선택지를 제공합니다.

분산 추적 기능을 원활한 PDF 생성 기능과 통합함으로써 개발자는 워크플로를 최적화하고 효율성을 향상시키며 더 나은 사용자 경험을 제공할 수 있습니다. Jaeger for Node.js 사용하여 IronPDF Node.js 애플리케이션에 통합하는 방법을 살펴보겠습니다.

const { initTracer } = require('jaeger-client');
const IronPdf = require('@ironsoftware/ironpdf');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
    collectorEndpoint: 'http://jaeger-collector:14268/api/traces',
  },
};

// Initialize Jaeger tracer
const tracer = initTracer(config);

app.get('/generate-pdf', (req, res) => {
  // Start Jaeger span for PDF generation
  const span = tracer.startSpan('generate_pdf');

  // HTML content for PDF generation
  const htmlContent = `
  <html>
  <head>
    <title>Sample PDF</title>
  </head>
  <body>
    <h1>Hello, IronPDF!</h1>
  </body>
  </html>
  `;

  // Generate PDF document
  IronPdf.HtmlToPdf.RenderHtmlAsPdf(htmlContent)
    .then((pdfBuffer) => {
      // Finish Jaeger span for PDF generation
      span.finish();

      // Save PDF to file or send as response
      res.setHeader('Content-Type', 'application/pdf');
      res.send(pdfBuffer);
    })
    .catch((error) => {
      // Log error and finish Jaeger span with error
      console.error('PDF generation error:', error);
      span.setTag('error', true);
      span.log({ event: 'error', message: error.message });
      span.finish();
      res.status(500).send('PDF generation error');
    });
});
const { initTracer } = require('jaeger-client');
const IronPdf = require('@ironsoftware/ironpdf');

// Configuration for Jaeger client
const config = {
  serviceName: 'my-nodejs-service',
  sampler: {
    type: 'const',
    param: 1,
  },
  reporter: {
    logSpans: true,
    collectorEndpoint: 'http://jaeger-collector:14268/api/traces',
  },
};

// Initialize Jaeger tracer
const tracer = initTracer(config);

app.get('/generate-pdf', (req, res) => {
  // Start Jaeger span for PDF generation
  const span = tracer.startSpan('generate_pdf');

  // HTML content for PDF generation
  const htmlContent = `
  <html>
  <head>
    <title>Sample PDF</title>
  </head>
  <body>
    <h1>Hello, IronPDF!</h1>
  </body>
  </html>
  `;

  // Generate PDF document
  IronPdf.HtmlToPdf.RenderHtmlAsPdf(htmlContent)
    .then((pdfBuffer) => {
      // Finish Jaeger span for PDF generation
      span.finish();

      // Save PDF to file or send as response
      res.setHeader('Content-Type', 'application/pdf');
      res.send(pdfBuffer);
    })
    .catch((error) => {
      // Log error and finish Jaeger span with error
      console.error('PDF generation error:', error);
      span.setTag('error', true);
      span.log({ event: 'error', message: error.message });
      span.finish();
      res.status(500).send('PDF generation error');
    });
});
JAVASCRIPT

PDF 생성 코드의 실행을 추적하기 위해 해당 프로세스에 대한 새로운 Jaeger 스팬을 시작합니다. IronPDF 사용하여 PDF를 생성하고, PDF 생성이 완료되면 Jaeger 스팬을 완료합니다.

PDF 생성 중에 오류가 발생하면 오류를 기록하고 Jaeger 스팬을 오류 태그로 종료합니다. Jaeger UI에서 추적 정보를 확인하여 추가 분석을 진행할 수 있습니다.

Jaeger Node.js (개발자를 위한 작동 방식): 그림 3

결론

결론적으로, Jaeger for Node.js 와 IronPDF 결합하면 문서 생성 프로세스를 개선하고 시스템 동작에 대한 통찰력을 얻을 수 있는 강력한 솔루션을 제공합니다. 개발자는 원활한 PDF 생성 및 분산 추적 기능을 통합함으로써 Node.js 애플리케이션에서 워크플로를 최적화하고 효율성을 높이며 더 나은 사용자 경험을 제공할 수 있습니다.

개발자는 제공된 코드 예제를 사용하여 Jaeger for Node.js IronPDF 와 통합함으로써 이러한 도구의 잠재력을 최대한 활용할 수 있습니다. 기업들이 강력하고 확장 가능하며 성능이 뛰어난 Node.js 애플리케이션을 구축할 때 효율성과 혁신을 우선시함에 따라 이러한 시너지 효과는 점점 더 중요해지고 있습니다.

IronPDF 패키지 상품으로 구매할 경우 합리적인 가격을 제공하며 평생 라이선스가 포함되어 있습니다. 패키지는 $799에 불과하며 여러 시스템에 대해 한 번만 구입할 수 있는 훌륭한 가치를 제공합니다. 라이선스 소지자는 연중무휴 24시간 온라인 엔지니어링 지원을 받을 수 있습니다. 가격에 대한 자세한 정보는 웹사이트를 방문하십시오. Iron Software 에서 제공하는 제품에 대한 추가 정보는 해당 웹사이트를 방문하십시오.

다리우스 세란트
다리우스 세란트
  지금 바로 엔지니어링 팀과 채팅하세요
풀스택 소프트웨어 엔지니어 (웹 운영)

다리우스 세런트는 마이애미 대학교에서 컴퓨터 과학 학사 학위를 받았으며, Iron Software에서 풀 스택 웹 운영 마케팅 엔지니어로 근무하고 있습니다. 어린 시절부터 코딩에 매료되었던 그는 컴퓨팅이 신비로우면서도 접근하기 쉬운 분야라고 생각했고, 창의력과 문제 해결 능력을 발휘하기에 완벽한 매체라고 여겼습니다.

Iron Software에서 다리우스는 새로운 것을 만들고 복잡한 개념을 단순화하여 더 쉽게 이해할 수 있도록 하는 것을 즐깁니다. 그는 사내 개발자로서 학생들을 가르치는 데에도 자원하여 차세대 인재들과 전문 지식을 공유하고 있습니다.

다리우스에게 있어 그의 일은 가치 있고 실질적인 영향을 미치기 때문에 보람 있는 일입니다.

관련 기사

30일 무료 체험 → 모든 기능 이용 가능. 제한 없음. 카드 정보 필요 없음. 무료 체험 시작하기

아이언 서포트 팀

저희는 주 5일, 24시간 온라인으로 운영합니다.
채팅
이메일
전화해