Skip to main content

Subgraph Monitor

Monitor The Graph subgraph health, indexing status, and query performance. Get alerts when subgraphs fall behind or fail to sync.

Configuration

{
  "type": "subgraph",
  "name": "Uniswap V3 Subgraph",
  "subgraphName": "uniswap/uniswap-v3",
  "network": "mainnet",
  "maxBlockLag": 50,
  "checkSyncStatus": true,
  "interval": 60000
}

Metrics Monitored

  • Sync Status: Is subgraph fully synced?
  • Block Lag: Blocks behind chain head
  • Query Performance: Response time
  • Error Rate: Failed queries

Alert Example

⚠️ Subgraph Sync Lag

Subgraph: uniswap/uniswap-v3
Network: Ethereum Mainnet

Current Block: 18,234,500
Chain Head: 18,234,567
Lag: 67 blocks (threshold: 50)

Status: Behind

Action: Data may be stale

[View Subgraph]

Use Cases

  • Data Availability: Ensure subgraph is up-to-date
  • dApp Health: Frontend depends on subgraph data
  • Analytics: Track protocol metrics in real-time

Best Practices

  • Set Block Lag Threshold: 20-50 blocks is reasonable
  • Check Every 1-5 Minutes: Subgraphs sync continuously
  • Monitor Multiple Subgraphs: Have backup data sources

Next Steps