← Integrations
Tinybird logo

Tinybird

Endpoint health, workspace traffic, and custom SQL metrics from your Tinybird workspace, live on your iPhone home screen.

Per-endpoint health, at a glance

The Endpoint Health module tracks a single published Tinybird endpoint. Connect your workspace, pick a pipe, and eight metrics appear on your widget: request count over the last 24 hours, request count over the last 5 minutes, mean latency, p95 latency, p99 latency, error rate, error count, and rows read. The 5-minute window gives you a live signal during endpoint launches and deploys. The 24-hour window grounds your daily baseline. When error rate ticks up or p99 latency climbs, the widget catches it before your users feel it.

Workspace traffic and inventory

Workspace Pulse aggregates across every endpoint in your workspace without requiring you to select a specific pipe. Eight metrics cover the full picture: total requests, workspace-wide error rate, total error count, active pipe count, data source count, published endpoint count, total storage in GB, and total row count. These numbers answer whether your analytics layer is healthy and growing, directly from your home screen. Storage and row counts also serve as a cost proxy when you are scaling ingestion.

Custom SQL metrics

The SQL Query module accepts any read-only SQL you would run in the Tinybird query editor. Write a SELECT or WITH query, give it a name, and paste it in. The first row's columns become widget metrics, up to ten per query. You can compute any aggregate your ClickHouse workspace supports: a conversion rate, a daily active user count, a revenue figure filtered by event type. PulseKit enforces single-statement read-only SQL at the app layer, and the WORKSPACE:READ_ALL token scope enforces read access at the API layer.

How to get your Tinybird API key

Open your Tinybird workspace at app.tinybird.co. In the sidebar, choose Tokens, then create a new token (or use an existing one) with the WORKSPACE:READ_ALL scope. Workspace admin tokens already include it. Tokens start with 'p.'. Paste the token here and PulseKit will auto-detect your workspace region across GCP and AWS.

Security

How we protect your credentials

Your Tinybird API key is sealed on this device with AES-256-GCM before it ever leaves your iPhone. Only your device holds the unwrap secret, stored in the iOS Keychain. The PulseKit backend wraps that already-encrypted payload again with its STORAGE_SECRET and writes the double-envelope blob to Postgres, so the server never sees your plaintext key at rest. Each fetch request includes a one-time unwrap secret that decrypts the inner envelope only long enough to call Tinybird. The key is scoped to this device, can be revoked from PulseKit at any time, and is never written to logs.

What you can track

Pick the metrics you care about and pin them as widgets.

Endpoint Health

Requests, latency (avg/p95/p99), and error rate for a published Tinybird endpoint over the last 24 hours

  • 81
    Requests (24h)
  • 13
    Requests (5m)
  • 81
    Avg Latency (24h)
  • 17
    p95 Latency (24h)
  • 87
    p99 Latency (24h)
  • 89
    Error Rate (24h)
  • 18
    Error Count (24h)
  • 46
    Read Rows (24h)

Workspace Pulse

Workspace-wide request volume, error rate, inventory counts, and storage usage

  • 65
    Total Requests (24h)
  • 88
    Workspace Error Rate (24h)
  • 40
    Total Errors (24h)
  • 52
    Active Pipes (24h)
  • 72
    Data Sources
  • 30
    Endpoints
  • 39
    Total Storage (GB)
  • 24
    Total Rows Stored

SQL Query

Run a custom read-only SQL query against your Tinybird workspace

    Numbers shown are illustrative — your widgets show your live data.

    Who uses this

    • Data engineers

      When you own a published Tinybird endpoint, you need to know if it is healthy without opening the console every hour. Endpoint Health puts p95 latency, error rate, and 24-hour request volume on your home screen. A spike in p99 or a climb in error count is visible the moment you unlock your phone, not after a user complaint.

    • Indie founders

      Your product's analytics run on Tinybird and you want to know whether the layer is seeing traffic and whether anything is broken. Workspace Pulse shows total requests, workspace-wide error rate, and active pipe count for your entire workspace. Storage and row counts tell you whether your data footprint is growing as expected without logging in.

    • Analytics engineers

      You already have business KPIs computed as SQL in your Tinybird workspace: a conversion rate, a revenue aggregate, a daily active user count. The SQL Query module lets you name a query, paste it in, and surface the result as a home screen metric. Any numeric column in the first row becomes a glanceable number on your widget.

    FAQs

    Which Tinybird token scope does PulseKit need?

    PulseKit requires a token with the WORKSPACE:READ_ALL scope. This scope grants read access to Tinybird's internal service data sources used for latency and request metrics, plus your workspace's datasources and pipes. Workspace admin tokens already include it. You can also create a dedicated token scoped to WORKSPACE:READ_ALL only, which limits the credential to read operations.

    How does PulseKit find my Tinybird workspace region?

    When you paste your token, PulseKit simultaneously probes all ten Tinybird cloud regions across GCP and AWS. The first region that responds successfully is cached on your device for seven days. You do not need to know or enter your region manually. If the cache expires, PulseKit re-probes automatically on the next fetch.

    Can I monitor multiple Tinybird endpoints at once?

    Yes. Each Endpoint Health widget tracks one published endpoint. You can add multiple widgets to your home screen or Lock Screen, each pointing to a different pipe in the same workspace. All widgets share the same workspace token, so you only connect once.

    What SQL can I use in the SQL Query module?

    The SQL Query module accepts read-only statements: SELECT, WITH, SHOW, DESCRIBE, and EXPLAIN. PulseKit validates that your input is a single read-only statement before sending it to Tinybird. The first row returned becomes your widget metrics, with each column name used as the metric label, up to ten columns per query.

    How fresh is the Tinybird data shown in PulseKit?

    PulseKit fetches on demand each time your widget refreshes. Tinybird's pipe_stats_rt service data source provides real-time request data, so 24-hour and 5-minute metric windows reflect current traffic. iOS controls the widget refresh schedule; widgets typically update every few minutes when your device is active.

    Does PulseKit support self-hosted Tinybird Local?

    Not in the current version. PulseKit auto-detects your workspace across Tinybird's ten managed cloud regions on GCP and AWS. Self-hosted Tinybird Local deployments use a custom host URL that is not yet supported. Support for custom hosts is planned for a future release.

    Is my Tinybird API key stored securely in PulseKit?

    Your token is encrypted with AES-256-GCM on your device before it is transmitted. Only your device holds the decryption secret, stored in the iOS Keychain. PulseKit's backend stores a double-encrypted version and never sees your plaintext token at rest. You can revoke access from PulseKit at any time without rotating your Tinybird token.

    Tinybird logo

    Add Tinybird widgets to your iPhone

    Install PulseKit, paste your credentials, pick a widget.

    Download