Saltar al contenido

Salida NATS

La salida nats publica eventos seleccionados de Adder como JSON en subjects de Core NATS. Utiliza el cliente oficial actual de Go. Core NATS proporciona entrega como máximo una vez; esta salida no requiere JetStream ni almacenamiento persistente.

output: nats
plugins:
output:
nats:
servers: "nats://127.0.0.1:4222"
subject-prefix: "adder.events"
event-types: "blocks,rollbacks,governance"

La salida admite estas opciones:

OpciónValor predeterminadoDescripción
serversnats://127.0.0.1:4222URLs de servidores NATS separadas por comas.
tokenvacíoToken opcional de autenticación NATS.
subject-prefixadder.eventsPrefijo de los subjects de eventos.
event-typesblocks,rollbacks,governanceTipos de eventos separados por comas.

servers debe contener al menos una URL. Cada URL debe usar el esquema nats:// o tls://, incluir un nombre de host y no incluir credenciales, parámetros de consulta ni fragmentos. La ruta debe estar vacía o ser /. Cuando la configuración especifica un puerto, el puerto debe estar entre 1 y 65535. El uso de token requiere TLS; una configuración de secretos debe proporcionar la credencial.

subject-prefix no puede estar vacío ni contener espacios, / o tokens comodín (*, >). No puede comenzar ni terminar con . ni contener ..; cada token del subject debe ser no vacío.

event-types debe nombrar al menos un tipo compatible. Adder admite los siguientes tipos:

  • blocks
  • transactions
  • rollbacks
  • governance
  • drep-registration
  • drep-update
  • drep-retirement

La salida publica cada evento en el subject <subject-prefix>.<event-type>. El sufijo corresponde al nombre del evento sin el prefijo interno input.:

event-typesSubject con el prefijo predeterminado
blocksadder.events.block
transactionsadder.events.transaction
rollbacksadder.events.rollback
governanceadder.events.governance
drep-registrationadder.events.drep-registration
drep-updateadder.events.drep-update
drep-retirementadder.events.drep-retirement

Cada carga útil contiene el JSON completo del evento de Adder.

Después de cada publicación, la salida hace flush de la conexión. Este recorrido de ida y vuelta por evento confirma la recepción explícita por parte del servidor y limita el rendimiento de recuperación a aproximadamente un evento por recorrido de ida y vuelta con el broker. Un flush correcto indica que el servidor procesó el comando de publicación; no confirma que un suscriptor haya recibido el evento.

El canal de errores de la salida recibe los fallos de publicaciones, flushes y rechazos asíncronos del broker. La salida no reintenta un fallo de flush ambiguo porque el reintento podría duplicar el mensaje. El cliente vuelve a conectarse para eventos posteriores, pero la salida desactiva el almacenamiento temporal de publicaciones sin conexión. Cuando la conexión está desconectada, la salida rechaza los eventos en lugar de acumularlos en una cola. Durante el cierre, la salida cierra la conexión y no recupera los eventos pendientes en memoria.

Una comprobación activa requiere suscribirse a adder.events.> y enviar un evento seleccionado. La comprobación debe verificar el subject y la carga útil JSON. Después, la comprobación debe desconectar el broker y confirmar que la salida informa un error.

La prueba del paquete utiliza un par local del protocolo Core NATS para verificar la correspondencia de subjects y la carga útil serializada sin un broker independiente.


Doc Holiday logo

Docs authored by Doc Holiday