eventbus

Search, inspect, and publish EventBus messages across regions and partitions.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill eventbus-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eventbus
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/eventbus
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill eventbus-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging event-driven services requires visibility into message flow, but manually locating messages across partitions, regions, and storage types is slow and error-prone. This Skill lets you search EventBus messages, inspect partition layouts, and send test messages to PPE environments through a single CLI interface. ## Core Features & Use Cases - Flexible Message Search: Query event messages by preview, time range, partition offset, message key, message ID, or search key across Singapore, US-East, and US-BOE regions. - Partition Inspection: Retrieve sorted partition info including oldest/newest offsets for any event. - Safe Test Message Publishing: Send messages to PPE environments with a mandatory two-step preview-and-confirm workflow that prevents accidental sends. - Use Case: While debugging why a consumer service missed an event, search messages by message key within a time window, verify the message body and headers, then publish a corrected test message to the PPE environment to validate the fix. ## Quick Start Ask the agent to search the latest EventBus messages for a specific event name, optionally specifying the region or a time range.

Frequently Asked Questions about eventbus

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

FAQPage Schema
How do I search EventBus messages by message key?

Use the search_msgs action with search_type 2 and provide the msg_key, event_name, and a time range. The command runs through gdpa-cli and returns matching messages with body, headers, partition, and offset details.

How to send a test message to an EventBus event?

Use the bind_msg action, which only supports PPE environments and requires the ppe, key, and message parameters. First call it without confirm to preview the message, then call again with confirm set to true after user approval to actually send.

What search types does EventBus message search support?

Six search types are supported: preview of latest messages (type 5, default), time range (0), partition offset (1), message key (2), message ID (3), and search key (4). Time-based searches default to the last hour if no range is given.

Can I send EventBus messages to production environments?

No, the bind_msg action only supports PPE environments and the ppe parameter is required. Attempting to send without a PPE target returns an error, protecting production event streams from test traffic.

Why does EventBus search return no partitions found?

This error means the event does not exist or has no partitions in the selected region. Verify the event_name spelling and try a different vregion such as Singapore-Central, US-East, or US-BOE.

Which regions does EventBus querying support?

Three regions are supported: Singapore-Central (default, alias sg), US-East (aliases us, i18n), and US-BOE (aliases boei18n, boe-i18n). Each maps to a specific API region and gateway endpoint.