Collecting Logs - ziti-edge-tunnel (Linux Tunneler)

Follow

About :

This article covers the steps involved in collecting logs from a NetFoundry ziti-edge-tunnel endpoint.

Steps:

1. Run the transparent intercepting proxy (tun device) with built-in nameserver.

sudo ./ziti-edge-tunnel run --identity myTunneler.json

2. Generate logs and re-direct to file “log” instead of your screen.

sudo ./ziti-edge-tunnel run --verbose 6 --identity myTunneler.json 2>>log.txt

Setting the logging level

At times, our customer support team might ask for increasing the logging level for collecting more information.

Logs are by default collected with log level 3 and for troubleshooting issues, NetFoundry Support team would request for logs with detailed level (log level 6).

Note: make sure to bring back the log level to 3 once the issue is resolved to prevent disk space being over utilized

Handling tunneler crash: 

• If the tunneler is crashing then it may be crucial to collect and analyze the core dump file. You may need to enable saving core dumps depending upon your OS configuration.
• You can see how dump files are handled by inspecting this file, which is from Ubuntu 20.10.

❯ cat /proc/sys/kernel/core_pattern
|/usr/share/apport/apport %p %s %c %d %P %E

In this case the dump is handled by apport which saves the file in /var/crash.

Attaching logs

Logs up to 15 MB can be sent over e-mail to Netfoundry Support. However, logs up to 50 MB can be uploaded by logging into NetFoundry Support Hub Portal.