Application Real-Time Monitoring Service:Node.js アプリケーションのデータをレポートする

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• ご利用のマシンに Node.js がインストールされていること

• プロジェクトに jaeger-client の依存関係が追加されていること：

    "dependencies": {
        "jaeger-client": "^3.12.0"
    }

• Jaeger または Zipkin コレクターのエンドポイント（下記の「コレクターのエンドポイントを取得する」セクションを参照）

コレクターのエンドポイントを取得する

1. OpenTelemetry 向けマネージドサービスコンソールにログインします。

2. 左側のナビゲーションウィンドウで、クラスター設定 をクリックします。その後、アクセスポイント情報 タブをクリックします。

3. 上部のナビゲーションバーでリージョンを選択します。クラスター情報 セクションで、トークンを表示 を有効にします。

4. クライアント セクションで、Jaeger または Zipkin をクリックします。

5. 関連情報 列からエンドポイントをコピーします。

   

アプリケーションのインストルメント化

const initTracer = require("jaeger-client").initTracer;

const config = {
    serviceName: 'node-service',
    sampler: {
        type: "const",
        param: 1
    },
    reporter: {
        collectorEndpoint: "<endpoint>"
    },
};

const tracer = initTracer(config);

const span = tracer.startSpan("say-hello");

// メタデータをキーと値のペアとしてタグとしてアタッチ（トレース詳細ビューに表示されます）
span.setTag("tagKey-01", "tagValue-01");

// タイムスタンプ付きのログエントリを記録（スパンのログタイムラインに表示されます）
span.log({event: "timestamp", value: Date.now()});

// スパンを完了してコレクターに送信します
span.finish();

Express を使用した完全な例

この例では Express アプリケーションをインストルメント化します。すべての着信リクエストがスパンでラップされ、/api ルートに対してログエントリが記録されます。

const express = require("express");
const initTracer = require("jaeger-client").initTracer;
const app = express();

const config = {
    serviceName: 'node-service',
    sampler: {
        type: "const",
        param: 1
    },
    reporter: {
        collectorEndpoint: "<endpoint>"
    },
};
const tracer = initTracer(config);

// ミドルウェア：すべての着信リクエストに対してスパンを開始
app.all('*', function (req, res, next) {
    req.span = tracer.startSpan("say-hello");
    next();
});

// ルートハンドラ：タイムスタンプをログに記録し、スパンを完了
app.get("/api", function (req, res) {
    const span = req.span;
    span.log({event: "timestamp", value: Date.now()});
    req.span.finish();
    res.send({code: 200, msg: "success"});
});

app.listen(3000, '127.0.0.1', function () {
    console.log('start');
});

<endpoint> をご利用のコレクターのエンドポイントに置き換え、アプリケーションを実行します：

node app.js

テストリクエストを送信します：

curl http://127.0.0.1:3000/api

期待される応答：

{"code":200,"msg":"success"}

プレースホルダー

コードを実行する前に、以下のプレースホルダーを実際の値に置き換えてください。

参考資料

• jaeger-client-node — Node.js 向け Jaeger クライアントライブラリ

• opentracing-javascript — JavaScript 向け OpenTracing API