docs: Rebuild documentation as enterprise-grade TLAS platform
- Migrate from custom HTTP server to VitePress framework - Rename project to Tokenized License Approval System (TLAS) - Add comprehensive documentation for all stakeholders: - Business: Executive summary, value proposition, governance - Operations: Infrastructure, installation, monitoring, backup - Departments: User guide, workflows, verification, issuance - Developers: API reference, authentication, webhooks, SDKs - Compliance: OWASP, DPDP Act, IT Act, audit framework - Add modern theme with dark mode and full-text search - Update Dockerfile for VitePress build process Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
81
Documentation/operations/monitoring.md
Normal file
81
Documentation/operations/monitoring.md
Normal file
@@ -0,0 +1,81 @@
|
||||
# Monitoring & Alerts
|
||||
|
||||
## Health Endpoints
|
||||
|
||||
| Endpoint | Description |
|
||||
|----------|-------------|
|
||||
| `/api/health` | API server health |
|
||||
| `/api/health/db` | Database connectivity |
|
||||
| `/api/health/blockchain` | Besu node status |
|
||||
|
||||
### Health Response
|
||||
|
||||
```json
|
||||
{
|
||||
"status": "healthy",
|
||||
"timestamp": "2026-02-09T10:00:00Z",
|
||||
"components": {
|
||||
"database": "healthy",
|
||||
"blockchain": "healthy",
|
||||
"cache": "healthy"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Application Metrics
|
||||
|
||||
| Metric | Description | Alert Threshold |
|
||||
|--------|-------------|-----------------|
|
||||
| `http_request_duration_seconds` | API response time | > 2s |
|
||||
| `http_requests_total` | Request count | - |
|
||||
| `active_sessions` | Logged-in users | - |
|
||||
| `queue_depth` | Pending jobs | > 1000 |
|
||||
|
||||
### Infrastructure Metrics
|
||||
|
||||
| Metric | Description | Alert Threshold |
|
||||
|--------|-------------|-----------------|
|
||||
| `cpu_usage_percent` | CPU utilization | > 80% |
|
||||
| `memory_usage_percent` | Memory utilization | > 85% |
|
||||
| `disk_usage_percent` | Disk utilization | > 90% |
|
||||
| `db_connection_pool` | Active connections | > 80% of max |
|
||||
|
||||
### Business Metrics
|
||||
|
||||
| Metric | Description |
|
||||
|--------|-------------|
|
||||
| `applications_submitted` | New applications |
|
||||
| `applications_processed` | Completed processing |
|
||||
| `sla_breaches` | SLA violations |
|
||||
| `certificates_issued` | Licenses issued |
|
||||
|
||||
## Alert Configuration
|
||||
|
||||
### Critical Alerts
|
||||
|
||||
- API health check failing
|
||||
- Database unreachable
|
||||
- Blockchain node disconnected
|
||||
- Disk space < 10%
|
||||
|
||||
### Warning Alerts
|
||||
|
||||
- Response time > 2 seconds
|
||||
- Error rate > 1%
|
||||
- SLA breach count increasing
|
||||
- Certificate minting failures
|
||||
|
||||
## Dashboard
|
||||
|
||||
Access Grafana dashboards at:
|
||||
```
|
||||
https://monitoring.tlas.gov.in/grafana
|
||||
```
|
||||
|
||||
Dashboards available:
|
||||
- System Overview
|
||||
- Application Processing
|
||||
- Blockchain Status
|
||||
- SLA Compliance
|
||||
Reference in New Issue
Block a user