{"id":34976208,"url":"https://github.com/martian56/chatops","last_synced_at":"2025-12-27T00:11:08.535Z","repository":{"id":324487176,"uuid":"1097389576","full_name":"martian56/chatops","owner":"martian56","description":"Monitor and manage all your servers from a single, intuitive web dashboard. Real-time metrics, Docker container control, alerts, and terminal access, all in one place.","archived":false,"fork":false,"pushed_at":"2025-12-12T13:09:03.000Z","size":264,"stargazers_count":11,"open_issues_count":4,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-13T14:20:07.318Z","etag":null,"topics":["agent","chatops","devops","server"],"latest_commit_sha":null,"homepage":"https://chatops.ufazien.com","language":"TypeScript","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/martian56.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-11-16T04:36:13.000Z","updated_at":"2025-12-12T13:09:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/martian56/chatops","commit_stats":null,"previous_names":["martian56/chatops"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/martian56/chatops","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martian56%2Fchatops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martian56%2Fchatops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martian56%2Fchatops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martian56%2Fchatops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martian56","download_url":"https://codeload.github.com/martian56/chatops/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martian56%2Fchatops/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28065839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agent","chatops","devops","server"],"created_at":"2025-12-27T00:11:07.829Z","updated_at":"2025-12-27T00:11:08.527Z","avatar_url":"https://github.com/martian56.png","language":"TypeScript","readme":"# ChatOps\n\n**Unified Server Monitoring \u0026 Management \u0026 Devops Platform**\n\nMonitor and manage all your servers from a single, intuitive web dashboard. Real-time metrics, Docker container control, alerts, and terminal access—all in one place.\n\n---\n\n## 🎯 What is ChatOps?\n\nChatOps is a comprehensive server monitoring and management platform that lets you:\n\n- **Monitor** your servers' CPU, memory, disk, and network in real-time\n- **Control** Docker containers with one-click actions\n- **Alert** on performance thresholds automatically\n- **Execute** commands remotely via web terminal\n- **Track** all system activity with complete audit logs\n\nDeploy a lightweight agent on each server, and start monitoring immediately. No complex setup, no VPNs required—just secure API key authentication.\n\n---\n\n## 🚀 Getting Started\n\n### Step 1: Add Your Server\n\n1. Log into the ChatOps web interface\n2. Navigate to **Servers** from the sidebar\n3. Click **\"Add Server\"**\n4. Enter a name for your server (e.g., \"Production Web Server\")\n5. Click **\"Create\"**\n\n### Step 2: Generate an API Key (keep as super secret)\n\n1. Click on your newly created server\n2. Go to the **\"API Keys\"** tab\n3. Click **\"Create API Key\"**\n4. Optionally give it a name (e.g., \"Main Agent\")\n5. **Copy the API key immediately** - it's only shown once!\n\n### Step 3: Install the Agent\n\nDownload and run the ChatOps agent on your server:\n\n```bash\n# Download the agent binary for your platform\n# Then run:\n./chatops-agent -api-key YOUR_API_KEY_HERE\n```\n\nOr using environment variables:\n\n```bash\nexport CHATOPS_API_KEY=\"your-api-key-here\"\nexport CHATOPS_API_URL=\"https://your-chatops-instance.com\"  # Your ChatOps instance URL\n./chatops-agent\n```\n\n**That's it!** The agent will automatically:\n- Connect to your ChatOps instance\n- Start sending metrics every 5 seconds\n- Enable Docker container management\n- Allow remote command execution\n\nSee [Agent Installation Guide](agent/INSTALLATION.md) for detailed installation instructions, including running as a system service.\n\n---\n\n## 📊 Using ChatOps\n\n### View Real-Time Metrics\n\n1. Navigate to **Servers** from the sidebar\n2. Click on any server to view its details\n3. The **Metrics** tab shows:\n   - **CPU Usage**: Real-time CPU percentage with historical chart\n   - **Memory Usage**: RAM usage and available memory\n   - **Disk Usage**: Disk space by mount point\n   - **Network**: Incoming and outgoing network traffic\n\nAll metrics update in real-time and are stored for historical analysis.\n\n### Monitor Running Processes\n\n1. Open a server's detail page\n2. Go to the **Processes** tab\n3. View all running processes sorted by CPU usage\n4. Use the search bar to filter processes by name\n5. See CPU and memory usage for each process\n\n### Manage Docker Containers\n\n1. Open a server's detail page\n2. Go to the **Containers** tab\n3. View all Docker containers with their status\n4. **Start/Stop/Restart** containers with one click\n5. Click on any container to:\n   - View real-time logs\n   - See container details and resource usage\n   - Manage container lifecycle\n\n### Set Up Alerts\n\n1. Navigate to **Alerts \u0026 Thresholds** from the sidebar\n2. Click **\"Create Threshold\"**\n3. Select:\n   - **Server** (or \"All Servers\" for global alerts)\n   - **Metric Type** (CPU, Memory, Disk, Network)\n   - **Condition** (Above/Below threshold)\n   - **Threshold Value**\n   - **Alert Name**\n4. Click **\"Create\"**\n\nWhen a threshold is exceeded, an alert will automatically appear in:\n- The **Alerts \u0026 Thresholds** page\n- The server's **Logs** tab\n- Real-time notifications\n\n### Execute Commands\n\n1. Open a server's detail page\n2. Go to the **Terminal** tab\n3. Type your command in the terminal\n4. Press Enter to execute\n5. View real-time output\n6. All commands are logged with:\n   - Timestamp\n   - Command executed\n   - Output\n   - Exit code\n   - Duration\n\n### View Logs \u0026 Activity\n\n1. Open a server's detail page\n2. Go to the **Logs** tab\n3. See a unified view of:\n   - **Application Logs**: System and application events\n   - **Alerts**: All triggered alerts\n   - **System Events**: Agent connections/disconnections\n   - **Historical Logs**: Past log entries from the database\n\nLogs are color-coded by level (INFO, WARNING, ERROR) and update in real-time.\n\n### View Command History\n\n1. Navigate to **Servers** from the sidebar\n2. Click on any server\n3. Go to the **Terminal** tab\n4. Scroll up to see all previously executed commands\n5. Each entry shows:\n   - Command executed\n   - Output\n   - Exit code\n   - Execution time\n\n---\n\n## 🔐 Security Features\n\n- **Secure Authentication**: JWT-based authentication with refresh tokens\n- **API Key Management**: Generate, view, and revoke API keys per server\n- **Audit Trail**: Complete history of all user actions\n- **Connection Tracking**: Monitor when agents connect and disconnect\n- **Command Logging**: All terminal commands are logged with full output\n\n---\n\n## 🎨 Dashboard Overview\n\nThe ChatOps dashboard provides:\n\n- **Servers List**: View all your servers at a glance with status indicators\n- **Server Details**: Deep dive into each server's metrics, containers, processes, and logs\n- **Alerts \u0026 Thresholds**: Manage alert configurations and view active alerts\n- **Settings**: Update your profile and change your password\n\nAll data updates in real-time via WebSocket connections—no page refresh needed!\n\n---\n\n## 📱 Features at a Glance\n\n| Feature | Location | Description |\n|---------|----------|-------------|\n| **Metrics** | Server → Metrics tab | Real-time CPU, memory, disk, network charts |\n| **Processes** | Server → Processes tab | All running processes with search |\n| **Containers** | Server → Containers tab | Docker container management |\n| **Terminal** | Server → Terminal tab | Remote command execution |\n| **Logs** | Server → Logs tab | Unified log viewer |\n| **Alerts** | Alerts \u0026 Thresholds page | Configure and view alerts |\n| **API Keys** | Server → API Keys tab | Manage agent authentication |\n\n---\n\n## 🎯 Use Cases\n\n- **Server Monitoring**: Monitor multiple servers from a single dashboard\n- **Container Management**: Control Docker containers without SSH access\n- **Performance Tracking**: Track system performance over time\n- **Incident Response**: Quickly identify and respond to system issues\n- **Audit Compliance**: Maintain complete audit trails for compliance\n- **Remote Management**: Manage servers without direct SSH access\n\n---\n\n## 📄 License\n\nMIT License - see LICENSE file for details\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n---\n\n## 📧 Support\n\nFor issues and questions, please open an issue on GitHub.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartian56%2Fchatops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartian56%2Fchatops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartian56%2Fchatops/lists"}