firecrawl-observability

name	firecrawl-observability
description	Monitor Firecrawl scraping pipelines with metrics, credit tracking, and quality alerts. Use when implementing monitoring for Firecrawl operations, setting up dashboards, or configuring alerting for scrape failures and credit consumption. Trigger with phrases like "firecrawl monitoring", "firecrawl metrics", "firecrawl observability", "monitor firecrawl", "firecrawl alerts".
allowed-tools	Read, Write, Edit
version	1.11.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","firecrawl","monitoring","observability","dashboard"]
compatibility	Designed for Claude Code

Firecrawl Observability

Overview

Monitor Firecrawl web scraping pipelines for success rates, credit consumption, content quality, and latency. Key signals: scrape success rate, crawl job completion, credit burn velocity, extraction quality (did markdown actually contain useful content vs error pages), and webhook delivery health.

Key Metrics

Metric	Type	Why It Matters
firecrawl_scrapes_total	Counter	Track scrape volume and success rate
firecrawl_credits_used	Counter	Monitor credit consumption
firecrawl_scrape_duration_ms	Histogram	Detect latency issues
firecrawl_content_quality	Counter	Catch empty/error pages
firecrawl_crawl_jobs_total	Counter	Track crawl job outcomes

Instructions

Step 1: Instrumented Firecrawl Wrapper

import FirecrawlApp from "@mendable/firecrawl-js";

const firecrawl = new FirecrawlApp({
  apiKey: process.env.FIRECRAWL_API_KEY!,
});

// Counters (use your metrics library: prom-client, statsd, datadog, etc.)
function emit(metric: string, value: number, tags?: Record<string, string>) {
  console.log(JSON.stringify({ metric, value, tags, : .() }));
}

   () {
   start = .();
   {
     result =  firecrawl.(url, {
      : [],
      : ,
    });

     duration = .() - start;
     quality = (result);

    (, , { :  });
    (, duration);
    (, );
    (, , { quality });

     result;
  }  (: ) {
    (, , {
      : ,
      : (error. || ),
    });
    (, .() - start);
     error;
  }
}

 ():  {
   md = result. || ;
   (md. < )  ;
   (.(md))  ;
   (!.(md))  ;
   ;
}