NODE 說明

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

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

Darrius Serrant

更新:2025年6月22日

在目前以效率和敏捷性為首要目標的 Web 開發中，輕鬆產生文件和追蹤系統互動的能力至關重要。各行各業的企業都依賴動態文件產生任務，例如產生發票、報表和憑證。此外，他們還需要監控和調試應用程式中微服務之間複雜的互動。

為了滿足這些需求，開發人員正在尋找可靠的解決方案，這些方案既要提供全面的追蹤功能，又要能有效地產生文件。 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 適用於 Node.js 的使用者友善 Web 介面，開發人員可以視覺化和分析追蹤資料。此介面可提供有關係統性能的寶貴信息，幫助識別瓶頸並解決問題。依賴關係圖、追蹤聚合和服務級監控等功能可協助開發人員優化系統效能。

可擴展性和彈性

Jaeger for Node.js具有水平可擴展性，使開發人員能夠有效地管理大量追蹤資料。它支援 Elasticsearch、Cassandra 和 Kafka 等儲存後端，使開發人員能夠靈活地選擇滿足其可擴展性和彈性需求的解決方案。

社區支持與生態系統

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

建立並配置適用於Node.js 的Jaeger

為Node.js建立和配置 Jaeger 涉及多個步驟，包括設定客戶端以向 Jaeger 收集器發送追蹤資料、將 Jaeger 用戶端整合到您的Node.js應用程式中以及配置 Jaeger 基礎架構。以下是關於如何為Node.js設定Jaeger的指南。

Jaeger 安裝

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

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，而 span.finish() 在處理程序執行完畢時完成 span。

配置 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庫，允許程式設計師在其.NET應用程式中建立、修改和顯示 PDF 文件。使用IronPDF，開發人員可以從各種來源（包括 HTML 文字、URL、圖像和現有 PDF 文件）以程式方式產生 PDF 文件。

Jaeger Node.js （開發者使用方法）：圖 2

讓我們更詳細地了解IronPDF的各項功能：

HTML 轉 PDF

IronPDF使開發人員能夠輕鬆地將 HTML 內容轉換為 PDF 文件。透過提供 HTML 輸入，開發人員可以建立具有格式、圖形和樣式的視覺效果豐富的 PDF 文件。

URL 轉 PDF

IronPDF允許開發人員直接從 URL 生成 PDF 文檔，因此非常適合捕獲網頁內容或從 Web 應用程式動態生成的內容。

圖像轉 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 span。 IronPDF用於執行 PDF 創建，完成後我們完成 Jaeger span。

如果在建立 PDF 時出現錯誤，我們會記錄錯誤並使用錯誤標籤結束 Jaeger span。您可以透過 Jaeger 使用者介面查看追蹤資訊以進行進一步分析。

Jaeger Node.js （開發者使用方法）：圖 3