Anya Core Monitoring Dashboards¶
Table of Contents¶
[AIR-3][AIS-3][BPC-3][RES-3]
Overview¶
This document provides detailed information about the monitoring dashboards available in the Anya Core monitoring stack. These dashboards are designed to provide real-time visibility into the health and performance of your Anya Core node and its components.
Dashboard Index¶
1. Anya Core Overview¶
- Purpose: High-level view of node health and status
- Access:
http://<grafana-host>:3000/d/anya-overview
- Refresh Rate: 15s
- Retention: 30 days
2. Bitcoin Node Metrics¶
- Purpose: Detailed Bitcoin node metrics and performance
- Access:
http://<grafana-host>:3000/d/bitcoin-node
- Refresh Rate: 15s
- Retention: 30 days
3. System Resources¶
- Purpose: Host system resource utilization
- Access:
http://<grafana-host>:3000/d/system
- Refresh Rate: 15s
- Retention: 7 days
4. Network Monitoring¶
- Purpose: Network I/O and connectivity
- Access:
http://<grafana-host>:3000/d/network
- Refresh Rate: 15s
- Retention: 7 days
5. Alert Dashboard¶
- Purpose: View and manage active alerts
- Access:
http://<grafana-host>:3000/d/alerts
- Refresh Rate: 30s
- Retention: 90 days
Dashboard Details¶
Anya Core Overview¶
Panels¶
- Node Status
- Uptime
- Sync status
- Version information
-
Network (mainnet/testnet/regtest)
-
Performance
- Transactions per second
- Mempool size
- Block processing time
-
Peer connections
-
Resource Usage
- CPU/Memory/Disk usage
- I/O operations
- Network traffic
Bitcoin Node Metrics¶
Panels¶
- Blockchain
- Block height
- Headers
- Verification progress
-
IBD status
-
Mempool
- Transaction count
- Size in MB
- Fee rates
-
Orphan transactions
-
P2P Network
- Peer count
- Banned peers
- Bytes sent/received
- Ping time
Customizing Dashboards¶
Adding New Panels¶
- Log in to Grafana
- Navigate to the desired dashboard
- Click "Add Panel" > "Add new panel"
- Configure the panel with PromQL queries
- Set appropriate thresholds and alerts
Importing Dashboards¶
- Download dashboard JSON from source
- In Grafana, click "+" > "Import"
- Upload the JSON file
- Select the data source (Prometheus)
- Click "Import"
Alerting¶
Pre-configured Alerts¶
Alert Name | Severity | Condition | Description |
---|---|---|---|
NodeDown | Critical | up == 0 |
Node is down |
HighCPU | Warning | rate(node_cpu_seconds_total{mode!="idle"}[5m]) > 0.9 |
High CPU usage |
LowDiskSpace | Warning | node_filesystem_avail_bytes{mountpoint="/"} / node_filesystem_size_bytes{mountpoint="/"} < 0.2 |
Low disk space |
HighMemUsage | Warning | (node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes > 0.9 |
High memory usage |
Creating Custom Alerts¶
- Navigate to Alerting > Alert rules
- Click "New alert rule"
- Define the alert conditions using PromQL
- Set alert labels and annotations
- Configure notification policies
Troubleshooting¶
Common Issues¶
- No Data in Panels
- Verify Prometheus is running
- Check service discovery configuration
-
Verify network connectivity between Prometheus and targets
-
High Load on Grafana
- Increase dashboard refresh interval
- Reduce time range
-
Use time-based retention policies
-
Alert Notifications Not Working
- Verify Alertmanager configuration
- Check SMTP settings
- Review notification policies
Best Practices¶
- Dashboard Design
- Group related metrics
- Use consistent color schemes
- Add descriptive titles and units
-
Set appropriate Y-axis ranges
-
Alerting
- Set meaningful alert thresholds
- Use alert grouping
- Configure proper notification channels
-
Test alerts regularly
-
Performance
- Limit dashboard refresh rate
- Use recording rules for expensive queries
- Monitor Grafana resource usage
Security Considerations¶
- Restrict dashboard access using Grafana roles
- Use read-only users for shared dashboards
- Regularly rotate credentials
- Monitor access logs
Support¶
For assistance with monitoring:
- Email: botshelomokoka+monitoring@gmail.com
- GitHub Issues: https://github.com/your-org/anya-core/issues
- Documentation: Monitoring Guide
AI Labeling¶
- [AIR-3] - Automated monitoring and visualization
- [AIS-3] - Secure dashboard access and configuration
- [BPC-3] - Bitcoin monitoring best practices
- [RES-3] - Comprehensive monitoring coverage