ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

Node.js EventEmitterとメッセージキューによるイベント駆動型マイクロサービス

Aug. 01, 2025
# Misc

Takashi Yamamoto

Infrastructure Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "Node.js EventEmitterとメッセージキューによるイベント駆動型マイクロサービス"

はじめに

今日のペースの速いデジタル世界では、堅牢でスケーラブルなアプリケーションが不可欠です。システムが複雑化するにつれて、モノリシックアーキテクチャはしばしばボトルネックとなり、開発速度とデプロイメントの柔軟性を妨げます。このため、アプリケーションを疎結合で独立してデプロイ可能なサービスのコレクションとして構造化するアーキテクチャスタイルであるマイクロサービスが広く採用されるようになりました。マイクロサービスは多くの利点を提供しますが、これらの分散コンポーネント間での通信のオーケストレーションと状態管理を効果的に行うことは、新たな課題をもたらします。この記事では、Node.js EventEmitter をメッセージキューと組み合わせて、効率的なイベント駆動型マイクロサービスアーキテクチャのバックボーンをどのように形成できるかを探り、非同期通信、強化された疎結合、および応答性の向上を可能にします。基本的な概念、実践的な実装の詳細、そしてこのパターンが回復力のある分散システムを構築する上でもたらす重要な価値を探求します。

堅牢な分散システムの構築

EventEmitter とメッセージキューの組み合わせの真の力を理解するには、まず関係するコアコンセプトを把握することが不可欠です。

  • マイクロサービス: サービス指向アーキテクチャ（SOA）アーキテクチャスタイルのバリアントであり、アプリケーションを疎結合されたサービスのコレクションとして整理するソフトウェア開発技術です。各サービスは自己完結型であり、通常は単一のビジネス機能に焦点を当てています。
  • イベント駆動アーキテクチャ（EDA）: コンポーネントがイベントの生成と消費を通じて通信するアーキテクチャパターンです。「イベント」とは、「注文完了」や「ユーザー登録」のような、状態の重要な変化です。EDAは疎結合、スケーラビリティ、および応答性を促進します。
  • Node.js EventEmitter: 1つのプロセス内でのイベント駆動型プログラミングを容易にするコアNode.jsモジュールです。名前付きイベントを発行するオブジェクトを可能にし、登録された Function オブジェクトを呼び出させます。プロセス内通信のためのシンプルな発行/購読メカニズムと考えてください。
  • メッセージキュー: サーバーレスおよびマイクロサービスアーキテクチャで使用される非同期サービス間通信の一形態です。メッセージは、消費サービスが処理するまで一時的に格納されます。一般的な例としては、RabbitMQ、Apache Kafka、AWS SQSなどがあります。これらは仲介者として機能し、発行者と消費者を疎結合にし、バッファリング、信頼性、およびスケーリングを提供します。

相乗効果：EventEmitter とメッセージキュー

その核心において、イベント駆動型マイクロサービスアーキテクチャは、直接的なリクエストではなくイベントを通じて通信するサービスで繁栄します。EventEmitter は内部のプロセス内イベント処理に優れていますが、プロセス間またはサービス間通信のために設計されているわけではありません。ここでメッセージキューが不可欠になります。

UserService が新しいユーザーを作成するシナリオを考えてみてください。UserService 内では、ローカルモジュール（例：ロギング、ローカルキャッシュの更新）が反応するために EventEmitter を使用して userCreated イベントを発行することがあります。しかし、EmailService や BillingService のような他のマイクロサービスも、この新しいユーザーに通知される必要があります。これらのサービスを UserService から直接呼び出すと、タイトな結合が導入されます。

代わりに、UserService は UserCreated イベントをメッセージキューに発行できます。購読者として機能する EmailService と BillingService は、このキューを購読してイベントを独立して処理できます。これにより、以下が達成されます。

  • 疎結合: サービスはお互いの存在を知る必要はなく、発行または消費するイベントについてのみ知っていればよい。
  • 非同期処理: サービスは自身のペースでイベントを処理できるため、システム全体の応答性と耐障害性が向上する。
  • スケーラビリティ: メッセージキューはイベントの急増を処理でき、サービスは独立してスケールできる。
  • 回復力: 消費サービスが一時的にダウンした場合、メッセージはキューに残っており、サービスが回復したときに処理できる。

Node.js を使用した実践的な例でこれを説明しましょう。

例：注文処理マイクロサービス

3つのマイクロサービスを持つ e コマースアプリケーションを想像してください。

  1. 注文サービス: 新しい注文の作成を処理します。
  2. 支払いサービス: 注文の支払いを処理します。
  3. 通知サービス: 電子メール通知を送信します。

Order Service 内の内部イベントには Node.js EventEmitter を使用し、サービス間通信には仮想的なメッセージキュー（単純な MessageQueueClient で表される）を使用します。

注文サービス（発行者）

// order-service/index.js
const EventEmitter = require('events');
const messageQueueClient = require('./messageQueueClient'); // 簡単化されたMQクライアント

class OrderServiceEmitter extends EventEmitter {}
const orderEvents = new OrderServiceEmitter();

// 注文作成のシミュレーション
function createOrder(orderData) {
    const order = { id: Math.random().toString(36).substr(2, 9), ...orderData, status: 'pending' };
    console.log(`Order Service: Creating order ${order.id}`);

    // 内部イベント：注文サービス内のリスナーに通知
    orderEvents.emit('orderPending', order);

    // 他のサービスのためにメッセージキューにイベントを発行
    messageQueueClient.publish('order_events', {
        type: 'OrderCreated',
        payload: order
    });

    return order;
}

// 例：内部リスナー
orderEvents.on('orderPending', (order) => {
    console.log(`Order Service: Internal listener - Order ${order.id} is pending.`);
    // ここでローカルキャッシュを更新したり、他の内部タスクを実行したりする可能性があります
});

// APIエンドポイントを公開するシミュレーション
function handleCreateOrderRequest(req, res) {
    const newOrder = createOrder(req.body);
    res.status(201).json(newOrder);
}

// ... handleCreateOrderRequest のための express アプリケーション設定
// order-service/messageQueueClient.js (単純化されたプレースホルダー)
module.exports = {
    publish: (topic, message) => {
        console.log(`Order Service: Publishing to topic '${topic}':`, message);
        // 実際のアプリケーションでは、これは RabbitMQ、Kafka などに送信されます。
        // ローカルテストのために、単純化のために遅延または直接呼び出しをシミュレートする可能性があります
        // しかし、原則は非同期メッセージングです。
    },
    subscribe: (topic, handler) => {
        console.log(`Order Service: Subscribing to topic '${topic}' (client side)`);
        // 通常、発行者サービスが自身のイベントのために直接使用することはありません
    }
};

支払いサービス（購読者）

// payment-service/index.js
const messageQueueClient = require('./messageQueueClient'); // 同じMQクライアント

function processPayment(order) {
    console.log(`Payment Service: Processing payment for order ${order.id}...`);
    // 支払い処理ロジックのシミュレーション
    setTimeout(() => {
        const paymentSuccessful = Math.random() > 0.1; // 90% の成功率
        if (paymentSuccessful) {
            console.log(`Payment Service: Payment for order ${order.id} successful.`);
            // 他のサービスのために支払い成功イベントを発行
            messageQueueClient.publish('payment_events', {
                type: 'PaymentApproved',
                payload: { orderId: order.id, amount: order.amount }
            });
        } else {
            console.warn(`Payment Service: Payment for order ${order.id} failed.`);
            messageQueueClient.publish('payment_events', {
                type: 'PaymentFailed',
                payload: { orderId: order.id, reason: 'Failed to authorize' }
            });
        }
    }, 1500); // ネットワーク遅延/処理時間をシミュレート
}

// 注文作成イベントを購読
messageQueueClient.subscribe('order_events', (event) => {
    if (event.type === 'OrderCreated') {
        console.log(`Payment Service: Received OrderCreated event for order ${event.payload.id}`);
        processPayment(event.payload);
    }
});

console.log('Payment Service: Started and listening for order_events...');
// payment-service/messageQueueClient.js (単純化されたプレースホルダー、order-serviceと同じ)
module.exports = {
    publish: (topic, message) => {
        console.log(`Payment Service: Publishing to topic '${topic}':`, message);
        // ...
    },
    subscribe: (topic, handler) => {
        console.log(`Payment Service: Subscribing to topic '${topic}' (client side)`);
        // ここで実際のMQクライアントがリスナーを設定します
        // この例では、イベント受信をシミュレートするだけです。
        if (topic === 'order_events') {
            // Order Service からのイベント受信をシミュレート
            // 実際のシナリオでは、MQサーバーがルーティングと配信を処理します。
            // このデモでは、単純化のために、ステートレスなテストのために直接メッセージを渡すこともできます。
            // これは簡略化であり、実際のMQは購読されたサービスにプッシュします。
        }
    }
};

// 実際のMQセットアップでは、「subscribe」メソッドは、
// MQクライアントライブラリがメッセージを受信するたびに呼び出されるコールバックを登録します。
// マルチサービスデモで実際のMQなしで、単純なテストのために、中央のブローカーまたは直接メッセージパスが必要になる場合があります。
// 明確さのために、すべてのメッセージキュークライアントがインポートできるグローバルな「オペレーション」オブジェクトを想定してください。
const messageBroker = require('../../global-message-broker'); // デモ用のグローバルオブジェクト

if (messageBroker) {
    module.exports.publish = (topic, message) => {
        console.log(`[MQ Client] Publishing to ${topic}:`, message);
        messageBroker.publish(topic, message);
    };
    module.exports.subscribe = (topic, handler) => {
        console.log(`[MQ Client] Subscribing to ${topic}`);
        messageBroker.subscribe(topic, handler);
    };
} else {
    // グローバルブローカーが見つからない場合 (例：個々のサービステスト)
    console.warn("Global message broker not found. MQ client operating in simulated isolated mode.");
}

通知サービス（購読者）

// notification-service/index.js
const messageQueueClient = require('./messageQueueClient'); // 同じMQクライアント

function sendOrderConfirmationEmail(orderId, email) {
    console.log(`Notification Service: Sending order confirmation email for order ${orderId} to ${email}...`);
    // 電子メール送信のシミュレーション
    setTimeout(() => {
        console.log(`Notification Service: Order confirmation email sent for order ${orderId}.`);
    }, 1000);
}

function sendPaymentFailureNotification(orderId) {
    console.warn(`Notification Service: Sending payment failure notification for order ${orderId}...`);
    // アラートまたは異なる電子メールを送信するシミュレーション
    setTimeout(() => {
        console.warn(`Notification Service: Payment failure notification sent for order ${orderId}.`);
    }, 1000);
}

// 注文作成および支払いイベントを購読
messageQueueClient.subscribe('order_events', (event) => {
    if (event.type === 'OrderCreated') {
        console.log(`Notification Service: Received OrderCreated event for order ${event.payload.id}`);
        // 注文ペイロードに顧客の電子メールが含まれていると仮定
        sendOrderConfirmationEmail(event.payload.id, event.payload.customerEmail || 'customer@example.com');
    }
});

messageQueueClient.subscribe('payment_events', (event) => {
    if (event.type === 'PaymentApproved') {
        console.log(`Notification Service: Received PaymentApproved event for order ${event.payload.orderId}`);
        // 注文確認とは異なる「支払い成功」メールをトリガーする可能性があります
    } else if (event.type === 'PaymentFailed') {
        console.warn(`Notification Service: Received PaymentFailed event for order ${event.payload.orderId}`);
        sendPaymentFailureNotification(event.payload.orderId);
    }
});

console.log('Notification Service: Started and listening for order_events and payment_events...');
// notification-service/messageQueueClient.js (他と同じ)
// ...

グローバルメッセージブローカー（単純なローカルデモ用）

実際のMQサーバーなしでローカルで実行するには、すべての messageQueueClient.js ファイルがインポートできる非常に単純な「インメモリ」メッセージブローカーを作成できます。

// global-message-broker.js
const EventEmitter = require('events');

class GlobalMessageBroker extends EventEmitter {
    constructor() {
        super();
        this.setMaxListeners(0); // 異なるトピックの無制限のリスナー
    }

    publish(topic, message) {
        console.log(`[Global MQ Broker] Emitting event on topic: ${topic}`);
        this.emit(topic, message);
    }

    subscribe(topic, handler) {
        console.log(`[Global MQ Broker] Subscriber registered for topic: ${topic}`);
        this.on(topic, handler);
    }
}

const broker = new GlobalMessageBroker();
module.exports = broker;
// 例の単純化された messageQueueClient が正しく参照されるように、グローバルにアクセス可能にする
global.messageBroker = broker;

この単純化されたデモを実行するには：

  1. global-message-broker.js ファイルを作成します。
  2. 各サービスの messageQueueClient.js ファイルで、global.messageBroker = broker; または同様のメカニズムが global-message-broker.js を正しく参照するようにしてください。
  3. payment-service/index.js、次に notification-service/index.js を起動し、最後に order-service/index.js で注文作成をシミュレートします（createOrder 関数を直接呼び出すか、HTTPリクエスト経由で）。

以下を観察できます。

  • Order Service は内部の orderPending イベントを発行します。
  • Order Service は OrderCreated イベントを「メッセージキュー」に発行します。
  • Payment Service は OrderCreated を受信し、支払いを処理します。
  • Payment Service は PaymentApproved または PaymentFailed を「メッセージキュー」に発行します。
  • Notification Service は OrderCreated および PaymentApproved/PaymentFailed イベントに反応して電子メールを送信します。

主な利点と考慮事項

利点：

  • 疎結合: サービスは独立して動作し、相互依存関係を減らし、開発、デプロイ、スケーリングを容易にします。
  • 非同期処理: 要求への迅速な応答を可能にし、重い処理をバックグラウンドタスクにオフロードすることで、ユーザーエクスペリエンスを向上させます。
  • スケーラビリティ: メッセージキューはトラフィックの急増をバッファリングでき、サービスは自身のペースでイベントを処理し、独立してスケールできます。
  • 回復力と耐障害性: サービスがダウンした場合でも、メッセージはキューに残っており、サービスが回復したときに最終的に処理されることを保証します。デッドレターキューは、失敗したメッセージ処理を処理できます。
  • イベントソーシングと監査ログ: イベントを保存してアプリケーション状態を再構築したり、包括的な監査ログを提供したりできます。

考慮事項：

  • 複雑さ: メッセージキューを導入すると、管理と監視の対象となる別のコンポーネントが追加されます。
  • 結果整合性: 非同期処理のため、サービス間のデータは即座に整合しない場合があります。これには慎重な設計が必要です。
  • デバッグ: 複数のサービスとメッセージキューを横断するイベントフローの追跡は、同期リクエスト/レスポンスのデバッグよりも困難になる可能性があります。分散トレーシングツールが不可欠になります。
  • メッセージスキーマ管理: 発行者と購読者の間の互換性のために、イベントペイロードが一貫性があり進化するスキーマを持つことを保証することが重要です。

結論

ローカルイベント処理には Node.js EventEmitter を、サービス間通信には堅牢なメッセージキューを組み合わせることで、スケーラブルで回復力があり、高度に疎結合なイベント駆動型マイクロサービスを構築するための強力な基盤が提供されます。初期の複雑さは増しますが、分散環境における保守性、柔軟性、およびパフォーマンスの長期的な利点は実質的です。このアーキテクチャパターンを採用することで、開発者は最新のクラウドネイティブアプリケーションの要求を巧みに処理する洗練されたシステムを構築できます。イベントを採用して、スケーラブルで疎結合なマイクロサービスを解き放ちましょう。

Share this article

HackerNews

More Posts from Leapcell

cover

SOLID原則とデザインパターンを用いた堅牢なTypeScriptバックエンドの構築

cover

Serverless Framework を使用して Express/Fastify アプリを AWS Lambda にデプロイする

Popular Posts