investigate-stuck-messages
OfficialDiagnose relayer queue issues and extract IDs.
Authorhyperlane-xyz
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Investigate stuck messages in the relayer queue by querying the relayer API, correlating retry data, and surfacing message IDs for denylisting when alerts indicate queue length or stuck prepare messages.
Core Features & Use Cases
- Grafana alert URL workflow: automatically extract app_context and remote labels and drive the full investigation.
- Manual workflow: provide app_context and remote to run targeted investigations.
- End-to-end data correlation: fetch domain IDs, query the relayer API, filter messages by recipient, and fetch actual errors from GCP logs.
Quick Start
Use this skill with a Grafana alert URL to auto-detect app_context and remote, or provide app_context and remote directly to start an investigation. Review the results to identify full message IDs for potential denylisting and root causes.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: investigate-stuck-messages Download link: https://github.com/hyperlane-xyz/hyperlane-monorepo/archive/main.zip#investigate-stuck-messages Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.