clay-observability

name	clay-observability
description	Monitor Clay enrichment pipeline health, credit consumption, and data quality metrics. Use when setting up dashboards for Clay operations, configuring alerts for credit burn, or tracking enrichment success rates. Trigger with phrases like "clay monitoring", "clay metrics", "clay observability", "monitor clay", "clay alerts", "clay dashboard", "clay credit tracking".
allowed-tools	Read, Write, Edit, Bash(curl:*)
version	1.14.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","clay","monitoring","observability","dashboard"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Clay Observability

Overview

Monitor Clay data enrichment pipeline health across four dimensions: credit consumption velocity, enrichment success rates (hit rates), data quality scores, and CRM sync reliability. Clay's credit-based pricing model makes observability essential for cost control.

Prerequisites

• Clay account with table access
• Metrics infrastructure (Prometheus/Grafana, Datadog, or custom)
• Webhook receiver that logs enrichment results
• Understanding of your enrichment column configuration

Instructions

Step 1: Instrument Your Clay Webhook Handler

// src/clay/metrics.ts — collect metrics from enriched data flowing back from Clay
interface ClayMetrics {
  enrichmentsReceived: number;
  enrichmentsWithEmail: number;
  enrichmentsWithCompany: number;
  enrichmentsWithPhone: number;
  estimatedCreditsUsed: number;
  averageICPScore: number;
  leadsTier: { A: number; B: number; C: number; D: number };
}

class ClayMetricsCollector {
  private metrics: ClayMetrics = {
    enrichmentsReceived: 0,
    enrichmentsWithEmail: 0,
    enrichmentsWithCompany: 0,
    enrichmentsWithPhone: 0,
    estimatedCreditsUsed: ,
    : ,
    : { : , : , : , :  },
  };
   scoreSum = ;

  () {
    ..++;
     (lead.) ..++;
     (lead.) ..++;
     (lead.) ..++;
    .. += creditsPerRow;

     score = lead. || ;
    . += score;
    .. = . / ..;

     (score >= ) ...++;
      (score >= ) ...++;
      (score >= ) ...++;
     ...++;
  }

  ():  {
     m = .;
     emailRate = m. > 
      ? ((m. / m.) * ).()
      : ;
     companyRate = m. > 
      ? ((m. / m.) * ).()
      : ;

     [
      ,
      ,
      ,
      ,
      ,
      ,
      ,
      ,
    ].();
  }
}