firetiger-query

Execute DuckDB SQL queries against Firetiger observability data.

1|2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/firetiger-oss/cursor-plugin --skill firetiger-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firetiger-query
Source: https://github.com/firetiger-oss/cursor-plugin/tree/main/skills/query
Command: npx skills add https://github.com/firetiger-oss/cursor-plugin --skill firetiger-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows users to query vast amounts of telemetry data stored in Firetiger using familiar SQL syntax, making it easier to diagnose issues and understand system behavior.

Core Features & Use Cases

  • SQL Querying: Execute SQL queries against traces, logs, and metrics data.
  • Schema Discovery: Easily find available tables and columns to understand your data.
  • Attribute Access: Query nested attributes within telemetry data.
  • Use Case: Quickly find all error spans from the last hour for the payment-service to diagnose a recent outage.

Quick Start

Query the last 100 spans from the checkout-service table.

Frequently Asked Questions about firetiger-query

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

FAQPage Schema
How do I query telemetry data like traces, logs, and metrics using SQL?

You can query telemetry data by executing DuckDB SQL queries against Apache Iceberg tables for traces, logs, and metrics. This allows you to use familiar SQL syntax to diagnose issues and understand system behavior across your observability data.

How do I discover available tables and columns before querying observability data?

You can discover available tables and columns using the schema discovery features provided by the MCP server. This supports dynamic schema inference, allowing you to easily find the structure of your telemetry data and access nested attributes before executing queries.

Can I use DuckDB SQL to query Apache Iceberg tables for observability data?

Yes, you can use DuckDB SQL execution to query Apache Iceberg tables storing your observability data. This integration enables you to run standard SQL queries directly against your traces, logs, and metrics data for effective data retrieval.

Does querying telemetry data with SQL require specific table naming conventions?

Yes, effective data retrieval requires adherence to specific query structure and table naming conventions. Following these conventions ensures your SQL queries correctly target the telemetry data stored in the underlying Apache Iceberg tables.

What is the best way to find error spans for a specific service during an outage?

The best way to find error spans is to execute SQL queries against your traces data to filter by service name, time range, and error status. For example, you can query the last hour of telemetry data for the payment-service to diagnose outages.