supabase-logs

Fetches and analyzes Supabase Edge Function logs to diagnose runtime and HTTP issues.

8|1|Updated Jul 7, 2025
One-click install
npx skills add https://github.com/dasheck0/qraft-templates --skill supabase-logs
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: supabase-logs
Source: https://github.com/dasheck0/qraft-templates/tree/main/opencode/skills/supabase-logs
Command: npx skills add https://github.com/dasheck0/qraft-templates --skill supabase-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve?

Fetches and analyzes Supabase Edge Function logs to diagnose runtime and HTTP issues.

Core Features & Use Cases

  • Proactively fetches both runtime logs (in-function console output) and edge logs (HTTP request/response metadata) for a targeted function or all functions.
  • Supports filtering by time window and function name, enabling quick root-cause analysis for errors, latency, or unexpected behavior.
  • Returns structured results suitable for AI analysis, dashboards, or incident reports.

Quick Start

Use the fetch-logs.js script to pull latest logs for a specific function or all functions.

Frequently Asked Questions about supabase-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch and analyze Supabase Edge Function logs for runtime errors?โ–ผ

To fetch and analyze Supabase Edge Function logs for runtime errors, use a bundled Node.js script that retrieves both runtime and edge logs. It filters by function name and time window, returning structured results suitable for root-cause analysis of errors and latency.

What is the difference between runtime logs and edge logs in Supabase?โ–ผ

Runtime logs in Supabase capture in-function console output, while edge logs record HTTP request and response metadata. Fetching both types simultaneously allows you to diagnose unexpected behavior by correlating application-level errors with HTTP latency issues.

How do I filter Supabase logs by a specific function or time window?โ–ผ

You filter Supabase logs by a specific function or time window using command-line arguments. The script supports the --function flag to target a specific function and the --last flag to define a configurable time window for retrieving relevant edge and runtime logs.

Do I need a Supabase access token to retrieve Edge Function logs?โ–ผ

Yes, you need a Supabase access token to retrieve Edge Function logs. The script reads the SUPABASE_ACCESS_TOKEN directly from a local .env file to authenticate API requests and securely fetch your project's runtime and HTTP metadata.

Can I pull all Supabase Edge Function logs at once for incident analysis?โ–ผ

Yes, you can pull logs for all Supabase Edge Functions at once by omitting the function filter. This retrieves both runtime and edge logs across your entire project over a configurable time window, returning structured results ideal for incident reports.