npm-tail

npm-tail is a small Bash utility that consolidates and summarizes log data from Nginx Proxy Manager (NPM).

It reads multiple NPM access and error log files and presents the information as short, one-line summaries. These summaries provide a quick, high-level view of traffic and errors across all proxy hosts.

When more detail is required, the original raw log lines from the NPM log files can also be displayed.

---

What it does

• Consolidates access and error logs across all NPM proxy hosts
• Produces compact one-line summary output
• Optionally includes the raw log line beneath each summary
• Supports time-based filtering or simple tailing
• Supports filtering by:
  • public vs. private source IP addresses
  • destination host
  • source IP
• Supports an optional refresh mode for repeated display

---

Usage

Basic form: (run with no args to see full detail)

./npm_tail.sh --minutes N [options]

---

Examples

./npm_tail.sh --minutes 60 --summary --public
./npm_tail.sh 30 --summary --refresh 10
./npm_tail.sh -1 --filter-destination example.com

---

Raw log output

By default, the script prints both a summarized one-line entry and the corresponding raw log line beneath it.

Using the --summary option suppresses the raw log output and displays only the summary lines.

---

Compatibility

This is a personal utility script shared as-is. It may require adjustment for different environments.

This script depends on the log formatting used by Nginx Proxy Manager and is therefore sensitive to changes in that format.

Testing has been performed with:

• Nginx Proxy Manager version 2.13.5
• Ubuntu 24.04
• Docker-based NPM installations using default log locations

Future NPM releases that alter log formatting may require updates to the script.

---

License

MIT