Troubleshooting

Systemd

For systems using Systemd, check the status for any helpful information. 

sudo systemctl status netifyd
○ netifyd.service - Netify Agent
     Loaded: loaded (/lib/systemd/system/netifyd.service; disabled; vendor preset: enabled)
     Active: inactive (dead)
       Docs: man:netifyd(8)
             man:netifyd.conf(5)
             https://netify.ai/

Oct 13 10:40:56 systemd[1]: netifyd.service: Deactivated successfully.

Init

For systems using Init, check the status using the Netify init script. 

/etc/init.d/netifyd status

Netify Daemon Flags

Netify's command line wrapper for the daemon, netifyd, can be a valuable source of information into the inner workings, configuration and status of the agent running in the background.

Version

Use the -V flag to display version information of the agent as well as plugin status. In many cases, unexpected results are simply a result of forgetting to enable a plugin.

sudo netifyd -V
    Netify Agent/4.3.3 (openwrt; arm; conntrack; netlink; dns-cache; plugins; regex)
https://www.netify.ai/

This application uses nDPI v4.5.0-0-, API v0
https://www.ntop.org/products/deep-packet-inspection/ndpi/
https://github.com/ntop/nDPI

  This program comes with ABSOLUTELY NO WARRANTY.
  Netifyd is dual-licensed under commercial and open source licenses. The
  commercial license gives you the full rights to create and distribute software
  on your own terms without any open source license obligations.

  Netifyd is also available under GPL and LGPL open source licenses.  The open
  source licensing is ideal for student/academic purposes, hobby projects,
  internal research project, or other projects where all open source license
  obligations can be met.

Report bugs to: https://gitlab.com/netify.ai/public/netify-agent/issues

Detection plugins:
  np-ipset: /usr/lib/libnetify-plugin-ipset.so.0.0.0: v2.0.2

For example, if you are expecting the Netify Flow Actions plugin to be creating an ipset and populating it based on criteria you've set and it is not performing this action, the above output indicates the Flow Actions plugin is not enabled.

Debug

Use the -d flag to run the Netify agent in the foreground (instead of as a background daemond) - detailed information will be displayed at every stage of the startup sequence and continue into the traffic analysis. 

sudo netifyd -d

To stop this process, click CTRL-c.

Process Status

Use the ps command to show any running Netify processes. Note whether the PID is changing, indicating an agent that is restarting. 

ps afxw | grep netifyd

Logs

The Netify agent logs to standard tools in use, as per the platform it was installed on. Consult the log files frequently when making initial changes to configuration files and reloading/restarting the agent to catch any errors you may have introduced. It is recommended to tail the log file, using grep to filter out unnecesssary output.

Linux Mainstream Distros

cat /var/log/syslog | grep netifyd

OpenWRT

logread | grep netifyd
Tue Oct 15 14:49:07 2024 daemon.info netifyd[9972]: /etc/netify.d/dns-cache.csv: parse error at line #2 [-1]
Tue Oct 15 14:49:08 2024 daemon.info netifyd[9972]: Unable to hash file: /etc/netify.d/netify-sink.conf: No such file or directory
Tue Oct 15 14:49:08 2024 daemon.info netifyd[9972]: Error opening directory: /etc/netify.d/domains.d: No such file or directory
Tue Oct 15 14:49:08 2024 daemon.info netifyd[9972]: np-ipset: Netify ipset Plugin, v2.0.2
Tue Oct 15 14:49:08 2024 daemon.info netifyd[9972]: np-ipset: Copyright (C) 2021 eGloo Incorporated.

Technical Support

In order to help us help you, please include the following information with any support ticket:

  • Output from netifyd -V
  • Output from any log, systemd or init output that appears relevant
  • Attach any relevant configuration files
  • Your Netify Informatics account (if relevant)

To open a support ticket, please email support@netify.ai.

Further Reading

Documentation


Netify DPI Agent


Technical Support

Haven't found the answers you're looking for?

Contact Us