# firetiger-query

> Claude/Codex skill by [@firetiger-oss](https://omgskills.com/library/firetiger-oss/index.md) · 0 stars · Updated 2026-07-08

Use when querying Firetiger telemetry with SQL — finding traces, searching logs, inspecting metrics, locating errors or slow requests, computing latency percentiles, aggregating observability data, or querying a connected source (Postgres, MySQL, ClickHouse, Datadog, Prometheus, GCP Monitoring) through the Firetiger MCP \`query\` tool. Always use this skill before writing a Firetiger query — it carries the critical gotchas (slashed table names must be quoted, duration is computed not stored, status codes are integers, attributes are structs not maps, fully-qualify "connections/{name}".table to reach a connected source) that make queries succeed.

## Install

```sh
git clone https://github.com/firetiger-oss/claude-plugin /tmp/claude-plugin && ln -s /tmp/claude-plugin/skills/firetiger-query ~/.claude/skills/firetiger-query
```

## From README

Firetiger Query Firetiger stores telemetry in Apache Iceberg tables with dynamic schema inference. Run DuckDB SQL against it with the Firetiger MCP server's query tool (parameter: sql). Key gotcha: the query tool auto-injects USE "connections/iceberg-gateway", so you reference tables by their quoted name ("opentelemetry/traces/checkout-service") — you don't prefix a catalog path. There is no enforced row cap, but the tool returns every row as JSON, so always add a LIMIT (and explicit columns, not SELECT ) to avoid dumping huge nested rows. Table naming Tables are namespaced by signal type and service name. Names with slashes must be double-quoted. The {servicename} layout is the default shard key; a deployment can configure a different one, so always SHOW TABLES; to see the real names.

## Links

- HTML page: https://omgskills.com/library/firetiger-oss/claude-plugin/skills/firetiger-query/
- GitHub: https://github.com/firetiger-oss/claude-plugin
- Author: [@firetiger-oss](https://omgskills.com/library/firetiger-oss/index.md)

## More from this repo

- [firetiger](https://omgskills.com/library/firetiger-oss/claude-plugin/skills/firetiger/index.md) — Used when the user mentions Firetiger or wants to work with their observability data — setting up Firetiger,...
   - [@firetiger-oss](https://omgskills.com/library/firetiger-oss/index.md) · 0 stars
- [firetiger-create-agent](https://omgskills.com/library/firetiger-oss/claude-plugin/skills/firetiger-create-agent/index.md) — Used when creating a Firetiger monitoring agent, installing a prebuilt catalog agent, or configuring an agent's...
   - [@firetiger-oss](https://omgskills.com/library/firetiger-oss/index.md) · 0 stars
- [firetiger-instrument](https://omgskills.com/library/firetiger-oss/claude-plugin/skills/firetiger-instrument/index.md) — Used when adding OpenTelemetry instrumentation to an application so it sends telemetry to Firetiger — setting up...
   - [@firetiger-oss](https://omgskills.com/library/firetiger-oss/index.md) · 0 stars