Actions11
Overview
This node interacts with NATS JetStream, a messaging system that supports streaming and message persistence. Specifically, the Stream - List operation retrieves a list of streams managed by JetStream, optionally filtered by a subject pattern.
Use cases include:
- Monitoring available streams in your JetStream server.
- Filtering streams by subject patterns to find relevant data channels.
- Automating workflows based on existing stream configurations.
For example, you might list all streams related to "events.*" to process event-driven messages dynamically.
Properties
| Name | Meaning |
|---|---|
| Subject Filter | Optional subject pattern to filter streams. Leave empty to list all streams. Example: events.> |
Output
The output is an array of JSON objects representing the streams matching the filter criteria. Each object contains details about a stream as returned by the JetStream management API. The exact structure depends on the JetStream server but typically includes stream names, subjects, configuration, and status information.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a NATS JetStream server.
- Needs an API key credential for authenticating with the NATS server.
- The node uses bundled NATS client libraries internally.
- Proper network access and permissions to query JetStream streams are necessary.
Troubleshooting
Common issues:
- Connection failures due to incorrect or missing API credentials.
- Invalid subject filter patterns causing errors.
- Network timeouts or unreachable NATS server.
Error messages:
"NATS JetStream operation failed: ..."indicates a failure during communication or execution; verify credentials and server availability."Unknown stream operation: list"would indicate a misconfiguration or unsupported operation (unlikely here since "list" is supported).- Errors related to invalid subject patterns suggest correcting the filter syntax.
Resolutions:
- Ensure the API key credential is correctly configured.
- Validate the subject filter pattern against NATS subject syntax.
- Confirm the NATS JetStream server is reachable from n8n.