Redmineの設定

🔌 機能概要¶

リアルタイム通信・データ配信・双方向通信によるWebSocket統合システム

📋 実装対象関数 (13関数)¶

接続管理関数¶

• handleWebSocketConnection(ws, req): WebSocket接続処理 (📋 設計完了)
• authenticateWebSocketConnection(ws, token): WebSocket認証 (📋 設計完了)
• broadcastToAllClients(data): 全クライアント配信 (📋 設計完了)
• broadcastToUser(userId, data): 特定ユーザー配信 (📋 設計完了)

メッセージ処理関数¶

• handleWebSocketMessage(ws, message): メッセージ処理 (📋 設計完了)
• sendWebSocketMessage(ws, type, data): メッセージ送信 (📋 設計完了)
• processSubscription(ws, channels): チャンネル購読 (📋 設計完了)

リアルタイム配信関数¶

• broadcastSystemMetrics(metrics): メトリクス配信 (📋 設計完了)
• broadcastContainerUpdate(containerEvent): コンテナ更新配信 (📋 設計完了)
• broadcastLogUpdate(logEntry): ログ更新配信 (📋 設計完了)
• broadcastAlert(alert): アラート配信 (📋 設計完了)

接続状態管理関数¶

• getActiveConnections(): アクティブ接続一覧 (📋 設計完了)
• closeConnection(connectionId): 接続クローズ (📋 設計完了)
• cleanupInactiveConnections(): 非アクティブ接続削除 (📋 設計完了)

🌐 WebSocketエンドポイント (5エンドポイント)¶

基本接続¶

• /ws - WebSocket接続 (📋 設計完了)
  • メッセージタイプ: auth, subscribe, ping

リアルタイム配信¶

• /ws/system-metrics - システムメトリクス配信 (📋 設計完了)

  • メッセージタイプ: system_metrics_update

• /ws/docker-events - Docker イベント配信 (📋 設計完了)

  • メッセージタイプ: container_update, image_update

• /ws/logs - ログリアルタイム配信 (📋 設計完了)

  • メッセージタイプ: log_update, log_stream

• /ws/alerts - アラート配信 (📋 設計完了)

  • メッセージタイプ: alert, critical_alert

• /ws/notifications - 通知配信 (⭕ 未着手)

  • メッセージタイプ: notification

📨 メッセージ形式¶

クライアント → サーバー¶

{
  "type": "subscribe",
  "data": {
    "channels": ["system-metrics", "docker-events"],
    "filters": {
      "containerName": "nginx-proxy"
    }
  },
  "timestamp": "2025-06-22T10:30:00Z"
}

サーバー → クライアント¶

{
  "type": "system_metrics_update",
  "data": {
    "cpu": 45.2,
    "memory": 78.5,
    "disk": 65.3,
    "containers": 32
  },
  "timestamp": "2025-06-22T10:30:00Z"
}

🔐 認証・セキュリティ¶

WebSocket認証¶

• Bearer Token: HTTP Authorization Header
• Session Validation: 既存セッション連携
• 権限チェック: チャンネル別アクセス制御
• レート制限: 接続数・メッセージ頻度制限

セキュリティ機能¶

• Origin Check: CORS対応
• Message Validation: JSON Schema検証
• Connection Limit: ユーザー別接続数制限
• Auto Disconnect: 非アクティブ接続切断

📡 配信チャンネル¶

system-metrics¶

• CPU使用率
• メモリ使用量
• ディスク使用量
• ネットワーク統計
• 更新間隔: 5秒

docker-events¶

• コンテナ状態変更
• イメージ更新
• ネットワーク変更
• ボリューム更新
• 更新間隔: イベント発生時

logs¶

• リアルタイムログ
• エラーログ
• アクセスログ
• デバッグログ
• 更新間隔: ログ出力時

alerts¶

• システムアラート
• セキュリティアラート
• パフォーマンスアラート
• 緊急通知
• 更新間隔: アラート発生時

notifications¶

• 一般通知
• タスク完了通知
• スケジュール通知
• カスタム通知
• 更新間隔: 通知発生時

🎛️ フロントエンド統合¶

React Hooks¶

• useWebSocket: WebSocket接続管理
• useSystemMetrics: システムメトリクス購読
• useDockerEvents: Dockerイベント購読
• useLogStream: ログストリーミング
• useAlerts: アラート購読

状態管理¶

• WebSocket接続状態
• リアルタイムデータ更新
• エラーハンドリング
• 再接続制御

⚡ パフォーマンス最適化¶

メッセージ配信¶

• メッセージバッファリング
• 配信頻度制限
• データ圧縮
• 選択的配信

接続管理¶

• Connection Pooling
• Heartbeat/Ping-Pong
• Graceful Disconnect
• Memory Management

負荷分散¶

• 複数サーバー対応 (将来)
• Redis Pub/Sub (将来)
• Horizontal Scaling (将来)

🛠️ 技術実装¶

Server Side¶

• WebSocketServer: ws package
• Message Router: カスタム実装
• Event Emitter: Node.js EventEmitter
• JSON Validation: Joi/Yup

Client Side¶

• WebSocket API: ブラウザネイティブ
• Auto Reconnect: 指数バックオフ
• Message Queue: 接続断時のバッファ
• State Sync: Zustand統合

🚨 エラーハンドリング¶

• 接続エラー: 自動再接続
• メッセージエラー: エラーレスポンス
• 認証エラー: 接続切断
• オーバーロード: レート制限

🎯 実装優先順序¶

1. 基本WebSocket接続・認証 (Phase 1)
2. システムメトリクス・Dockerイベント配信 (Phase 2)
3. ログストリーミング・アラート配信 (Phase 2)
4. 高度機能・最適化 (Phase 3)