@tier0/opcua-client 0.6.0 → 0.6.3

package/README.md

@@ -347,3 +347,56 @@ See [BENCHMARK.md](BENCHMARK.md) for the recorded 1,000, 5,000, 10,000, and sust
 - Native command queue: 256 pending commands per connection.
 
 Configured service batches are automatically clamped to the server's advertised OperationLimits.
+
+## Status and error output (0.6.1)
+
+Browse, Read, Write and Subscribe now have two outputs. Output 1 retains data;
+output 2 emits structured diagnostic messages. Connect output 2 to Debug, a
+JSON/file node or your logging service. The shared Connection configuration
+has no output ports: its state is reported by each referencing operation node,
+identified by nodeId and connectionId.
+
+诊断输出可独立接 Debug、JSON + File 或日志服务。payload.level 为 info / warn / error；
+连接断开、订阅无响应、恢复失败、点位 Bad 状态和队列丢数据都会输出对应事件。
+恢复成功也会输出 info，但连接恢复或订阅重建不代表已经收到新数据。
+
+Messages contain payload.level, event, message, time (ISO 8601), nodeId,
+connectionId, operation, retrying and optional statusCode/counts. Subscription
+recovery includes rebuilt and dataGapPossible. The envelope contains
+opcua.operation = "diagnostic". No input values, endpoint URLs, credentials,
+certificates or raw SDK error text are copied to this output. Existing runtime
+logs and Catch handling remain unchanged; output 2 is additional reporting.
+
+Identical event/status-code pairs are emitted at most once per 30 seconds per
+node. The next emitted matching event includes suppressed repeats; there is
+no delayed timer flush. Connection restoration resets this suppression window.
+This limit applies only to diagnostic output, not the existing runtime logs.
+
+For Subscribe, **Status messages → Both outputs (legacy compatible)** is the
+default: existing subscription-status messages remain on output 1 and the new
+structured events appear on output 2. Choose **Output 2 only** to keep output 1
+strictly for data. Existing Flow JSON without statusOutput keeps its old behavior;
+all existing wires on output 1 remain unchanged. New diagnostic events are not
+sent to output 1. Structured events contain summaries; existing detailed
+subscription-status payloads are preserved only in compatibility mode.
+
+This change adds reporting; it does not add a data-silence watchdog or change
+OPC UA reconnection/monitoring behavior.
+
+## Point failure details (0.6.2)
+
+Diagnostic output now includes payload.failures: an array of nodeId (OPC UA
+point identifier), optional alias, statusCode and a short explanation. The
+outer payload.nodeId still identifies the Node-RED flow node. Read/Write
+partial failures display yellow status with success/total and failure counts.
+The detail list is available even when data output is set to Value only.
+
+Each event includes at most 100 failed points; failed reports the full failure
+count, failuresTruncated indicates truncation, and omittedFailures reports the
+remaining count. Use Full metadata on output 1 for complete Read/Write results.
+Subscription compatibility output also retains its existing bounded failures.
+Duplicate event suppression compares the failing point identities and status
+codes so a different batch of failing points is not hidden by the first batch.
+No point values or raw input messages are copied. A whole-service exception
+without per-point results is still an operation failure: it cannot identify
+which individual points failed.

package/lib/diagnostics.js

@@ -0,0 +1,123 @@
+'use strict';
+
+const { createHash } = require('node:crypto');
+const FAILURE_LIMIT = 100;
+const POINT_MESSAGES = {
+  BadNotReadable: '访问级别不允许读取或订阅该点位',
+  BadUserAccessDenied: '当前用户无权执行该操作',
+  BadNodeIdUnknown: '服务端找不到该 NodeId',
+  BadNodeIdInvalid: 'NodeId 格式无效',
+  BadNoCommunication: '服务端无法与该点位的数据源通信',
+  BadWaitingForInitialData: '等待该点位的首次数据',
+  BadTimeout: '该点位操作超时',
+  BadNotWritable: '该点位不允许写入',
+  BadTypeMismatch: '写入值类型与点位类型不匹配',
+  BadTooManyMonitoredItems: '服务端监控点数量超限',
+};
+
+// Output only allowlisted metadata: never forward SDK messages, credentials,
+// endpoint URLs, input payloads or raw state/diagnostic objects.
+function statusCode(error) {
+  const text = String(error?.code || error?.statusCode || error?.message || error || '');
+  return /\b(?:Bad[A-Za-z0-9]+|Uncertain[A-Za-z0-9]*|OPCUA_[A-Z_]+)\b/.exec(text)?.[0] || 'OperationFailed';
+}
+
+function createDiagnostics(node, config, operation) {
+  const recent = new Map();
+  let closed = false;
+  let interrupted = false;
+  const client = node.connection?.client;
+  function emit(level, event, message, details = {}, send) {
+    if (closed) return;
+    const now = Date.now();
+    const failures = details.failures;
+    // Different failing points must not be hidden by another batch's throttle.
+    const fingerprint = createHash('sha256');
+    if (failures) for (const item of failures) {
+      fingerprint.update(JSON.stringify([item.nodeId, item.alias, item.statusCode]));
+    }
+    const key = `${event}:${details.statusCode || ''}:${failures ? fingerprint.digest('hex') : ''}`;
+    const previous = recent.get(key);
+    if (previous && now - previous.time < 30000) {
+      previous.suppressed += 1;
+      return;
+    }
+    const payload = {
+      level, event, message, time: new Date(now).toISOString(),
+      nodeId: node.id || config.id, connectionId: config.connection, operation,
+      retrying: details.retrying === true,
+    };
+    if (details.statusCode) payload.statusCode = statusCode(details.statusCode);
+    if (failures) {
+      payload.failures = failures.slice(0, FAILURE_LIMIT).map((item) => {
+        const code = statusCode(item.statusCode);
+        return {
+          ...(typeof item.nodeId === 'string' ? { nodeId: item.nodeId } : {}),
+          ...(typeof item.alias === 'string' && item.alias ? { alias: item.alias } : {}),
+          statusCode: code,
+          message: POINT_MESSAGES[code] || '点位返回非 Good 状态，请根据 statusCode 排查',
+        };
+      });
+      payload.failuresTruncated = failures.length > FAILURE_LIMIT;
+      payload.omittedFailures = Math.max(0, failures.length - FAILURE_LIMIT);
+    }
+    for (const field of ['failed', 'total', 'monitored', 'desired', 'dropped', 'subscriptionId']) {
+      if (Number.isFinite(details[field])) payload[field] = details[field];
+    }
+    for (const field of ['rebuilt', 'dataGapPossible']) {
+      if (typeof details[field] === 'boolean') payload[field] = details[field];
+    }
+    if (previous?.suppressed) payload.suppressed = previous.suppressed;
+    if (recent.size >= 128) recent.delete(recent.keys().next().value);
+    recent.set(key, { time: now, suppressed: 0 });
+    const output = send || (node.send && node.send.bind(node));
+    output?.([null, { payload, opcua: { operation: 'diagnostic' } }]);
+  }
+  function failure(error, send, event = `${operation}_failed`, retrying = false) {
+    emit('error', event, `OPC UA ${operation} failed`, { statusCode: statusCode(error), retrying }, send);
+  }
+  function results(items, send, descriptors) {
+    const failed = items.filter((item) => item.statusCode && item.statusCode !== 'Good');
+    const failures = failed.map((item) => ({
+      nodeId: item.nodeId,
+      alias: item.alias ?? descriptors?.get(item.nodeId)?.alias,
+      statusCode: item.statusCode,
+    }));
+    if (failed.length) emit('warn', 'points_failed', 'Some OPC UA points returned a non-Good status', {
+      failed: failed.length, total: items.length, statusCode: statusCode(failed[0].statusCode),
+      failures,
+    }, send);
+    return failed.length;
+  }
+  const onFault = (error) => {
+    interrupted = true;
+    emit('warn', 'connection_fault', 'OPC UA connection fault', { statusCode: statusCode(error), retrying: true });
+  };
+  const onState = (state) => {
+    if (!state) return;
+    if (state.state === 'connected') {
+      if (interrupted) {
+        recent.clear();
+        emit('info', 'connection_restored', 'OPC UA connection restored; subscription recovery may still be pending');
+      }
+      interrupted = false;
+    } else if (['reconnecting', 'backoff', 'failed'].includes(state.state)) {
+      interrupted = true;
+      emit(state.state === 'failed' ? 'error' : 'warn', `connection_${state.state}`,
+        'OPC UA connection unavailable; recovery pending', {
+          retrying: true, ...(state.statusCode && state.statusCode !== 'Good' ? { statusCode: statusCode(state.statusCode) } : {}),
+        });
+    }
+  };
+  client?.on?.('fault', onFault);
+  client?.on?.('state', onState);
+  node.on('close', () => {
+    closed = true;
+    recent.clear();
+    client?.removeListener?.('fault', onFault);
+    client?.removeListener?.('state', onState);
+  });
+  return { emit, failure, results };
+}
+
+module.exports = { createDiagnostics, statusCode };

package/nodes/browse.html

@@ -46,6 +46,7 @@
 </script>
 <script type="text/html" data-help-name="tier0-opcua-browse">
   <section lang="zh-CN">
+    <p>输出 2 为独立状态／异常消息：payload.level 为 info、warn 或 error。可连接 Debug、文件或日志服务；原有 Catch 和日志仍然有效。同类事件每 30 秒最多输出一次，下一次包含 suppressed 计数。输出不含原始值、凭据或完整错误文本。</p>
     <h3>浏览（Browse）</h3>
     <p>浏览 OPC UA 地址空间并选择变量点位。Browse 返回节点描述信息，不读取实时值。</p>
     <h4>配置与输入</h4>
@@ -60,6 +61,7 @@
   </section>
   <hr>
   <section lang="en">
+    <p>Output 2 emits status/error events with payload.level (info, warn, error). Connect it to Debug, file or logging nodes. Catch and existing logs remain supported. Repeats are limited to one per 30 seconds; the next matching event includes suppressed counts. Raw values, credentials and SDK error text are omitted.</p>
     <h3>Browse</h3>
     <p>Browses the OPC UA address space and selects Variable nodes. Browse returns node descriptors; it does not read live values.</p>
     <h4>Configuration and input</h4>
@@ -75,7 +77,7 @@
 </script>
 <script type="text/javascript">
   RED.nodes.registerType('tier0-opcua-browse', {
-    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 1, icon: 'search.png',
+    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 2, outputLabels: ['Data', 'Status / errors'], icon: 'search.png',
     defaults: {
       connection: { value: '', type: 'tier0-opcua-connection', required: true }, rootNodeId: { value: 'ns=0;i=85' },
       selectedNodes: { value: [] }, recursive: { value: true }, variablesOnly: { value: true },

package/nodes/browse.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { createDiagnostics } = require('../lib/diagnostics');
+
 const { chunks } = require('../lib/points');
 const { buildBrowseTree, selectedVariables } = require('../lib/browse-tree');
 
@@ -65,12 +67,17 @@ module.exports = function registerBrowseNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const diagnostics = createDiagnostics(node, config, 'browse');
     const consumer = node.connection?.registerConsumer?.('browse', {
       nodeId: config.id, name: config.name,
     });
 
     node.on('input', async (msg, send, done) => {
-      if (!node.connection) return done(new Error('OPC UA connection not configured'));
+      if (!node.connection) {
+        const error = new Error('OPCUA_CONNECTION_NOT_CONFIGURED');
+        diagnostics.failure(error, send);
+        return done(error);
+      }
 
       try {
         consumer?.markUsed('browse');
@@ -124,6 +131,10 @@ module.exports = function registerBrowseNode(RED) {
         }
 
         const partial = browseDiagnostics?.truncated || browseDiagnostics?.failures?.length;
+        if (partial) diagnostics.emit('warn', 'browse_partial', 'OPC UA Browse returned partial results', {
+          failed: browseDiagnostics?.failures?.length || 0, total: points.length,
+          failures: browseDiagnostics?.failures || [],
+        }, send);
         node.status({
           fill: partial ? 'yellow' : 'green', shape: partial ? 'ring' : 'dot',
           text: `${points.length} points` +
@@ -133,6 +144,7 @@ module.exports = function registerBrowseNode(RED) {
         done();
       } catch (error) {
         node.status({ fill: 'red', shape: 'ring', text: error.message });
+        diagnostics.failure(error, send);
         done(error);
       }
     });

package/nodes/read.html

@@ -45,6 +45,7 @@
 </script>
 <script type="text/html" data-help-name="tier0-opcua-read">
   <section lang="zh-CN">
+    <p>输出 2 为独立状态／异常消息：payload.level 为 info、warn 或 error。可连接 Debug、文件或日志服务；原有 Catch 和日志仍然有效。同类事件每 30 秒最多输出一次，下一次包含 suppressed 计数。输出不含原始值、凭据或完整错误文本。</p>
     <h3>读取（Read）</h3>
     <p>每收到一条输入消息执行一次 OPC UA Read。它不是定时器；读取频率由上游 Inject、Function 或其他节点的触发频率决定。</p>
     <h4>输入</h4>
@@ -65,6 +66,7 @@
   </section>
   <hr>
   <section lang="en">
+    <p>Output 2 emits status/error events with payload.level (info, warn, error). Connect it to Debug, file or logging nodes. Catch and existing logs remain supported. Repeats are limited to one per 30 seconds; the next matching event includes suppressed counts. Raw values, credentials and SDK error text are omitted.</p>
     <h3>Read</h3>
     <p>Executes one OPC UA Read for each input message. It is not a timer; the upstream Inject, Function, or other node controls the read frequency.</p>
     <h4>Input</h4>
@@ -86,7 +88,7 @@
 </script>
 <script type="text/javascript">
   RED.nodes.registerType('tier0-opcua-read', {
-    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 1, icon: 'bridge.png',
+    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 2, outputLabels: ['Data', 'Status / errors'], icon: 'font-awesome/fa-arrow-circle-down',
     defaults: {
       connection: { value: '', type: 'tier0-opcua-connection', required: true },
       nodeId: { value: '' }, pointList: { value: '' }, pointListFileName: { value: '' },

package/nodes/read.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { createDiagnostics } = require('../lib/diagnostics');
+
 const { looksLikePointList, messagePoints } = require('../lib/points');
 
 const COMPACT_RESULT_FIELDS = Object.freeze([
@@ -27,12 +29,17 @@ module.exports = function registerReadNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const diagnostics = createDiagnostics(node, config, 'read');
     const consumer = node.connection?.registerConsumer?.('read', {
       nodeId: config.id, name: config.name,
     });
 
     node.on('input', async (msg, send, done) => {
-      if (!node.connection) return done(new Error('OPC UA connection not configured'));
+      if (!node.connection) {
+        const error = new Error('OPCUA_CONNECTION_NOT_CONFIGURED');
+        diagnostics.failure(error, send);
+        return done(error);
+      }
 
       try {
         consumer?.markUsed('read');
@@ -55,6 +62,7 @@ module.exports = function registerReadNode(RED) {
 
         // Undefined preserves the original output for Flow JSON created before
         // resultDetail was introduced. New editor nodes explicitly save compact.
+        const failed = diagnostics.results(results, send);
         const resultDetail = config.resultDetail || 'full';
         const outputResults = resultDetail === 'compact'
           ? results.map(compactResult)
@@ -96,10 +104,12 @@ module.exports = function registerReadNode(RED) {
           send(msg);
         }
 
-        node.status({ fill: 'green', shape: 'dot', text: `${results.length} read` });
+        node.status({ fill: failed ? 'yellow' : 'green', shape: failed ? 'ring' : 'dot',
+          text: `${results.length - failed}/${results.length} read` + (failed ? ` / ${failed} failed` : '') });
         done();
       } catch (error) {
         node.status({ fill: 'red', shape: 'ring', text: error.message });
+        diagnostics.failure(error, send);
         done(error);
       }
     });

package/nodes/subscribe.html

@@ -47,6 +47,7 @@
     <div class="form-row"><label for="node-input-timestampMode">Timestamps</label><select id="node-input-timestampMode"><option value="source">Source</option><option value="both">Source and server</option><option value="server">Server</option><option value="neither">None</option></select></div>
     <div class="form-row"><label for="node-input-batchSize">Create batch size</label><input type="number" id="node-input-batchSize"></div>
     <div class="form-row"><label for="node-input-maxItemsPerSubscription">Items / subscription</label><input type="number" id="node-input-maxItemsPerSubscription"></div>
+    <div class="form-row"><label for="node-input-statusOutput">Status messages</label><select id="node-input-statusOutput"><option value="both">Both outputs (legacy compatible)</option><option value="separate">Output 2 only</option></select></div>
     <div class="form-row"><label for="node-input-outputMode">Change output</label><select id="node-input-outputMode"><option value="batch">Native batch</option><option value="single">One message per change</option></select></div>
     <div class="form-row"><label for="node-input-resultDetail">Result detail</label><select id="node-input-resultDetail"><option value="compact">Compact</option><option value="value">Value only</option><option value="full">Full metadata</option></select></div>
     <div class="form-row"><label for="node-input-callbackBatchSize">Output batch size</label><input type="number" id="node-input-callbackBatchSize"></div>
@@ -59,6 +60,7 @@
 </script>
 <script type="text/html" data-help-name="tier0-opcua-subscribe">
   <section lang="zh-CN">
+    <p>输出 2 为独立状态／异常消息：payload.level 为 info、warn 或 error。可连接 Debug、文件或日志服务；原有 Catch 和日志仍然有效。同类事件每 30 秒最多输出一次，下一次包含 suppressed 计数。输出不含原始值、凭据或完整错误文本。</p>
     <h3>订阅（Subscribe）</h3>
     <p>创建 OPC UA Subscription 和 MonitoredItems，由服务器在值变化时推送通知；它不是客户端定时 Read。大量点位会按照服务器限制自动拆分到多个 Subscription。</p>
     <h4>输入与命令</h4>
@@ -82,6 +84,7 @@
   </section>
   <hr>
   <section lang="en">
+    <p>Output 2 emits status/error events with payload.level (info, warn, error). Connect it to Debug, file or logging nodes. Catch and existing logs remain supported. Repeats are limited to one per 30 seconds; the next matching event includes suppressed counts. Raw values, credentials and SDK error text are omitted.</p>
     <h3>Subscribe</h3>
     <p>Creates one or more OPC UA subscriptions and MonitoredItems so the server sends data-change notifications. It is not a periodic client Read. Large point sets are automatically sharded across Subscriptions according to server limits.</p>
     <h4>Input and commands</h4>
@@ -106,8 +109,9 @@
 </script>
 <script type="text/javascript">
   RED.nodes.registerType('tier0-opcua-subscribe', {
-    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 1, icon: 'bridge.png',
+    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 2, outputLabels: ['Data', 'Status / errors'], icon: 'font-awesome/fa-rss',
     defaults: {
+      statusOutput: { value: 'both' },
       connection: { value: '', type: 'tier0-opcua-connection', required: true },
       nodeId: { value: '' }, pointList: { value: '' }, pointListFileName: { value: '' },
       publishingInterval: { value: 1000, validate: RED.validators.number() }, samplingInterval: { value: 1000, validate: RED.validators.number() },

package/nodes/subscribe.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { createDiagnostics } = require('../lib/diagnostics');
+
 const { looksLikePointList, messagePoints } = require('../lib/points');
 const { SIEMENS_WINCC_DEFAULTS, isSiemensWinCC } = require('../lib/compatibility');
 
@@ -98,6 +100,7 @@ module.exports = function registerSubscribeNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const diagnostics = createDiagnostics(node, config, 'subscribe');
     node.subscriptions = new Map();
     node.desired = new Map();
     node.monitored = new Map();
@@ -204,6 +207,7 @@ module.exports = function registerSubscribeNode(RED) {
     function updateQueueWarning(diagnostics) {
       const dropped = Number(diagnostics.dropped) || 0;
       if (dropped > node.lastDropped) {
+        diagnostics.emit('warn', 'queue_overflow', 'OPC UA notification queue dropped changes', { dropped });
         node.warn(`OPC UA notification queue dropped ${dropped - node.lastDropped} change(s); total ${dropped}`);
       }
       node.lastDropped = dropped;
@@ -272,9 +276,10 @@ module.exports = function registerSubscribeNode(RED) {
 
     function onNativeBatch(record, batch) {
       if (node.closing || !record.id || !node.subscriptions.has(record.id)) return;
-      const diagnostics = batch.diagnostics || {};
-      node.subscriptionDiagnostics.set(record.id, diagnostics);
+      const queueDiagnostics = batch.diagnostics || {};
+      node.subscriptionDiagnostics.set(record.id, queueDiagnostics);
       const sourceChanges = batch.changes || [];
+      diagnostics.results(sourceChanges.filter((change) => node.desired.has(change.nodeId)), undefined, node.desired);
       const changes = [];
       for (let index = 0; index < sourceChanges.length; index += 1) {
         const change = sourceChanges[index];
@@ -547,7 +552,9 @@ module.exports = function registerSubscribeNode(RED) {
       let rebuilt = false;
       if (node.subscriptions.size) {
         let valid = false;
-        try { valid = await validateSubscriptions(); } catch {}
+        try { valid = await validateSubscriptions(); } catch (error) {
+          diagnostics.failure(error, undefined, 'subscription_validation_failed', true);
+        }
         if (!valid) {
           await clearSubscriptions(true, true);
           rebuilt = true;
@@ -568,6 +575,7 @@ module.exports = function registerSubscribeNode(RED) {
       }
       await pruneEmptySubscriptions();
 
+      diagnostics.results(failures, undefined, node.desired);
       node.reconcileAttempt = 0;
       node.status({
         fill: failures.length ? 'yellow' : 'green',
@@ -576,7 +584,12 @@ module.exports = function registerSubscribeNode(RED) {
           (failures.length ? ` / ${failures.length} failed` : ''),
       });
       if (reason !== 'command') {
-        node.send({
+        diagnostics.emit(failures.length ? 'warn' : 'info', failures.length ? 'subscription_recovery_partial' : 'subscription_restored',
+          'OPC UA subscription reconciliation completed; data receipt is not yet confirmed', {
+            failed: failures.length, monitored: node.monitored.size, desired: node.desired.size,
+            rebuilt, dataGapPossible: rebuilt,
+          });
+        if (config.statusOutput !== 'separate') node.send({
           payload: { ...statusPayload('recover'), rebuilt, reason },
           opcua: {
             operation: 'subscription-status',
@@ -625,6 +638,7 @@ module.exports = function registerSubscribeNode(RED) {
         try {
           await runSerialized(() => reconcileSubscriptions(reason));
         } catch (error) {
+          diagnostics.failure(error, undefined, 'subscription_recovery_failed', true);
           node.warn(`OPC UA resubscribe failed: ${error.message}`);
           node.status({ fill: 'yellow', shape: 'ring', text: 'waiting to recover' });
           scheduleReconnect(reason);
@@ -643,6 +657,7 @@ module.exports = function registerSubscribeNode(RED) {
         scheduleReconnect(state.reason || 'connected', true);
       } else if (state.state === 'subscription-inactive' &&
                  (!state.subscriptionId || node.subscriptions.has(state.subscriptionId))) {
+        diagnostics.emit('warn', 'subscription_inactive', 'OPC UA subscription is inactive; recovery pending', { retrying: true, subscriptionId: state.subscriptionId });
         node.status({ fill: 'yellow', shape: 'ring', text: 'subscription inactive' });
         scheduleReconnect('subscription-inactive');
       } else if (['reconnecting', 'backoff', 'failed'].includes(state.state)) {
@@ -653,7 +668,11 @@ module.exports = function registerSubscribeNode(RED) {
     node.connection?.client.on('state', onState);
 
     node.on('input', async (msg, send, done) => {
-      if (!node.connection) return done(new Error('OPC UA connection not configured'));
+      if (!node.connection) {
+        const error = new Error('OPCUA_CONNECTION_NOT_CONFIGURED');
+        diagnostics.failure(error, send);
+        return done(error);
+      }
       try {
         const command = msg.opcua?.command || 'replace';
         const dynamicNodeId = msg.nodeId || msg.topic;
@@ -700,7 +719,10 @@ module.exports = function registerSubscribeNode(RED) {
           text: `${node.monitored.size} monitored / ${node.subscriptions.size} sub` +
             (failed ? ` / ${failed} failed` : ''),
         });
-        send({
+        diagnostics.emit(failed ? 'warn' : 'info', 'subscription_updated', 'OPC UA subscription configuration updated', {
+          failed, monitored: node.monitored.size, desired: node.desired.size,
+        }, send);
+        if (config.statusOutput !== 'separate') send({
           ...msg,
           payload: statusPayload(command),
           opcua: { operation: 'subscription-status' },
@@ -708,6 +730,7 @@ module.exports = function registerSubscribeNode(RED) {
         done();
       } catch (error) {
         node.status({ fill: 'red', shape: 'ring', text: error.message });
+        diagnostics.failure(error, send);
         done(error);
       }
     });
@@ -754,6 +777,7 @@ module.exports = function registerSubscribeNode(RED) {
           }));
         } catch (error) {
           node.status({ fill: 'red', shape: 'ring', text: error.message });
+          diagnostics.failure(error, undefined, 'subscription_configuration_failed');
           node.warn(`OPC UA saved subscription point list is invalid: ${error.message}`);
           return;
         }
@@ -764,6 +788,7 @@ module.exports = function registerSubscribeNode(RED) {
           });
         }).catch((error) => {
           node.status({ fill: 'yellow', shape: 'ring', text: 'waiting to subscribe' });
+          diagnostics.failure(error, undefined, 'subscription_startup_failed', true);
           node.warn(`OPC UA startup subscription failed: ${error.message}`);
           scheduleReconnect('startup');
         });

package/nodes/write.html

@@ -47,6 +47,7 @@
 </script>
 <script type="text/html" data-help-name="tier0-opcua-write">
   <section lang="zh-CN">
+    <p>输出 2 为独立状态／异常消息：payload.level 为 info、warn 或 error。可连接 Debug、文件或日志服务；原有 Catch 和日志仍然有效。同类事件每 30 秒最多输出一次，下一次包含 suppressed 计数。输出不含原始值、凭据或完整错误文本。</p>
     <h3>写入（Write）</h3>
     <p>向一个或多个 OPC UA Variable 写值。服务器必须允许当前用户写入，值也必须能够转换为目标数据类型。</p>
     <h4>输入</h4>
@@ -62,6 +63,7 @@
   </section>
   <hr>
   <section lang="en">
+    <p>Output 2 emits status/error events with payload.level (info, warn, error). Connect it to Debug, file or logging nodes. Catch and existing logs remain supported. Repeats are limited to one per 30 seconds; the next matching event includes suppressed counts. Raw values, credentials and SDK error text are omitted.</p>
     <h3>Write</h3>
     <p>Writes values to one or more OPC UA Variables. The current user must have write access and each value must be convertible to the target data type.</p>
     <h4>Input</h4>
@@ -78,7 +80,7 @@
 </script>
 <script type="text/javascript">
   RED.nodes.registerType('tier0-opcua-write', {
-    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 1, icon: 'bridge.png',
+    category: 'OPC UA', color: '#c7e9f1', inputs: 1, outputs: 2, outputLabels: ['Data', 'Status / errors'], icon: 'font-awesome/fa-pencil',
     defaults: {
       connection: { value: '', type: 'tier0-opcua-connection', required: true },
       nodeId: { value: '' }, dataType: { value: 'String' },

package/nodes/write.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { createDiagnostics } = require('../lib/diagnostics');
+
 const { messageWritePoints } = require('../lib/points');
 
 module.exports = function registerWriteNode(RED) {
@@ -7,12 +9,17 @@ module.exports = function registerWriteNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const diagnostics = createDiagnostics(node, config, 'write');
     const consumer = node.connection?.registerConsumer?.('write', {
       nodeId: config.id, name: config.name,
     });
 
     node.on('input', async (msg, send, done) => {
-      if (!node.connection) return done(new Error('OPC UA connection not configured'));
+      if (!node.connection) {
+        const error = new Error('OPCUA_CONNECTION_NOT_CONFIGURED');
+        diagnostics.failure(error, send);
+        return done(error);
+      }
 
       try {
         consumer?.markUsed('write');
@@ -23,6 +30,7 @@ module.exports = function registerWriteNode(RED) {
           Number(config.batchSize) || 500
         );
 
+        const failed = diagnostics.results(results, send, new Map(points.map((point) => [point.nodeId, point])));
         if ((config.outputMode || 'batch') === 'split') {
           results.forEach((result) => send({ ...msg, topic: result.nodeId, opcua: result }));
         } else {
@@ -38,10 +46,12 @@ module.exports = function registerWriteNode(RED) {
           send(msg);
         }
 
-        node.status({ fill: 'green', shape: 'dot', text: `${results.length} written` });
+        node.status({ fill: failed ? 'yellow' : 'green', shape: failed ? 'ring' : 'dot',
+          text: `${results.length - failed}/${results.length} written` + (failed ? ` / ${failed} failed` : '') });
         done();
       } catch (error) {
         node.status({ fill: 'red', shape: 'ring', text: error.message });
+        diagnostics.failure(error, send);
         done(error);
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tier0/opcua-client",
-  "version": "0.6.0",
+  "version": "0.6.3",
   "description": "High-scale OPC UA client nodes for Node-RED powered by open62541",
   "license": "Apache-2.0",
   "repository": {