subprocess
This component is mostly stable but breaking changes could still be made outside of major version releases if a fundamental problem with the component is found.
Executes a command, runs it as a subprocess, and consumes messages from it over stdout.
- Common
- Advanced
# Common config fields, showing default values
input:
label: ""
subprocess:
name: cat # No default (required)
args: []
codec: lines
restart_on_exit: false
# All config fields, showing default values
input:
label: ""
subprocess:
name: cat # No default (required)
args: []
codec: lines
restart_on_exit: false
max_buffer: 65536
Messages are consumed according to a specified codec. The command is executed once and if it terminates the input also closes down gracefully. Alternatively, the field restart_on_close
can be set to true
in order to have Bento re-execute the command each time it stops.
The field max_buffer
defines the maximum message size able to be read from the subprocess. This value should be set significantly above the real expected maximum message size.
The execution environment of the subprocess is the same as the Bento instance, including environment variables and the current working directory.
Fields
name
The command to execute as a subprocess.
Type: string
# Examples
name: cat
name: sed
name: awk
args
A list of arguments to provide the command.
Type: array
Default: []
codec
The way in which messages should be consumed from the subprocess.
Type: string
Default: "lines"
Options: lines
.
restart_on_exit
Whether the command should be re-executed each time the subprocess ends.
Type: bool
Default: false
max_buffer
The maximum expected size of an individual message.
Type: int
Default: 65536