devstack/doc/source/debugging.rst
Rodolfo Alonso Hernandez d1c2bf5e7c Add new service "file_tracker"
This new service periodically tracks the file open in the system.

Closes-Bug: #1995502
Change-Id: I02e097fef07655ff571af9f35bf258b2ed975098
2022-11-07 08:21:34 +00:00

1.3 KiB

System-wide debugging

A lot can go wrong during a devstack run, and there are a few inbuilt tools to help you.

dstat

Enable the dstat service to produce performance logs during the devstack run. These will be logged to the journal and also as a CSV file.

memory_tracker

The memory_tracker service periodically monitors RAM usage and provides consumption output when available memory is seen to be falling (i.e. processes are consuming memory). It also provides output showing locked (unswappable) memory.

file_tracker

The file_tracker service periodically monitors the number of open files in the system.

tcpdump

Enable the tcpdump service to run a background tcpdump. You must set the TCPDUMP_ARGS variable to something suitable (there is no default). For example, to trace iSCSI communication during a job in the OpenStack gate and copy the result into the log output, you might use:

job:
  name: devstack-job
  parent: devstack
  vars:
    devstack_services:
      tcpdump: true
    devstack_localrc:
      TCPDUMP_ARGS: "-i any tcp port 3260"
    zuul_copy_output:
      '{{ devstack_log_dir }}/tcpdump.pcap': logs