# CCIP Observability Dashboard Specification

## Overview

This document specifies the observability dashboards and analytics for CCIP message lifecycle visualization and monitoring.

## Dashboard Components

### Message Lifecycle Visualization

**Components**:
- Timeline view showing source → CCIP → destination flow
- Status indicators at each stage
- Time metrics (send time, delivery time, execution time)
- Transaction links (click to view source/destination transactions)

**Visualization**:
```
[Source Chain] → [CCIP DON] → [Destination Chain]
     ✓              ✓                ✓
  Sent         Delivered         Executed
  00:00         00:02            00:05
```

### Status Aggregation

**Metrics**:
- Total messages by status
- Success rate (% executed successfully)
- Average execution time
- Failed message count
- Expired message count

**Time Series**:
- Messages per hour/day
- Success rate over time
- Average execution time over time

### Failure Analysis

**Failure Categories**:
- Execution failures (revert on destination)
- Timeouts (expired messages)
- Delivery failures (CCIP DON issues)
- Invalid messages

**Analysis**:
- Failure rate by category
- Common failure reasons
- Failure patterns (time, chain pairs, etc.)

### Performance Metrics

**Metrics**:
- Average delivery time (source → CCIP)
- Average execution time (CCIP → destination)
- Total end-to-end time
- P50, P95, P99 latencies

**Charts**:
- Latency distribution
- Latency trends over time
- Latency by chain pair

## Cross-Chain Analytics

### Chain Pair Analysis

**Metrics per Chain Pair**:
- Message volume
- Success rate
- Average latency
- Popular routes

**Visualization**:
- Network graph showing chain connections
- Edge weights showing message volume
- Color coding for success rates

### Token Flow Analysis

**Tracking**:
- Token transfers via CCIP
- Volume by token
- Volume by chain pair
- Cumulative volume over time

## Real-Time Monitoring

### Live Message Stream

**Features**:
- Real-time updates of new messages
- Status change notifications
- Alert on failures
- Filter by chain, status, etc.

### Alerts

**Alert Conditions**:
- High failure rate (> 5%)
- Message timeout (> 30 minutes)
- Unusual message volume spike
- Chain connectivity issues

## References

- CCIP Tracking: See `ccip-tracking.md`
- Observability: See `../observability/`

