v0.2.0

🚀 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.