skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mulesoft/mulesoft-dx69 installs

omni-gateway-diagnose

Diagnose Omni Gateway errors and failures given any combination of log output, dump files, or symptom descriptions. Use when the user reports a gateway error (5xx, 4xx, gateway unreachable, policy not applying), has log output to analyze, needs to decide whether to request debug logs from a customer, or needs to determine whether an issue requires escalation to the gateway team.

How do I install this agent skill?

npx skills add https://github.com/mulesoft/mulesoft-dx --skill omni-gateway-diagnose
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides diagnostic guidance for troubleshooting the Omni Gateway. It contains triage logic and checklists but no executable code, network connections, or sensitive data access. No security issues were detected.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Diagnose Gateway Error

Triage by Symptom

SymptomFirst CheckInvoke Skill
5xx errors on all requestsUpstream connectivity, spec.address bindingomni-gateway-config
4xx errors (auth/policy)PolicyBinding targeting, policy configomni-gateway-config
Gateway unreachable / port not respondingListen address (0.0.0.0 vs localhost), port conflictsomni-gateway-config
Policy not applyingPolicyBinding → ApiInstance cross-referenceomni-gateway-config
upstream connect error / connection refusedUpstream service health, routes configomni-gateway-logs
TLS handshake failuresCertificate validity, TLS config in conf.domni-gateway-logs
xDS disconnected / control plane errorsAnypoint connectivity, registration token validityomni-gateway-logs
STARTED state never reachedRegistration artifact, conf.d correctnessomni-gateway-install (re-register), then omni-gateway-config
Known-good config still failingLive deployed state may differ from conf.domni-gateway-dump

By Available Artifact

  • Logs provided → invoke omni-gateway-logs
  • conf.d directory available → invoke omni-gateway-config
  • Dump file provided → invoke omni-gateway-dump
  • Symptom description only → ask the user which artifacts are available before proceeding

Escalation Decision

Self-serviceable

These issues can be resolved without escalating to the gateway team:

  • Misconfigured PolicyBinding (wrong targetRef, missing ApiInstance)
  • Wrong spec.address (using localhost instead of 0.0.0.0)
  • Upstream service unreachable (network/firewall issue outside the gateway)
  • Expired or revoked Anypoint registration token

Escalate to Gateway Team

These issues require gateway team involvement:

  • Repeated xDS sync failure after verifying a valid configuration
  • Envoy process crash (crash loop, OOMKill)
  • STARTED state never reached after valid registration and correct conf.d
  • Issue is reproducible after configuration is confirmed valid by omni-gateway-config

Escalation Package Checklist

Collect all of the following before opening a support ticket:

  • Full gateway logs at debug level (see omni-gateway-logs for how to enable)
  • Diagnostic dump file (see omni-gateway-dump for analysis before escalating)
  • conf.d/ listing with secrets omitted (file names + kind/name inventory only)
  • flexctl version output
  • Platform: Linux / Docker / Kubernetes / CloudHub
  • Reproducible steps or a timeline of when the failure started

Related Jobs

  • omni-gateway-logs — parse log output to surface errors and anomalies
  • omni-gateway-config — structural and cross-reference validation of conf.d files
  • omni-gateway-dump — interpret a diagnostic dump ZIP for live gateway state

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/mulesoft/mulesoft-dx/omni-gateway-diagnose">View omni-gateway-diagnose on skillZs</a>