https://github.com/bynow2code/rotail
高级版日志实时监控工具 / Advanced real-time log monitoring tool 自动跟踪目录最新日志文件，智能处理日志轮转，确保持续输出最新内容。适用于开发调试、运维监控与容器环境。 Automatically follows the latest log file in a directory and handles log rotation seamlessly, ensuring continuous and up-to-date output. Ideal for development, operations, and container environments.
https://github.com/bynow2code/rotail
cli devops directory-watcher fsnotify golang log-monitoring log-rotation logging observability rotail tail
Last synced: 27 days ago
JSON representation
高级版日志实时监控工具 / Advanced real-time log monitoring tool 自动跟踪目录最新日志文件，智能处理日志轮转，确保持续输出最新内容。适用于开发调试、运维监控与容器环境。 Automatically follows the latest log file in a directory and handles log rotation seamlessly, ensuring continuous and up-to-date output. Ideal for development, operations, and container environments.
- Host: GitHub
- URL: https://github.com/bynow2code/rotail
- Owner: bynow2code
- License: mit
- Created: 2025-12-09T10:13:39.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-25T16:13:34.000Z (6 months ago)
- Last Synced: 2025-12-26T13:54:59.605Z (6 months ago)
- Topics: cli, devops, directory-watcher, fsnotify, golang, log-monitoring, log-rotation, logging, observability, rotail, tail
- Language: Go
- Homepage:
- Size: 104 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[English version](README.md) | [中文版](README_CN.md)
# rotail
[](https://github.com/bynow2code/rotail/actions/workflows/release.yml)
## Introduction
rotail is an enhanced log monitoring tool similar to the `tail -f` command, but with more powerful features. In addition
to real-time monitoring of individual log files, it can intelligently monitor the latest log files in an entire
directory, automatically switching to new log files when log rotation occurs, ensuring you don't miss any important
information.
## Core Features
- 🔍 **Real-time Log Monitoring** - Track changes in individual log files in real-time
- 📂 **Directory-level Monitoring** - Automatically discover and monitor the latest log files in a directory
- 🔄 **Smart Rotation Handling** - Automatically switch to new files during log rotation for seamless transition
- 🎯 **Flexible File Filtering** - Support custom file extension filters
- ⚡ **Signal Handling** - Gracefully handle SIGINT and SIGTERM interrupt signals
- 💻 **User-friendly CLI** - Clean and intuitive command-line experience
## Quick Installation
### Method 1: One-click Installation Script (Recommended)
For Linux and macOS systems:
```
curl -sfL https://raw.githubusercontent.com/bynow2code/rotail/main/install.sh | bash
```
### Method 2: Manual Download
Visit the [GitHub Releases](https://github.com/bynow2code/rotail/releases/latest) page to download the precompiled
version suitable for your system:
- **Windows Users**: Download `rotail-windows-amd64.exe` and rename it to `rotail.exe`
- **macOS Users**: Download `rotail-darwin-amd64` or `rotail-darwin-arm64`
- **Linux Users**: Download the corresponding binary file based on your architecture
### Verify Installation
After installation, run the following command to verify successful installation:
```
rotail -v
```
## Usage Guide
### Monitor a Single Log File
```
rotail -f /path/to/your/logfile.log
```
### Monitor an Entire Directory
Automatically monitor the latest log file in a directory:
```
rotail -d /path/to/your/logdir
```
### Specify File Types
Monitor only files with specific extensions:
```
rotail -d /path/to/your/logdir -ext .log,.txt,.out
```
### Get Help Information
View all available options:
```
rotail -h
```
## Command Line Arguments
| Argument | Description | Default |
|----------|-----------------------------------------|---------|
| `-f` | Path to the single file to monitor | |
| `-d` | Path to the directory to monitor | |
| `-ext` | File extension filter (comma-separated) | `.log` |
| `-v` | Display version information | |
| `-h` | Display help information | |
## Practical Examples
### Monitor Nginx Access Logs
```
rotail -f /var/log/nginx/access.log
```
### Monitor Latest .log Files in System Log Directory
```
rotail -d /var/log
```
### Monitor .log and .txt Files in Application Log Directory
```
rotail -d /app/logs -ext .log,.txt
```
### Monitor a Single File and Pipe to Another Program
```
rotail -f app.log | grep ERROR
```
## Support rotail
If rotail has been helpful in your workflow, we sincerely invite you to support the project. Your engagement directly
contributes to ongoing improvements and long-term maintenance:
1. **Click the ⭐ Star button** in the top-right corner to help others discover rotail
2. **Share it with your colleagues and friends** who may benefit from it
3. **Recommend rotail on social media or technical communities** to expand visibility
## Open Source License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.