Salida NATS
Salida NATS
Sección titulada «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.
Configuración
Sección titulada «Configuración»output: natsplugins: output: nats: servers: "nats://127.0.0.1:4222" subject-prefix: "adder.events" event-types: "blocks,rollbacks,governance"La salida admite estas opciones:
| Opción | Valor predeterminado | Descripción |
|---|---|---|
servers | nats://127.0.0.1:4222 | URLs de servidores NATS separadas por comas. |
token | vacío | Token opcional de autenticación NATS. |
subject-prefix | adder.events | Prefijo de los subjects de eventos. |
event-types | blocks,rollbacks,governance | Tipos 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:
blockstransactionsrollbacksgovernancedrep-registrationdrep-updatedrep-retirement
Subjects y cargas útiles
Sección titulada «Subjects y cargas útiles»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-types | Subject con el prefijo predeterminado |
|---|---|
blocks | adder.events.block |
transactions | adder.events.transaction |
rollbacks | adder.events.rollback |
governance | adder.events.governance |
drep-registration | adder.events.drep-registration |
drep-update | adder.events.drep-update |
drep-retirement | adder.events.drep-retirement |
Cada carga útil contiene el JSON completo del evento de Adder.
Entrega y errores
Sección titulada «Entrega y errores»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.
Comprobación en vivo
Sección titulada «Comprobación en vivo»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.
Docs authored by Doc Holiday