Documentation Center
AlienVault® USM Appliance™

NetFlow Troubleshooting

Applies to Product: USM Appliance™ AlienVault OSSIM®

If flow data from various NetFlow sources does not appear after a reasonable amount of time, you need to validate that flow data is successfully being transmitted and received by the USM Appliance Server. This section provides some specific procedures you can follow to troubleshoot NetFlow data generation, collection, and display.

Check that basic system services are running

There are several components involved in the NetFlow generation and collection process. The basic system services that are involved are the following:

  • nfsen
  • nfcapd
  • fprobe(if using aUSM Appliance Sensor to generate the flows from a spanned/mirrored port)

The display of NetFlow graphics in the USM Appliance web UI is provided by nfsen. When you select Environment > NetFlow in the USM Appliance web UI and you get errors like nfsend connect() error or nfsend connection failed, this usually occurs because the nfsend process is not running. In that case, you will have to SSH into the system and start nfsen with the service nfsen start command. If there is a configuration error, the command will return an error message and nfsen won't start.

Once nfsen is started, you will see nfcapd started as well, which captures the flows. There should be one nfcapd process running for each sensor that has NetFlow enabled, as listed on the Administration > Deployment > Sensors page. Each nfcapd process will listen for flows on the port number configured for NetFlow collection on the sensor's NetFlow configuration page in the USM Appliance web UI.

NetFlow can either come from external devices that have a dummy sensor configured to collect NetFlow data, or an AlienVault Sensor configured to generate NetFlow data from a spanned/mirrored port. In the first case, you will need to create a dummy sensor and enable it for NetFlow collection. Then, you need to configure the external device to send flows to USM Appliance on the same port number as configured for that dummy sensor.

If both nfsen and nfcapd are running but there is no data displayed when you go to the Environment > NetFlow web page, perform the following checks.

Verify that NetFlow data files are being created daily for each sensor

The nfcapd process for each sensor writes the flows in a separate directory. You can see the directories by executing the command ps auxww | grep nfcapd and looking for the value of the parameter '-l' in the desired nfcapd process. For example:

ps auxww | grep nfcapd

www-data 25860 0.0 0.0 15756 704 ? S 14:53 0:00 /usr/bin/nfcapd -w -D -p 555 -u www-data -g www-data -B 200000 -S 7 -P /var/nfsen/run/ -I 564DD32C920DB9686BDCCBBC75CD7822 -l /var/cache/nfdump/flows//live/564DD32C920DB9686BDCCBBC75CD7822

Under that directory there should be several directories, one per day:

ll /var/cache/nfdump/flows/live/564DD32C920DB9686BDCCBBC75CD7822


drwxr-xr-x 2 www-data www-data 12288 Oct 6 11:26 2014-10-04

drwxr-xr-x 2 www-data www-data 4096 Oct 6 11:41 2014-10-05

drwxr-xr-x 2 www-data www-data 4096 Oct 6 16:10 2014-10-06

-rw-r--r-- 1 www-data www-data 276 Oct 6 16:10 nfcapd.current

Each directory will contain flow files from the current day. One other important thing to note is that the nfdump command can be used to read the flows files, for example, executing the following command:

nfdump -r nfcapd.xxxxxxx

When you execute this command, do you see data in the files written by nfcapd? If there is data, but it does not appear in the USM Appliance web UI, it is usually because you have selected a wrong time range.

Verify that nfcapd processes are getting packets

If NetFlow data files are written, but they don't contain any information, you should check if nfcapd processes are getting packets. To do this, you could run the following command:

tcpdump -i any port <PORT>

If there is no communication on that port, you need to know if the flow's source is a USM Appliance Sensor or another device. If NetFlow data is coming directly from a network device that is generating the NetFlow data, you need to configure that device to send the flows to the dummy sensor. You may also want to check if there is a firewall blocking communication between the network device and USM Appliance.

As previously mentioned, a USM Appliance Sensor can generate NetFlow data by itself, when configured to listen on a SPAN/mirrored port. In this case, if you don't see traffic on the nfcapd port, you need to check the sensor's NetFlow configuration. The fprobe process listens on the interface port,takes the connection's meta information, and sends it to nfcapd. If you run the command ps auxww | grep fprobe, you will see the interface where each fprobe instance is listening and also the ip:port where fprobe is sending the information. For example:

root 26181 0.0 0.1 47420 6316 ? Ssl 14:53 0:04 /usr/sbin/fprobe -iany -fip

This command specifies the ip:port where nfcapdis listening. The IP is set to the framework machine, but the port is configurable, either through the USM Appliance web UI or the alienvault-setup program (Configure Sensor > Enable NetFlow Generator > yes and then set the desired port).

Validate that NetFlow packets are being generated by the USM Appliance Sensor

If you are collecting NetFlow packets from a third-party device (using a dummy USM Appliance Sensor), perform whatever troubleshooting is appropriate to determine that NetFlow collection is functioning correctly on that device. For sources that are using a USM Appliance Sensor to monitor network traffic and generate NetFlow data from a SPAN/mirrored port, you can follow these steps to validate that NetFlow packets are being generated by the USM Appliance Sensor:

  1. SSH into the USM Appliance Sensor.
  2. Launch the AlienVault Console and select the Jailbreak System option to access the command line.
  3. Run the following command to validate that fprobe is running, that it is listening to the correct interface, and that it is sending packets on the correct port to the USM Appliance Server.

    # ps ax|grep fprobe

    The output from this command should appear similar to the following:

  4. Confirm that –iethX is the correct interface number for the sensor interface connected to the switch SPAN port.
  5. Confirm that the IP address returned is the IP address of the USM Appliance Server.
  6. Confirm that the port number (following the IP address) is the same number you specified in the USM Appliance web UI for the NetFlow configuration.

Checking other possible reasons that nfcapd processes are not receiving NetFlow data

If everything appears to be correctly configured; you see some traffic between fprobe and nfcapd and the NetFlow directory files are written, but running the nfdump command indicates the nfcapd process still isn't receiving NetFlow data, the problem may be due to the following:

The sensor is not configured to listen using the correct interfaces. (Check Configure Sensor > Configure Network Monitoring).

  • The sensor is not configured to listen using the correct interfaces. (Check Configure Sensor > Configure Network Monitoring.)
  • The interface is not receiving traffic (usually due to faulty configuration of the port mirroring). You could check the configuration with the command tcpdump -i <interface>.
  • The interface is receiving traffic, but it is not purely IP traffic. For example, if the interface is receiving tagged VLAN traffic, fprobe is not going to capture the traffic, because generation of NetFlow data from VLAN traffic is not supported. To check if you are monitoring purely IP traffic, you can run the command tcpdump -i <interface> ip.

Validate that NetFlow packets are being received by the USM Appliance Server

  1. SSH into the USM Appliance Server.
  2. Launch the AlienVault Console and select the Jailbreak System option to access the command line.
  3. Validate that nfcapd is running, and listening on the port assigned for the appropriate sensor, by running the following command:

  4. # ps ax|grep nfcapd

    The output should appear similar to the following:

    • There will be multiple instances of nfcapd, one for each NetFlow source.
    • The number after the –p argument should match the port assigned to a particular NetFlow source.

  5. Use tcpdump to validate that packets are being transmitted to the USM Appliance Server.

    # tcpdump –I <interface> ‘port <netflow port>’

    If packets are being received from the NetFlow source, you should see output similar to the following:

  6. Use Ctrl-C to exit tcpdump.

Validate that NetFlow packets are accepted by the USM Appliance Server Firewall

  1. SSH into the USM Appliance Server.

  2. Launch the AlienVault Console and select the Jailbreak System option to access the command line.
  3. Validate that the firewall configuration has an exception configured to allow incoming NetFlow data packets over the appropriate UDP port.

    # iptables –L –n –v |grep <configured port>

    The output should resemble the following:

    The udp dpt segment (destination port) is the important part here, indicating that traffic will be ACCEPTed by the firewall configuration. The number in the left column indicates the number of packets that have previously matched this ACCEPT rule.