信息圖標
跳過到頁腳內容
  1. IronPDF for Node.js
  2. IronPDF for Node.js 博客
  3. Node 說明
  4. Jaeger Node.js
NODE 說明

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

Darrius Serrant
Darrius Serrant
更新日期:

在當前注重效率和靈活性的網頁開發中，擁有生成文件和輕鬆追蹤系統交互的能力至關重要。 各行各業的企業依賴於動態文件生成任務，比如生成發票、報告和證書。 此外，他們需要監控和調試其應用程式中微服務之間的複雜交互。

開發者尋找可靠的解決方案，這些方案能夠提供徹底的追蹤功能以及有效的文件生成，以滿足這些需求。 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 (How It Works For Developers): Figure 1

中介軟體整合

Jaeger for Node.js 提供了中介軟體，簡化了 HTTP 路由的追蹤植入。 它與流行的 Node.js 框架如 Express.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 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 (How It Works For Developers): Figure 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 安裝 IronPDF 的必要依賴到你的 Node.js 應用中：

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

整合 Jaeger for Node.js 與 IronPDF 創建 PDF

結合了 Jaeger for Node.js 與 IronPDF，為開發者提供了一種增強文件生成流程和獲取系統行為洞察的強大選擇。

通過將分佈式追蹤功能與順暢的 PDF 生成整合，開發者能夠優化流程、提高效率並提供更好的用戶體驗。 讓我們探討如何在 Node.js 應用中使用 Jaeger for Node.js 整合 IronPDF：

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 (How It Works For Developers): Figure 3

結論

總之，結合 Jaeger for Node.js 和 IronPDF 提供了一種增強文件生成流程和獲取系統行為洞察的強大解決方案。 通過整合順暢的 PDF 創建和分佈式追蹤功能，開發者能優化流程、提高效率，並在其 Node.js 應用中提供更好的用戶體驗。

開發者可以透過提供的代碼範例，將 Jaeger for Node.js 與 IronPDF 整合來發揮這些工具的全部潛能。 當企業優先考慮在構建強大且可擴展並具高效益的 Node.js 應用時，這種協同作用變得越來越有價值。

IronPDF 以捆綁包購買時提供合理的定價，並包含終身許可。 僅需 $799，該套件價值極佳，可以一次購買用於多個系統。 許可持有者可獲得全年全天候的線上工程支持。 欲知定價詳情，請訪問網站。欲知 Iron Software 提供產品的更多信息，請訪問其網站。

Darrius Serrant
Darrius Serrant
  立即與工程團隊聊天
全棧軟件工程師 (WebOps)

Darrius Serrant 擁有邁阿密大學計算機科學學士學位，目前任職於 Iron Software 的全栈 WebOps 市場營銷工程師。從小就迷上編碼，他認為計算既神秘又可接近，是創意和解決問題的完美媒介。

在 Iron Software，Darrius 喜歡創造新事物，並簡化複雜概念以便於理解。作為我們的駐場開發者之一，他也自願教學生，分享他的專業知識給下一代。

對 Darrius 來說，工作令人滿意因為它被重視且有實際影響。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用