NODE 說明

Jaeger Node.js（開發者的使用方法）

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

Darrius Serrant

更新:2025年6月22日

在當前的網頁開發中，生成文件並輕鬆追蹤系統互動的能力是至關重要的，因為效率和敏捷性是首要考量。各種行業的企業依賴於動態文件生成任務，例如製作發票、報告和證書。此外，他們需要監控和調試其應用程式中微服務之間的複雜互動。

開發者尋求可靠的解決方案，以提供徹底的跟踪功能以及有效的文件生成來滿足這些需求。 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 等存儲後端，為開發者提供選擇滿足其擴展性和恢復性需求的解決方案的靈活性。

社群支持和生態系統

一個充滿活力的開發者和貢獻者社群積極參與 Jaeger for Node.js 的開發和維護。生態系統與流行的監控和可觀察性工具整合，使 Jaeger for Node.js 容易融入現有的工作流程和工具鏈中。

創建和配置 Jaeger for Node.js

創建和配置 Jaeger for Node.js 涉及多個步驟，包括設置客戶端以將追踪數據發送至 Jaeger 收集器，將 Jaeger 客戶端整合到您的 Node.js 應用程式中，以及配置 Jaeger 基礎設施。以下是 Jaeger for Node.js 的設置指南。

安裝 Jaeger

使用 npm 安裝 Jaeger 的 Node.js 客戶端：

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 開放遙測收集器。這通常涉及指定收集器的地址及任何必要的認證憑證。

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 程式庫，使程式設計師可以在其 .NET 應用程式中創建、修改及顯示 PDF 文件。使用 IronPDF，開發者可以從各種來源以程式化的方式生成 PDF 文件，包括 HTML 文本、URL、圖片和現有的 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

使用 npm 安裝您的 Node.js 應用程式中所需的 IronPDF 依賴項：

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

SHELL

將 Jaeger for Node.js 與 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 創建，並在完成後結束 Jaeger 層。

如果在創建 PDF 過程中出現錯誤，我們會記錄錯誤並使用錯誤標記結束 Jaeger 層。您可以從 Jaeger UI 查看追踪以進行進一步分析。

Jaeger Node.js（如何為開發者服務）：圖 3