omni-analytics

Analyze Omni v2 events and trace message journeys via the omni CLI.

34|14|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/automagik-dev/omni --skill omni-analytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omni-analytics
Source: https://github.com/automagik-dev/omni/tree/main/.agents/skills/omni-analytics
Command: npx skills add https://github.com/automagik-dev/omni --skill omni-analytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users understand message flow, debug issues, and analyze performance within the Omni messaging platform by providing tools for event querying, replay, and journey tracing.

Core Features & Use Cases

  • Event Analytics: Get aggregated statistics on message volume, success rates, and processing times.
  • Event Replay: Re-process past events for testing or recovery.
  • Message Journey Tracing: Visualize the path of a specific message through the system.
  • Use Case: Debug a sudden spike in message delivery failures by analyzing error events and tracing the journey of failed messages to identify the root cause.

Quick Start

Use the omni-analytics skill to investigate errors that occurred in the last hour.

Frequently Asked Questions about omni-analytics

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

FAQPage Schema
How do I trace a message journey in Omni v2 to debug a delivery failure?

You can trace a message journey in Omni v2 by using event analytics tools to visualize the specific path of a message through the system, helping you pinpoint the root cause of delivery failures.

Can I replay historical Omni events to re-process past messages?

Yes, you can replay historical Omni events to re-process past messages. This event replay capability is useful for testing system behavior or recovering from processing errors.

Do I need jq and the omni CLI to analyze Omni event statistics?

Yes, you need both the omni CLI and jq installed to analyze Omni event statistics. jq is required for processing the JSON data returned by the omni CLI during event queries.

What is the best way to investigate a sudden spike in Omni message errors?

The best way to investigate a spike in Omni message errors is to query aggregated event statistics for the affected timeframe and trace the journey of failed messages to identify bottlenecks.

Does omni-analytics provide aggregated statistics on message volume and processing times?

Yes, omni-analytics provides aggregated event statistics on message volume, success rates, and processing times, allowing you to monitor performance and understand overall event analytics.