Rays

Your workspace at a glance

Deploy with the CLI, monitor from your workspace. Real-time resource summaries, deployment tracking, query playgrounds, observability, and logs. All in one place.
Try for free

Overview

Resource summaries, connection details, and usage metrics. All from a single, centralized dashboard.
Play

Resources at a glance

See counts for datasources, endpoints, connections, pipes, and more. Plus a 7-day error tracking chart with recent errors and timestamps.

Usage metrics dashboard

Sparkline charts for vCPU time, requests, and ingested rows over a 7-day window. Spot trends and anomalies without writing a single query.

Workspace status

Last deployment summary, editable markdown workspace description, and quick access to API hosts, MCP server URLs, and BI tool connection parameters.

Resources

All your workspace resources in one place. Filter, inspect, and navigate datasources, pipes, endpoints, connections, and service datasources with inline metrics and split-screen views.
Play
Filter your datasources, pipes, and connections instantly using composable filters and natural language.
Play
Open a resource view to see its details, metrics, and usage. Tweak parameters and test your queries on the fly.
Play
Explore service datasources like pipe_stats_rt and endpoint_errors, or ClickHouse system.* tables. Queries are free.

Composable filters

Filter by type, deployment ID, connection, errors, or usage metrics. Use natural language to find resources instantly across your entire workspace.

Split-screen inspection

Click any resource to open a detail panel. See API URLs, schema, metrics, and diffs. Toggle between list and lineage views without losing your position.

Service datasources

Browse pipe_stats_rt, endpoint_errors, kafka_ops_log, and more. Access ClickHouse system.* tables directly. Queries against service datasources are free.

Deployments

Review your release history. Click into any deployment to see exactly what changed down to the specific SQL lines.
Play

Deployments history

Chronological view of all deployments with changes and logs. See who deployed, when, and what changed across your workspace.

SQL diff viewer

See exact changes between deployments down to specific SQL lines. Compare resource definitions side by side to understand what changed.

Live deployment inspection

Click into any deployment to see what changed. View contextual resource details, API URLs for endpoints, schema for datasources, and full diffs.

Observability

Real-time charts for CPU time, QPS, memory, ingestion, copies, sinks, and errors. Filter by job status and time range to understand what's happening across your workspace.
Play

Workspace metrics

CPU time, QPS, average memory, ingested rows, and ingest errors. All in real-time charts with adjustable time ranges.

Operations tracking

Monitor copy executions, sink executions, rows in quarantine, and their error rates. See what's running and what's failing.

Job status

Filter jobs by status: error, working, waiting, or done. Quickly identify failed operations and drill into the details.

Logs

Browse every request, ingestion, and job log in your workspace. Filter by type, source, or resource. Click any entry to inspect the underlying resource in a split view.
Play
View platform activity, filter errors, and inspect events across queries, datasources, Kafka, sinks, and jobs.
Play
Run tb logs, inspect your resources or service datasources directly from the CLI.

Filter and browse

Filter by log type, source, resource name, and time range. Toggle errors only to focus on what matters. Update in real-time or refresh on demand.

Split-view inspection

Click any log entry to open a split view of the underlying resource. Browse its data, columns, settings, lineage, and resource-level logs without leaving the page.

CLI integration

Run tb logs to inspect your logs directly from the CLI. Get real-time visibility into your data operations without leaving your terminal.

Playgrounds

Prototype queries, debug pipelines, and explore data interactively. Write SQL, visualize results, and export data in JSON or CSV.
Play

Interactive query prototyping

Build and iterate on queries in a multi-node editor. Chain SQL nodes together to prototype complex pipelines before deploying.

AI-assisted SQL

Generate and refine queries with CMD+K. AI understands your schema and suggests fixes, helping you debug pipelines faster.

Visualize and export

See query results as tables. Export data in JSON or CSV to use in external tools or share with your team.

Time Series

Monitor endpoint performance and track trends over time. Visualize any time-based data source, including service data sources, without writing SQL.
Play

Visual monitoring

Track endpoint latency, error rates, and request volumes over time. Visualize any data source, including service data sources like pipe_stats_rt, without writing SQL.

Granularity & zoom

Granularity auto-adjusts to your time range. Drag-to-zoom into any period for a closer look, syncing automatically with the time selector.

Track trends over time

Compare metrics side by side with table and chart views. Monitor storage consumption, request patterns, and resource usage across your workspace.

Explorations

An AI agent with full context of your data. Reference sources with @syntax, customize behavior with workspace rules, and export reasoning nodes to Playgrounds.
Play

AI agent with full context

Use @syntax to reference specific data sources and add workspace rules to fine-tune how the agent responds. The more context it has, the more accurate its answers.

Insights and diagnostics

Get improvement suggestions, identify performance bottlenecks, and surface data quality issues. Focus on intelligent analysis, not visualization.

Export to Playgrounds

Reasoning nodes created during analysis can be exported to Playgrounds. Continue refining queries in a full SQL environment.

Built-in

Full control over your workspace

Every tool you need to understand and manage your data infrastructure. Built into every workspace.

AI-powered

  • CMD+K query generation in Playgrounds
  • Context-aware AI agent in Explorations
  • Schema-aware suggestions across tools

Private or shared

  • Keep Playgrounds, Time Series, and Explorations private or visible to your team
  • Share datasources across workspaces
  • Workspace-level access control with tokens and roles

Developer-first

  • Parameterized queries
  • ClickHouse SQL dialect
  • SQL autocomplete

Full observability

  • Real-time charts for CPU time, QPS, memory, ingestion, and errors
  • Filter and inspect logs across queries, Kafka, sinks, and jobs
  • Monitor copy and sink executions with job status filtering

Query and visualize

  • Write SQL and see results instantly in Playgrounds
  • Visualize any datasource as a time series chart
  • Drag-to-zoom and adaptive granularity across time ranges

Export and iterate

  • Export query results as JSON or CSV
  • Turn AI reasoning nodes into SQL queries
  • Auto-save across all tools

FAQs

What is a Workspace?

A workspace is where all your Tinybird resources live: datasources, pipes, endpoints, connections, explorations, playgrounds, and more. You can access and manage your workspace from the UI or the CLI. The UI gives you visual tools to monitor performance, explore data, inspect logs, and debug issues. The CLI lets you deploy, iterate, and automate.

What is the Overview page?

The Overview page is your workspace dashboard. It shows resource summaries with counts for datasources, endpoints, materializations, connections, pipes, copies, and sinks. It also includes sparkline charts for vCPU time, requests, and ingested rows over a 7-day window, the last deployment status, and quick access to API hosts, MCP server URLs, and BI tool connection parameters.

What is the Resources page?

The Resources page is a unified table view of all your workspace resources with inline metrics like status, request count, error count, and average latency. It features composable filters to narrow down by type, deployment ID, connection, errors, or usage metrics. You can also use natural language to find resources, toggle between list and lineage views, and open a split-screen detail panel to inspect any resource without losing your place. The Resources page also gives you access to service datasources (pipe_stats_rt, endpoint_errors, datasources_storage, kafka_ops_log, and more) and ClickHouse system.* tables. Queries against service datasources are free.

What is the Deployments page?

The Deployments page shows a chronological view of all your releases. Click into any deployment to see exactly what changed, including a SQL diff viewer that highlights changes down to specific lines. You can compare resource definitions side by side and see contextual details like API URLs and schema changes.

What is the Observability page?

The Observability page gives you real-time metrics for your workspace health. Track CPU time, QPS, average memory, ingested rows, rows in quarantine, ingest errors, copy and sink executions, and their error rates. Filter by job status and time range to spot issues across your data infrastructure.

What is the Logs page?

The Logs page lets you browse every append, import, materialization, copy, replace, and GET request in your workspace. Filter by log type, source, resource name, time range, or errors only. Click any log entry to open a split view where you can inspect the underlying resource's data, columns, settings, lineage, and resource-level logs. You can also stream logs from the CLI using tb logs.

What is Playgrounds used for?

Playgrounds is for prototyping and debugging queries. Write SQL in a multi-node editor, chain nodes together to build complex pipelines, and use AI (CMD+K) to generate or refine SQL. You can inspect results as tables and export data in JSON or CSV.

What is Time Series used for?

Time Series is for monitoring endpoint performance and tracking trends over time. Visualize data sources — including service data sources like pipe_stats_rt, endpoint_errors, and datasources_storage — without writing SQL. Granularity adjusts automatically to your selected time range, and you can drag to zoom into specific periods to investigate incidents or observe patterns.

What is Explorations used for?

Explorations is an AI agent with full context of your data. Use @syntax to reference specific data sources and add workspace rules to customize how the agent responds. It identifies performance bottlenecks, surfaces data quality issues, and provides actionable insights. Reasoning nodes from the analysis can be exported to Playgrounds for further refinement.

How do all the Workspace tools work together?

Each tool serves a different part of the workflow. Overview gives you a snapshot of your workspace health. Resources lets you inspect and filter everything you've deployed. Deployments tracks what changed and when. Observability and Logs help you monitor performance and debug issues in real time. When you need to dig deeper, Playgrounds lets you write and test SQL, Time Series visualizes trends over time, and Explorations uses AI to analyze your data. They all share the same workspace context, so you can move between them naturally.

How do the UI and CLI work together?

The CLI handles the development workflow: initialize projects, build resources, deploy to production, and manage tokens. The UI gives you visibility into what's running: monitor metrics, browse logs, inspect resources, and explore data. You develop and deploy with the CLI, then use the UI to understand what's happening. Some features like Playgrounds, Time Series, and Explorations are UI-only tools. Others like logs are available from both: browse them in the UI or stream them with tb logs.

What are service datasources?

Service datasources are built-in datasources that track everything happening in your workspace: API requests (pipe_stats_rt, pipe_stats), BI queries (bi_stats_rt, bi_stats), data operations (datasources_ops_log, block_log), storage usage (datasources_storage), Kafka operations (kafka_ops_log), sink operations (sinks_ops_log), endpoint errors, background jobs (jobs_log), AI usage (llm_usage), and more. Queries against service datasources are free and don't count toward your usage limits. You can query them from Playgrounds, visualize them in Time Series, or reference them in Explorations.

Can I share my work with teammates?

Yes. You can keep your Playgrounds, Time Series or Explorations private, or share them with anyone in your workspace. Playgrounds and Time Series configurations persist in your workspace so team members can access and build on each other's work.

What data sources can I explore?

All tools work with any data source in your Tinybird workspace, including data sources, pipes, and materialized views. You can also explore service data sources like pipe_stats_rt, pipe_stats, endpoint_errors, datasources_storage, datasources_ops_log, and llm_usage — queries against service data sources are free. In Explorations, use @syntax to reference specific data sources to focus the AI on the right context.

Do I need to know SQL?

Not necessarily. Explorations lets you query data using natural language. Time Series generates SQL from your configuration choices. However, Playgrounds is designed for SQL users who want full control. Knowing SQL helps you get the most out of each tool.

How does AI assistance work in Playgrounds vs Explorations?

In Playgrounds, press CMD+K to invoke AI for SQL generation. It understands your schema and suggests fixes, helping you debug pipelines faster. In Explorations, an AI agent with full context of your data analyzes questions, identifies issues, and provides insights. You can export reasoning nodes from Explorations to Playgrounds to continue refining queries in a full SQL environment.

Start observing and exploring your data

Data exploration and observability features
Tinybird wordmark