proxmox/docs/archive/historical/BLOCKSCOUT_COMPREHENSIVE_ANALYSIS.md

Blockscout Comprehensive Analysis

Date: December 23, 2025
Container: VMID 5000 on pve2 (192.168.11.140)
Domain: explorer.d-bis.org

---

📊 Current Status Overview

✅ Operational Components

• ✅ SSL/HTTPS: Let's Encrypt certificates installed and valid
• ✅ Nginx: Running and proxying correctly
• ✅ Blockscout Container: Running and indexing blocks
• ✅ PostgreSQL: Healthy and operational
• ✅ Database Migrations: Complete (49 tables)
• ✅ Cloudflare Tunnel: Configured and routing correctly
• ✅ Indexer: Enabled and actively importing blocks

📈 Indexing Progress

• Blocks Indexed: 46,090 blocks
• Latest Block Number: 115,655
• Transactions Indexed: 46 transactions
• Addresses Indexed: 32 addresses
• Logs Indexed: Unknown (check needed)

---

🔴 Current Issues

1. RPC Method Warnings (Non-Critical) ⚠️

Status: Expected warnings, not critical failures

Issue: Blockscout is receiving "Method not enabled" errors for:

• Internal transaction tracing (internal_transaction fetcher)
• Block rewards (block_reward fetcher)

Impact:

• ❌ Internal transaction details won't be indexed
• ❌ Block reward information won't be available
• ✅ Basic blocks, transactions, and addresses are still indexed

Root Cause: Besu RPC node may not have trace methods enabled, or some RPC methods are disabled.

Recommendation:

• Low Priority - These are optional features
• To enable: Configure Besu RPC node with trace methods if needed
• Basic explorer functionality works without these features

---

2. Low Transaction Count ⚠️

Status: Potential concern

Issue: Only 46 transactions indexed out of 46,090 blocks (0.1% ratio)

Analysis:

• Possible Causes:
  1. Chain has very few transactions per block (normal for some chains)
  2. Indexing hasn't caught up to latest blocks
  3. Transaction indexing may have issues

Action Needed:

• Monitor if transaction count increases over time
• Check if blocks contain transactions but they're not being indexed
• Verify RPC endpoint can fetch transaction data

---

3. Outdated Docker Image 🔄

Status: Image is 9 months old

Issue: Using blockscout/blockscout:latest but image created 9 months ago

Current: Image ID 07819a947152 - 9 months old
Risk: Missing bug fixes, security patches, and new features

Recommendation: Medium Priority

• Pull latest image: docker pull blockscout/blockscout:latest
• Test upgrade in staging environment first
• Review changelog for breaking changes

---

4. Outdated Nginx Version 🔄

Status: Nginx 1.18.0 (Ubuntu default)

Issue: Nginx 1.18.0 is from 2020, very old

Current: nginx/1.18.0
Latest Stable: nginx/1.26.x (as of 2024)

Risks:

• Security vulnerabilities
• Missing modern features
• Performance improvements not available

Recommendation: Medium Priority

• Upgrade to latest Nginx version
• Test configuration compatibility
• Review new features and improvements

---

🔄 Recommended Upgrades

High Priority

1. Update Blockscout Docker Image 🔴

cd /opt/blockscout
docker-compose pull blockscout
docker-compose up -d blockscout

Benefits:

• Latest bug fixes
• Security patches
• Performance improvements
• New features

Risk: Low (if tested first) Effort: Low (docker pull and restart)

---

2. Upgrade Nginx 🟡

# Add Nginx official repository
# Update to latest stable version
# Test configuration
# Restart service

Benefits:

• Security patches
• Better performance
• Modern HTTP/2 and HTTP/3 support
• Improved SSL/TLS support

Risk: Medium (requires testing) Effort: Medium (requires repository setup)

---

Medium Priority

3. Enable RPC Trace Methods 🟡

If internal transaction details are needed:

• Configure Besu RPC node to enable trace methods
• Enable trace_* and debug_* RPC methods
• Restart RPC node

Benefits:

• Full internal transaction indexing
• Block reward information
• More detailed explorer data

Risk: Low Effort: Low (RPC configuration change)

---

4. Database Optimization 🟡

Monitor and optimize as database grows:

• Regular VACUUM operations
• Index optimization
• Connection pool tuning
• Query performance monitoring

Benefits:

• Better query performance
• Reduced storage usage
• Improved indexing speed

Risk: Low Effort: Low (automated maintenance tasks)

---

Low Priority

5. OpenSSL Update 🟢

Current: OpenSSL 3.0.2 (March 2022) Latest: OpenSSL 3.3.x

Status: Relatively recent, but could be updated Risk: Very Low Effort: Low

---

💡 Recommendations

Immediate Actions

1. Monitor Indexing Progress ⏰

   • Track transaction count over next 24-48 hours
   • Verify transactions are being indexed correctly
   • Check if ratio of transactions to blocks is normal for your chain

2. Document Current State 📝

   • Record current image versions
   • Document configuration
   • Create backup before upgrades

3. Set Up Monitoring 📊

   • Monitor Blockscout logs for errors
   • Track indexing progress
   • Set up alerts for container failures

---

Short-Term (1-2 Weeks)

1. Update Blockscout Image ✅

   • Test in staging first
   • Plan maintenance window
   • Update documentation

2. Upgrade Nginx ✅

   • Research compatibility
   • Test configuration
   • Plan upgrade procedure

3. Review RPC Configuration 🔍

   • Check if trace methods are needed
   • Evaluate if enabling them improves explorer functionality
   • Document decision

---

Long-Term (1-3 Months)

1. Automated Backups 💾

   • Database backups
   • Configuration backups
   • Disaster recovery plan

2. Performance Monitoring 📈

   • Set up metrics collection
   • Monitor indexing speed
   • Track resource usage

3. Security Hardening 🔒

   • Regular security updates
   • SSL certificate auto-renewal verification
   • Firewall rule review

4. Documentation Updates 📚

   • Keep deployment docs current
   • Document upgrade procedures
   • Create troubleshooting guides

---

🎯 Suggestions for Optimization

1. Indexing Performance

Current: Indexing blocks successfully
Suggestions:

• Monitor indexing lag (current block vs. latest indexed)
• If lag is significant, consider:
  • Increasing database connection pool
  • Adjusting indexer concurrency
  • Optimizing RPC endpoint performance

---

2. Resource Monitoring

Suggestions:

• Set up resource monitoring (CPU, RAM, disk)
• Monitor PostgreSQL performance
• Track Docker container resource usage
• Alert on resource exhaustion

---

3. Configuration Improvements

Current Configuration:

• DISABLE_INDEXER=false ✅
• DISABLE_WEBAPP=false ✅
• POOL_SIZE=10 (database connections)

Suggestions:

• Monitor database connection pool usage
• Consider increasing POOL_SIZE if needed
• Review other Blockscout environment variables for optimization

---

4. Web Interface

Current: Web interface enabled but may need data
Suggestions:

• Verify web interface is accessible once more data is indexed
• Test contract verification functionality
• Check API endpoints are working
• Verify search functionality

---

5. Security Enhancements

Suggestions:

• Review Nginx security headers (already configured ✅)
• Consider rate limiting for API endpoints
• Review Cloudflare security settings
• Regular security audits

---

6. Backup Strategy

Suggestions:

• Automated daily database backups
• Retention policy (7 daily, 4 weekly, 12 monthly)
• Test restore procedures
• Off-site backup storage

---

📋 Upgrade Checklist

Pre-Upgrade

• Review current configuration
• Document current versions
• Create database backup
• Test backup restore
• Plan maintenance window

Upgrade Process

• Pull latest Docker images
• Review changelog for breaking changes
• Test in staging environment
• Update configuration if needed
• Apply upgrades during maintenance window
• Verify all services working
• Monitor for 24 hours after upgrade

Post-Upgrade

• Verify all functionality
• Check logs for errors
• Update documentation
• Document any issues encountered
• Plan next upgrade cycle

---

🔍 Monitoring Recommendations

Key Metrics to Track

1. Indexing Metrics:

   • Blocks indexed per hour
   • Transactions indexed per hour
   • Indexing lag (latest block - last indexed block)
   • Error rates

2. Performance Metrics:

   • API response times
   • Database query performance
   • Container resource usage
   • Nginx request rates

3. Health Metrics:

   • Container uptime
   • Database connectivity
   • RPC endpoint availability
   • SSL certificate expiration dates

---

🚨 Priority Summary

Priority	Item	Impact	Effort	Timeline
🔴 High	Update Blockscout image	High	Low	1 week
🟡 Medium	Upgrade Nginx	Medium	Medium	2 weeks
🟡 Medium	Monitor transaction indexing	Medium	Low	Ongoing
🟢 Low	RPC trace methods	Low	Low	1 month
🟢 Low	OpenSSL update	Low	Low	2 months
🟢 Low	Database optimization	Low	Low	Ongoing

---

✅ What's Working Well

1. ✅ SSL/HTTPS: Properly configured and working
2. ✅ Nginx Proxy: Correctly routing requests
3. ✅ Cloudflare Tunnel: Working and secure
4. ✅ Database: Healthy and operational
5. ✅ Indexing: Actively importing blocks
6. ✅ Container Stability: Running without crashes
7. ✅ Configuration: All critical settings correct

---

📝 Conclusion

Overall Status: ✅ OPERATIONAL

The Blockscout explorer is working correctly with some non-critical warnings and recommended upgrades for better performance and security.

Immediate Concerns: None - system is stable and functional

Recommended Next Steps:

1. Monitor transaction indexing (verify it's working correctly)
2. Plan Blockscout Docker image update
3. Schedule Nginx upgrade
4. Set up monitoring and alerting

Risk Level: 🟢 Low - No critical issues, only optimizations and upgrades recommended