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.
--colorauto|always|neverControl color in human-readable output.
--http-portPORTSet the sensor HTTP port.
--rdt-portPORTSet the sensor RDT port.
--timeoutDURATIONSet the connection timeout.
--formatauto|text|json|table|ndjson|csvSelect the output format.
--outputPATHWrite output to a file.
--durationDURATIONStop after a bounded duration.
--countINTEGERStop 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