PHPackages cms-orbit/vigilance - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. cms-orbit/vigilance ActiveLibrary[Logging & Monitoring](/categories/logging) cms-orbit/vigilance =================== Laravel 서버 모니터링 에이전트 패키지 1.2.0(7mo ago)073MITPHPPHP ^8.0 Since Oct 11Pushed 7mo agoCompare [ Source](https://github.com/cms-orbit/vigilance)[ Packagist](https://packagist.org/packages/cms-orbit/vigilance)[ RSS](/packages/cms-orbit-vigilance/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (2)Versions (4)Used By (0) Vigilance - Laravel 서버 모니터링 에이전트 ================================ [](#vigilance---laravel-서버-모니터링-에이전트) Vigilance는 Laravel 프로젝트에 설치되어 시스템 상태를 수집하고 1분마다 Sentinel-Hub로 전송하는 경량 모니터링 에이전트입니다. 특징 -- [](#특징) - 🔍 **실시간 시스템 모니터링**: CPU, 메모리, 디스크 사용량 자동 수집 - 📊 **프로세스 모니터링**: 메모리를 많이 사용하는 프로세스 추적 - 🚨 **오류 로그 수집**: Laravel 로그 파일에서 오류를 자동으로 감지하고 중복 제거 - 🔄 **자동 재시도**: 전송 실패 시 지수 백오프 기반 재시도 - 🖥️ **크로스 플랫폼**: Linux, Windows, macOS 지원 - ⚡ **경량 설계**: 시스템 리소스 최소 사용 요구사항 ---- [](#요구사항) - PHP 8.0 이상 - Laravel 9.0 이상 (Laravel 9, 10, 11 지원) - Guzzle HTTP Client 7.0 이상 ### 호환성 매트릭스 [](#호환성-매트릭스) Laravel 버전PHP 버전Vigilance 지원Laravel 11PHP 8.2+✅ 완벽 지원Laravel 10PHP 8.1+✅ 완벽 지원Laravel 9PHP 8.0+✅ 완벽 지원Laravel 8 이하-❌ 미지원설치 -- [](#설치) ### 1. Composer를 통한 패키지 설치 [](#1-composer를-통한-패키지-설치) ``` composer require cms-orbit/vigilance ``` > **업그레이드 노트:** v1.0.1에서 v1.1.0으로 업그레이드하는 경우, 별도의 설정 변경이 필요하지 않습니다. 모든 기능이 하위 호환성을 유지합니다. ### 2. 환경 설정 [](#2-환경-설정) `.env` 파일에 Sentinel-Hub URL을 추가하세요: ``` SENTINEL_HUB_URL=https://sentinel-hub.amuz.co.kr ``` **참고:** - 서버 UUID(`VIGILANCE_SERVER_ID`)는 자동으로 생성됩니다. - 스케줄러는 자동으로 등록됩니다. - 1분마다 자동으로 서버 상태를 전송합니다. ### 3. 크론 작업 설정 (서버에서 한 번만 설정) [](#3-크론-작업-설정-서버에서-한-번만-설정) Laravel 스케줄러가 작동하려면 서버에 크론 작업을 추가해야 합니다: ``` * * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1 ``` 설정 -- [](#설정) `config/vigilance.php` 파일에서 다양한 설정을 조정할 수 있습니다: ``` return [ // Sentinel-Hub 도메인 (API 엔드포인트 경로는 자동 추가됨) 'base_url' => env('SENTINEL_HUB_URL', 'http://localhost'), // 서버 UUID 'server_uuid' => env('VIGILANCE_SERVER_ID', ''), // 모니터링할 디스크 경로 'disk_paths' => [ '/', ], // 모니터링할 로그 파일 prefix // 데일리 로그 (laravel-2025-10-11.log) 지원 'log_monitor_prefixes' => [ storage_path('logs/laravel'), ], // 재시도 설정 'retry' => [ 'max_attempts' => 3, 'initial_delay' => 1, 'max_delay' => 60, ], // HTTP 타임아웃 (초) 'timeout' => 10, ]; ``` 사용법 --- [](#사용법) ### 자동 모니터링 [](#자동-모니터링) 패키지 설치 후 아무 작업 없이 자동으로 1분마다 서버 상태가 전송됩니다. ### 수동 보고서 전송 (테스트용) [](#수동-보고서-전송-테스트용) ``` php artisan vigilance:report ``` ### 전송 데이터 구조 [](#전송-데이터-구조) Vigilance는 다음 형식의 JSON 데이터를 Sentinel-Hub로 전송합니다: ``` { "uuid": "서버 고유 UUID", "reported_at": "2025-10-10T12:00:00+00:00", "referer": "http://example.com", "system_info": { "os_name": "Linux", "os_version": "Ubuntu 22.04 LTS", "cpu_cores": 8, "php_version": "8.3.0", "laravel_version": "11.0.0" }, "metrics": { "cpu": { "load_avg": [0.5, 0.6, 0.7], "total_usage_percent": 25.5, "core_details": [] }, "memory": { "total_mb": 16384, "used_mb": 8192, "usage_percent": 50.0, "process_details": [...] }, "disks": [...], "health_check": { "db_connection": "ok", "queue_status": "ok", "message": "All systems operational" } }, "errors": [...] } ``` 아키텍처 ---- [](#아키텍처) ### StatusGetter 상속 구조 [](#statusgetter-상속-구조) ``` AbstractStatusGetter (추상 클래스) ├── LinuxStatusGetter │ ├── Ubuntu24StatusGetter │ ├── Ubuntu22StatusGetter │ ├── Ubuntu20StatusGetter │ ├── CentosStatusGetter │ ├── RockyStatusGetter │ └── DebianStatusGetter ├── WindowsStatusGetter │ ├── Windows11StatusGetter │ ├── Windows10StatusGetter │ └── WindowsServerStatusGetter └── MacStatusGetter ``` **자동 OS 감지:** - Linux 배포판 자동 식별 (Ubuntu 버전별, CentOS, Rocky Linux, Debian) - Windows 버전 자동 식별 (Windows 10, 11, Server) - macOS 지원 각 OS별 StatusGetter는 다음 메소드를 구현합니다: - `getCpuData()`: CPU 사용률 및 로드 에버리지 - `getMemoryData()`: 메모리 사용량 및 프로세스 정보 - `getDiskData()`: 디스크 사용량 - `getSystemInfo()`: 시스템 환경 정보 - `getHealthCheck()`: DB 연결 및 큐 상태 확인 ### LogMonitor [](#logmonitor) 로그 파일을 모니터링하고 오류를 수집합니다: - **Prefix 기반 로그 파일 매칭**: 데일리 로그 자동 지원 (laravel.log, laravel-2025-10-11.log 등) - **중복 제거**: SHA256 해시 생성으로 동일 오류 식별 - **카운팅**: 1분 간격으로 발생한 동일 오류 횟수 집계 - **메시지 요약**: 200자 제한으로 DB 최적화 - **파일 경로 추출**: Exception 스택에서 정확한 파일과 라인 번호 추출 버전 히스토리 ------- [](#버전-히스토리) 자세한 변경 사항은 [CHANGELOG.md](CHANGELOG.md)를 참조하세요. ### v1.1.2 (현재) [](#v112-현재) - **문서 및 설정 개선**: `.gitignore`, `.gitattributes` 추가 - README 문서 보완 (호환성 매트릭스, 업그레이드 가이드) - CHANGELOG 문서 개선 ### v1.1.0 [](#v110) - **하위 호환성 개선**: PHP 8.0+, Laravel 9.0+ 지원 - 모든 기존 기능 유지 - 추가 설정 변경 불필요 ### v1.0.1 [](#v101) - 초기 릴리스 라이선스 ---- [](#라이선스) MIT License 지원 -- [](#지원) 문제가 발생하거나 기능 제안이 있으시면 GitHub Issues를 통해 알려주세요. ### Health Score 33 — LowBetter than 75% of packages Maintenance64 Regular maintenance activity Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 3 Last Release 217d ago PHP version history (2 changes)1.0.1PHP ^8.2 1.1.2PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/3d4228d7eaafb1a5b13e853f87189815feefd9c21f31363d08ec509c47f29d0a?d=identicon)[cms-orbit](/maintainers/cms-orbit) --- Top Contributors [![XisoDev](https://avatars.githubusercontent.com/u/10387955?v=4)](https://github.com/XisoDev "XisoDev (9 commits)") ### Embed Badge ![Health badge](/badges/cms-orbit-vigilance/health.svg) ``` [![Health](https://phpackages.com/badges/cms-orbit-vigilance/health.svg)](https://phpackages.com/packages/cms-orbit-vigilance) ``` ### Alternatives [spatie/laravel-health Monitor the health of a Laravel application 86910.0M83](/packages/spatie-laravel-health)[marvinlabs/laravel-discord-logger Logging to a discord channel in Laravel 2081.1M2](/packages/marvinlabs-laravel-discord-logger)[larabug/larabug Laravel 6.x/7.x/8.x/9.x/10.x/11.x/12.x/13.x bug notifier 299549.3k1](/packages/larabug-larabug)[kitloong/laravel-app-logger Laravel log for your application 101.2M8](/packages/kitloong-laravel-app-logger)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum)[shaffe/laravel-mail-log-channel A package to support logging via email in Laravel 1286.2k](/packages/shaffe-laravel-mail-log-channel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)