CLI: Debug
You can use the debug
command to generate diagnostic dumps and captures. Generated files will be available for download on the Web UI. Then you can use the file
command to delete, upload, or e-mail it.
Generating diagnostics files
debug generate {capture {interface|filter|timeout} | dump}
To delete a tcpdump file:
file tcpdump delete <file-name>
To generate a packet capture diagnostic file:
debug generate capture {interface|filter|timeout}
interface <interface-name>
- Select an interface to run the TCPTransmission Control Protocol dump on. E.g. br1, eth1, or ALL. Note that when you select ALL for the Interface, only those interfaces which are link up are included.timeout <duration>
- Specify the duration (in seconds) that the capture should run.filter
- Specify a filter to apply to the capture. More information on tcpdump filters is available at www.tcpdump.org
To generate a sysdump diagnostic file:
debug generate dump
Manipulating diagnostics files
file debug-dump {delete|email|upload}
file tcpdump {delete|upload}
To delete a diagnostic dump file:
file debug-dump delete <file-name>
To e-mail a diagnostic dump file:
file debug-dump email <file-name>
To upload a diagnostic dump file:
file debug-dump upload <file-name> <upload-url>
To delete a tcpdump file:
file tcpdump delete <file-name>
To upload a tcpdump file:
file tcpdump upload <file-name> <upload-url>
EXAMPLE
Capture 5 seconds of traffic on Bridge br10, then upload to a server via scp
> debug generate capture interface br10 timeout 5
Starting capture... (Press ctrl-c to end capture)
Stopping capture... Generated capture file: capture-exinda-hq-20110405-055920.tar.gz
> file tcpdump upload capture-exinda-hq-20110405-055920.tar.gz \
scp://admin@foo.com/tcpdumps