Headless Sentry

🇻🇳 Tiếng Việt

Một hệ thống giám sát uptime và performance mạnh mẽ được xây dựng với Nuxt 3, MongoDB Time Series và AWS S3. Headless Sentry cung cấp giải pháp monitoring toàn diện cho websites và APIs của bạn với khả năng cảnh báo realtime và status page công khai.

✨ Tính năng chính

🚀 Monitoring đa dạng: HTTP/HTTPS endpoints, SSL certificates, error rates
📊 Time Series Database: Sử dụng MongoDB Time Series để lưu trữ dữ liệu hiệu quả
🔔 Cảnh báo realtime: Thông báo ngay khi có sự cố
🌐 Status Page: Trang trạng thái công khai cho khách hàng
👥 Quản lý team: Hỗ trợ nhiều thành viên với phân quyền
📈 Dashboard trực quan: Biểu đồ và metrics chi tiết
🔐 Bảo mật: Authentication với nuxt-auth-utils
⚡ Cron Jobs: Tự động kiểm tra theo lịch định sẵn

🛠️ Tech Stack

Frontend: Nuxt 3, Vue 3, TypeScript
UI Framework: Nuxt UI, TailwindCSS
Backend: Nuxt Server API
Database: MongoDB với Time Series collections
Authentication: nuxt-auth-utils
Storage: AWS S3 (presigned URLs)
Cron Jobs: nuxt-cron
Charts: Unovis
Validation: Zod

📋 Yêu cầu hệ thống

Node.js 18+
pnpm (khuyến nghị)
MongoDB 5.0+ (hỗ trợ Time Series)
AWS S3 bucket (cho upload files)

🚀 Cài đặt

1. Clone repository

git clone https://github.com/pin705/headless-sentry.git
cd headless-sentry

2. Cài đặt dependencies

pnpm install

3. Cấu hình environment variables

Tạo file .env từ template:

cp .env.example .env

Cập nhật các biến môi trường:

# Database
MONGODB_URI=mongodb://localhost:27017/headless-sentry

# Authentication (generate random strings)
NUXT_SESSION_PASSWORD=your-32-char-session-password
NUXT_OAUTH_GITHUB_CLIENT_ID=your-github-oauth-client-id
NUXT_OAUTH_GITHUB_CLIENT_SECRET=your-github-oauth-client-secret

# AWS S3 (for file uploads)
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
AWS_REGION=us-east-1
AWS_S3_BUCKET=your-s3-bucket-name

# Application
NUXT_PUBLIC_APP_URL=http://localhost:3000

4. Khởi tạo MongoDB Time Series Collection

⚠️ Quan trọng: Bạn cần tạo collection results với Time Series một lần duy nhất.

Kết nối vào MongoDB và chạy lệnh sau:

// Chuyển sang database của bạn
use headless-sentry

// Tạo Time Series collection
db.createCollection("results", {
   timeseries: {
      timeField: "timestamp",
      metaField: "meta", 
      granularity: "minutes"
   }
})

Chi tiết xem trong file NOTES.md.

🔧 Development

Khởi động development server

pnpm dev

Server sẽ chạy tại http://localhost:3000

Các lệnh hữu ích

# Lint code
pnpm lint

# Type checking
pnpm typecheck

# Build production
pnpm build

# Preview production build
pnpm preview

📁 Cấu trúc dự án

├── app/
│   ├── components/          # Vue components
│   ├── pages/              # Nuxt pages & routing
│   ├── composables/        # Vue composables
│   ├── middleware/         # Route middleware
│   └── layouts/            # Layout components
├── server/
│   ├── api/                # Server API endpoints
│   ├── cron/               # Cron job definitions
│   ├── models/             # MongoDB models
│   └── utils/              # Server utilities
├── public/                 # Static assets
└── ecosystem.config.cjs    # PM2 configuration

🔄 Cron Jobs

Hệ thống sử dụng các cron job để monitoring tự động:

monitorCheck.cron.ts: Kiểm tra uptime endpoints
sslCheck.cron.ts: Kiểm tra SSL certificates
errorRateCheck.cron.ts: Giám sát error rates

Cron jobs chạy theo timezone Asia/Ho_Chi_Minh và có thể cấu hình trong nuxt.config.ts.

🚀 Production Deployment

Sử dụng PM2

# Build application
pnpm build

# Start với PM2
pm2 start ecosystem.config.cjs

# Monitor
pm2 monit

# Stop
pm2 stop headless-sentry

Docker (tùy chọn)

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY .output .output
EXPOSE 3000
CMD ["node", ".output/server/index.mjs"]

🌐 Status Page

Mỗi project có thể tạo status page công khai với:

Custom slug (vd: /status/my-service)
Custom domain support
Logo và branding tùy chỉnh
Hiển thị uptime realtime

🔐 Authentication

Hỗ trợ nhiều phương thức đăng nhập:

GitHub OAuth
Email/Password (tùy chọn)
Session management với nuxt-auth-utils

🤝 Contributing

Fork repository
Tạo feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Tạo Pull Request

📝 License

Dự án này được phân phối dưới MIT License.

🐛 Bug Reports & Feature Requests

Vui lòng tạo GitHub Issue để báo cáo lỗi hoặc đề xuất tính năng mới.

📞 Support

📧 Email: [your-email@domain.com]
💬 Discussions: GitHub Discussions
📖 Documentation: Wiki

⭐ Nếu dự án hữu ích, hãy cho chúng tôi một star trên GitHub!

🇺🇸 English

A powerful uptime and performance monitoring system built with Nuxt 3, MongoDB Time Series, and AWS S3. Headless Sentry provides comprehensive monitoring solutions for your websites and APIs with real-time alerts and public status pages.

✨ Key Features

🚀 Multi-type Monitoring: HTTP/HTTPS endpoints, SSL certificates, error rates
📊 Time Series Database: Uses MongoDB Time Series for efficient data storage
🔔 Real-time Alerts: Instant notifications when issues occur
🌐 Status Pages: Public status pages for your customers
👥 Team Management: Multi-member support with role-based permissions
📈 Visual Dashboard: Detailed charts and metrics
🔐 Security: Authentication with nuxt-auth-utils
⚡ Cron Jobs: Automated scheduled monitoring

🛠️ Tech Stack

Frontend: Nuxt 3, Vue 3, TypeScript
UI Framework: Nuxt UI, TailwindCSS
Backend: Nuxt Server API
Database: MongoDB with Time Series collections
Authentication: nuxt-auth-utils
Storage: AWS S3 (presigned URLs)
Cron Jobs: nuxt-cron
Charts: Unovis
Validation: Zod

📋 System Requirements

Node.js 18+
pnpm (recommended)
MongoDB 5.0+ (Time Series support)
AWS S3 bucket (for file uploads)

🚀 Installation

1. Clone repository

git clone https://github.com/pin705/headless-sentry.git
cd headless-sentry

2. Install dependencies

pnpm install

3. Configure environment variables

Create .env file from template:

cp .env.example .env

Update environment variables:

# Database
MONGODB_URI=mongodb://localhost:27017/headless-sentry

# Authentication (generate random strings)
NUXT_SESSION_PASSWORD=your-32-char-session-password
NUXT_OAUTH_GITHUB_CLIENT_ID=your-github-oauth-client-id
NUXT_OAUTH_GITHUB_CLIENT_SECRET=your-github-oauth-client-secret

# AWS S3 (for file uploads)
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
AWS_REGION=us-east-1
AWS_S3_BUCKET=your-s3-bucket-name

# Application
NUXT_PUBLIC_APP_URL=http://localhost:3000

4. Initialize MongoDB Time Series Collection

⚠️ Important: You need to create the results collection with Time Series once.

Connect to MongoDB and run:

// Switch to your database
use headless-sentry

// Create Time Series collection
db.createCollection("results", {
   timeseries: {
      timeField: "timestamp",
      metaField: "meta", 
      granularity: "minutes"
   }
})

See NOTES.md for details.

🔧 Development

Start development server

pnpm dev

Server will run at http://localhost:3000

Useful commands

# Lint code
pnpm lint

# Type checking
pnpm typecheck

# Build production
pnpm build

# Preview production build
pnpm preview

📁 Project Structure

├── app/
│   ├── components/          # Vue components
│   ├── pages/              # Nuxt pages & routing
│   ├── composables/        # Vue composables
│   ├── middleware/         # Route middleware
│   └── layouts/            # Layout components
├── server/
│   ├── api/                # Server API endpoints
│   ├── cron/               # Cron job definitions
│   ├── models/             # MongoDB models
│   └── utils/              # Server utilities
├── public/                 # Static assets
└── ecosystem.config.cjs    # PM2 configuration

🔄 Cron Jobs

The system uses cron jobs for automated monitoring:

monitorCheck.cron.ts: Check endpoint uptime
sslCheck.cron.ts: Check SSL certificates
errorRateCheck.cron.ts: Monitor error rates

Cron jobs run in Asia/Ho_Chi_Minh timezone and can be configured in nuxt.config.ts.

🚀 Production Deployment

Using PM2

# Build application
pnpm build

# Start with PM2
pm2 start ecosystem.config.cjs

# Monitor
pm2 monit

# Stop
pm2 stop headless-sentry

Docker (optional)

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY .output .output
EXPOSE 3000
CMD ["node", ".output/server/index.mjs"]

🌐 Status Page

Each project can create public status pages with:

Custom slug (e.g., /status/my-service)
Custom domain support
Logo and custom branding
Real-time uptime display

🔐 Authentication

Supports multiple login methods:

GitHub OAuth
Email/Password (optional)
Session management with nuxt-auth-utils

🤝 Contributing

Fork the repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Create Pull Request

📝 License

This project is distributed under MIT License.

🐛 Bug Reports & Feature Requests

Please create GitHub Issues to report bugs or request new features.

📞 Support

📧 Email: [your-email@domain.com]
💬 Discussions: GitHub Discussions
📖 Documentation: Wiki

⭐ If this project is helpful, please give us a star on GitHub!

Name		Name	Last commit message	Last commit date
Latest commit History 60 Commits
.vscode		.vscode
app		app
i18n/locales		i18n/locales
public		public
server		server
shared		shared
.editorconfig		.editorconfig
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
COMPONENTS.md		COMPONENTS.md
FEATURES.md		FEATURES.md
IMPLEMENTATION_SUMMARY.md		IMPLEMENTATION_SUMMARY.md
MIGRATION.md		MIGRATION.md
NEW_FEATURES_README.md		NEW_FEATURES_README.md
PLAN_UPGRADE_GUIDE.md		PLAN_UPGRADE_GUIDE.md
README.md		README.md
ecosystem.config.cjs		ecosystem.config.cjs
eslint.config.mjs		eslint.config.mjs
nuxt.config.ts		nuxt.config.ts
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json

pin705/headless-sentry

Folders and files

Latest commit

History

Repository files navigation

Headless Sentry

✨ Tính năng chính

🛠️ Tech Stack

📋 Yêu cầu hệ thống

🚀 Cài đặt

1. Clone repository

2. Cài đặt dependencies

3. Cấu hình environment variables

4. Khởi tạo MongoDB Time Series Collection

🔧 Development

Khởi động development server

Các lệnh hữu ích

📁 Cấu trúc dự án

🔄 Cron Jobs

🚀 Production Deployment

Sử dụng PM2

Docker (tùy chọn)

🌐 Status Page

🔐 Authentication

🤝 Contributing

📝 License

🐛 Bug Reports & Feature Requests

📞 Support

✨ Key Features

🛠️ Tech Stack

📋 System Requirements

🚀 Installation

1. Clone repository

2. Install dependencies

3. Configure environment variables

4. Initialize MongoDB Time Series Collection

🔧 Development

Start development server

Useful commands

📁 Project Structure

🔄 Cron Jobs

🚀 Production Deployment

Using PM2

Docker (optional)

🌐 Status Page

🔐 Authentication

🤝 Contributing

📝 License

🐛 Bug Reports & Feature Requests

📞 Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Uh oh!

Languages

Packages