ops-telemetry-query

Query Boundless broker telemetry tables on Amazon Redshift for operational data.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Current-cmd/TrustMeBRO --skill ops-telemetry-query-current-cmd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ops-telemetry-query
Source: https://github.com/Current-cmd/TrustMeBRO/tree/main/.claude/skills/ops-telemetry-query
Command: npx skills add https://github.com/Current-cmd/TrustMeBRO --skill ops-telemetry-query-current-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Boundless team members need to inspect broker health, request evaluations, and proving outcomes on live networks, but writing correct SQL against the Redshift telemetry schema requires knowing exact column names, enum values, and Redshift-specific quirks. ## Core Features & Use Cases - Telemetry Querying: Run SQL against the telemetry.broker_heartbeats, telemetry.request_evaluations, and telemetry.request_completions views on Redshift Serverless. - Credential Setup: Load connection details from network_secrets.toml or environment variables and normalize them into a valid REDSHIFT_URL connection string. - Ready-Made Analytics: Use example queries for skip-rate analysis, proving-time breakdowns, success/failure rates, and per-broker health snapshots. - Use Case: Ask why brokers are skipping orders in the last 24 hours and get a breakdown of skip codes with percentages, with broker addresses labeled using the known-address mapping. ## Quick Start Ask the assistant to show the most recent heartbeat for each broker on the production network.

Frequently Asked Questions about ops-telemetry-query

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

FAQPage Schema
How do I query Boundless broker telemetry data?▼

Connect to the Redshift Serverless telemetry database with psql using a REDSHIFT_URL connection string, then query the telemetry.broker_heartbeats, telemetry.request_evaluations, and telemetry.request_completions views. Always prefix tables with the telemetry schema and use LIMIT on exploratory queries.

How do I analyze broker skip rates in Redshift?▼

Filter telemetry.request_evaluations on outcome = 'Skipped' and group by skip_code to get counts and percentages over a time window. The example queries file includes a ready-made top-skip-reasons query for the last 24 hours.

What credentials are needed to connect to the telemetry database?▼

You need the Redshift endpoint and the readonly user password, either from network_secrets.toml under [environments.<env>.telemetry] or provided directly as REDSHIFT_ENDPOINT and REDSHIFT_PASSWORD environment variables. These are combined into a postgres://readonly connection string.

Why does my Redshift SQL query fail with a syntax error in zsh?▼

zsh treats ! as history expansion inside double quotes, so != in psql -c strings gets mangled. Use <> instead of != in SQL, or run queries through a heredoc which is immune to shell expansion.

Does Redshift support all Postgres SQL features?▼

No. Redshift lacks LATERAL joins and DISTINCT ON, requires UNION ALL with ORDER BY to be wrapped in a subquery, and allows only one MEDIAN per SELECT. Use GETDATE() instead of NOW() and JSON_PARSE for SUPER columns.

Does telemetry data cover all brokers on the network?▼

No. Telemetry is opt-in, so the data only represents brokers that have enabled reporting. Do not assume the brokers visible in telemetry are the only ones active on the network.