🚀 Telescope v0.2.0 - Native Ethereum Metrics Integration

✨ Major Features

🔧 Native Ethereum Blockchain Monitoring

Telescope now includes built-in Ethereum blockchain metrics collection, eliminating the need to run separate ethereum-metrics-exporter instances. This integration provides comprehensive monitoring for both execution and consensus layers.

Key Capabilities:

✅ Execution Layer Monitoring - Block metrics, sync status, transaction pools, peer counts
✅ Consensus Layer Monitoring - Validator performance, attestations, fork tracking
✅ Module-Based Configuration - Enable only the metrics modules you need
✅ Dual Configuration - Support for both YAML config files and command-line flags

📊 Metric Compatibility

100% Compatible - All metrics maintain the same names and labels as the original ethereum-metrics-exporter
Existing Dashboards - No modifications required for existing Grafana dashboards
Standard Prefixes - eth_exe_* for execution layer, eth_con_* for consensus layer

🔧 Configuration Options

Command-Line Flags

telescope --enable-features integrations-next \
  --network=ethereum \
  --project-id=my-project \
  --project-name=my-project \
  --telescope-username=user \
  --telescope-password=pass \
  --remote-write-url=https://prometheus.example.com/api/v1/write \
  --ethereum-execution-url=http://localhost:8545 \
  --ethereum-consensus-url=http://localhost:5052 \
  --ethereum-execution-modules=sync,eth,net,web3,txpool \

YAML Configuration

integrations:
  ethereum_configs:
    - instance: "ethereum_node_1"
      enabled: true
      autoscrape:
        enable: true
        metrics_instance: "ethereum_monitoring"
      execution:
        enabled: true
        url: "http://localhost:8545"
        modules: ["sync", "eth", "net", "web3", "txpool"]
      consensus:
        enabled: true
        url: "http://localhost:5052"
        event_stream:
          enabled: true
          topics: ["head", "finalized_checkpoint"]

📊 Available Metrics

Execution Layer (`eth_exe_*` prefix)

Block height and sync status
Gas usage and transaction counts
Peer connection information
Transaction pool metrics
Network and client version data

Consensus Layer (`eth_con_*` prefix)

Validator performance metrics
Attestation success rates
Sync committee participation
Fork tracking and finalization status
Node version and network information

Disk Usage (`eth_disk_*` prefix)

Directory size monitoring
Configurable collection intervals
Multiple directory support

🔧 Enhanced CLI Experience

Improved Help System

Comprehensive flag documentation with examples
Clear usage patterns for different deployment scenarios
Proper Cobra CLI help formatting

Flexible Configuration

No longer requires all flags when using config files
Support for environment variable binding
Validation for Ethereum integration requirements

🐳 Docker Support

The integration is fully compatible with Docker deployments:

docker run -v $(pwd)/config.yaml:/etc/telescope/telescope.yaml \
  blockopsnetwork/telescope:latest \
  --config-file=/etc/telescope/telescope.yaml \
  --enable-features integrations-next

📋 Requirements

Important: Ethereum integration requires --enable-features integrations-next flag
At least one of execution URL or consensus URL, must be configured
Docker images include all necessary dependencies

🛠️ Breaking Changes

Ethereum integration is opt-in and requires the integrations-next feature flag
New configuration structure for v2 integrations
Flag validation changes for config file vs CLI usage

📚 Documentation

Updated README with comprehensive Ethereum integration guide
Complete flag reference with examples
Configuration file templates
Troubleshooting guide for common setup scenarios

🐛 Bug Fixes

Fixed flag validation when using configuration files
Resolved logging errors with configuration objects
Improved error handling for invalid Ethereum client URLs
Fixed Docker container compatibility with feature flags

What's Changed

feat: integrate eth metrics exporter into telescope by @segunjkf in #32
feat: add dependabot yaml by @segunjkf in #33
allow external prs by @segunjkf in #36
build(deps): bump go.opentelemetry.io/collector/pdata from 1.3.0 to 1.34.0 by @dependabot in #35
build(deps): bump github.com/aws/aws-sdk-go-v2/feature/ec2/imds from 1.15.2 to 1.16.32 by @dependabot in #34
build(deps): bump github.com/hashicorp/vault/api/auth/ldap from 0.2.0 to 0.10.0 by @dependabot in #38
build(deps): bump github.com/IBM/sarama from 1.43.0 to 1.45.2 by @dependabot in #37

New Contributors

@dependabot made their first contribution in #35

Full Changelog: v0.1.9...v0.2.0

🐳 Docker Pull Image

docker pull blockopsnetwork/telescope:v0.2.0

⚠️ Migration Note: This release maintains backward compatibility. Existing configurations will continue to work unchanged. The Ethereum integration is completely optional and requires explicit enablement.

blockopsnetwork/telescope v0.2.0 on GitHub