Skip to main content

netft record

Records every accepted sample to CSV or NDJSON. The destination must not exist. Capture writes a .partial path and promotes it only after a clean drain and flush; exit code 8 means integrity was not guaranteed.

Synopsis

netft record [HOST] --output PATH [OPTIONS]

Record every accepted sensor sample to a bounded capture.

Options

OptionValueDescription
-v, --verboseflagShow additional diagnostic progress.
-q, --quietflagSuppress progress output.
--colorchoiceControl color in human-readable output.
--http-portportSet the sensor HTTP port.
--rdt-portportSet the sensor RDT port.
--timeoutdurationSet the connection timeout.
--formatchoiceSelect the output format.
--outputpathWrite output to a file.
--durationdurationStop after a bounded duration.
--countpositive-integerStop after recording this many samples.

Exit status

CodeMeaning
0Completed successfully
2Invalid command line or configuration
3Sensor discovery failed
4Stream connection or acquisition failed
5Sensor reported a fault
6Input/output operation failed
8Recording integrity could not be guaranteed
130Interrupted

Examples

netft record sensor.example --output measurement.csv
netft record sensor.example --output measurement.ndjson --duration 60s