{"id":34732486,"url":"https://github.com/bynow2code/rotail","last_synced_at":"2026-05-24T00:32:56.224Z","repository":{"id":327974025,"uuid":"1112947903","full_name":"bynow2code/rotail","owner":"bynow2code","description":"高级版日志实时监控工具 / 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.","archived":false,"fork":false,"pushed_at":"2025-12-25T16:13:34.000Z","size":107,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-26T13:54:59.605Z","etag":null,"topics":["cli","devops","directory-watcher","fsnotify","golang","log-monitoring","log-rotation","logging","observability","rotail","tail"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bynow2code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-09T10:13:39.000Z","updated_at":"2025-12-25T16:13:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bynow2code/rotail","commit_stats":null,"previous_names":["bynow2code/rotail"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/bynow2code/rotail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bynow2code%2Frotail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bynow2code%2Frotail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bynow2code%2Frotail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bynow2code%2Frotail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bynow2code","download_url":"https://codeload.github.com/bynow2code/rotail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bynow2code%2Frotail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33417486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"ssl_error","status_checked_at":"2026-05-23T22:14:43.778Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","devops","directory-watcher","fsnotify","golang","log-monitoring","log-rotation","logging","observability","rotail","tail"],"created_at":"2025-12-25T03:14:32.895Z","updated_at":"2026-05-24T00:32:56.201Z","avatar_url":"https://github.com/bynow2code.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[English version](README.md) | [中文版](README_CN.md)\n\n# rotail\n\n[![Release](https://github.com/bynow2code/rotail/actions/workflows/release.yml/badge.svg)](https://github.com/bynow2code/rotail/actions/workflows/release.yml)\n\n## Introduction\n\nrotail is an enhanced log monitoring tool similar to the `tail -f` command, but with more powerful features. In addition\nto real-time monitoring of individual log files, it can intelligently monitor the latest log files in an entire\ndirectory, automatically switching to new log files when log rotation occurs, ensuring you don't miss any important\ninformation.\n\n## Core Features\n\n- 🔍 **Real-time Log Monitoring** - Track changes in individual log files in real-time\n- 📂 **Directory-level Monitoring** - Automatically discover and monitor the latest log files in a directory\n- 🔄 **Smart Rotation Handling** - Automatically switch to new files during log rotation for seamless transition\n- 🎯 **Flexible File Filtering** - Support custom file extension filters\n- ⚡ **Signal Handling** - Gracefully handle SIGINT and SIGTERM interrupt signals\n- 💻 **User-friendly CLI** - Clean and intuitive command-line experience\n\n## Quick Installation\n\n### Method 1: One-click Installation Script (Recommended)\n\nFor Linux and macOS systems:\n\n```\ncurl -sfL https://raw.githubusercontent.com/bynow2code/rotail/main/install.sh | bash\n```\n\n### Method 2: Manual Download\n\nVisit the [GitHub Releases](https://github.com/bynow2code/rotail/releases/latest) page to download the precompiled\nversion suitable for your system:\n\n- **Windows Users**: Download `rotail-windows-amd64.exe` and rename it to `rotail.exe`\n- **macOS Users**: Download `rotail-darwin-amd64` or `rotail-darwin-arm64`\n- **Linux Users**: Download the corresponding binary file based on your architecture\n\n### Verify Installation\n\nAfter installation, run the following command to verify successful installation:\n\n```\nrotail -v\n```\n\n## Usage Guide\n\n### Monitor a Single Log File\n\n```\nrotail -f /path/to/your/logfile.log\n```\n\n### Monitor an Entire Directory\n\nAutomatically monitor the latest log file in a directory:\n\n```\nrotail -d /path/to/your/logdir\n```\n\n### Specify File Types\n\nMonitor only files with specific extensions:\n\n```\nrotail -d /path/to/your/logdir -ext .log,.txt,.out\n```\n\n### Get Help Information\n\nView all available options:\n\n```\nrotail -h\n```\n\n## Command Line Arguments\n\n| Argument | Description                             | Default |\n|----------|-----------------------------------------|---------|\n| `-f`     | Path to the single file to monitor      |         |\n| `-d`     | Path to the directory to monitor        |         |\n| `-ext`   | File extension filter (comma-separated) | `.log`  |\n| `-v`     | Display version information             |         |\n| `-h`     | Display help information                |         |\n\n## Practical Examples\n\n### Monitor Nginx Access Logs\n\n```\nrotail -f /var/log/nginx/access.log\n```\n\n### Monitor Latest .log Files in System Log Directory\n\n```\nrotail -d /var/log\n```\n\n### Monitor .log and .txt Files in Application Log Directory\n\n```\nrotail -d /app/logs -ext .log,.txt\n```\n\n### Monitor a Single File and Pipe to Another Program\n\n```\nrotail -f app.log | grep ERROR\n```\n\n## Support rotail\n\nIf rotail has been helpful in your workflow, we sincerely invite you to support the project. Your engagement directly\ncontributes to ongoing improvements and long-term maintenance:\n\n1. **Click the ⭐ Star button** in the top-right corner to help others discover rotail\n2. **Share it with your colleagues and friends** who may benefit from it\n3. **Recommend rotail on social media or technical communities** to expand visibility\n\n## Open Source License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbynow2code%2Frotail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbynow2code%2Frotail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbynow2code%2Frotail/lists"}