working-with-intervals

Analyze interval datasets to compute durations and statistics in OPAL.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rustomax/observe-community-mcp --skill working-with-intervals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: working-with-intervals
Source: https://github.com/rustomax/observe-community-mcp/tree/main/skills/working-with-intervals
Command: npx skills add https://github.com/rustomax/observe-community-mcp --skill working-with-intervals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users analyze interval datasets (with start_time and end_time) to compute durations, filter by time ranges, and compare across grouping fields in OPAL. It clarifies the difference between Intervals, Events, and Resources, enabling accurate time-based analysis.

Core Features & Use Cases

  • Two-timestamp interval handling: operate on start_time and end_time to measure durations.
  • Duration-focused analytics: compute statistics (mean, percentiles) and distribution.
  • Grouping & filtering: aggregate by fields like service, host, or dataset; filter by duration windows or time ranges.
  • Real-world scenarios: analyze distributed traces, batch jobs, and CI/CD runs to identify slow intervals and throughput patterns.

Quick Start

Discover an interval dataset and compute a basic duration distribution in OPAL:

  • Discover: discover_context('pipeline runs')
  • Basic duration: make_col dur:duration / 1s
  • Stats: | statsby count:count(), avg:avg(dur), p95:percentile(dur, 0.95)
  • Long intervals: | filter dur > 5m

Frequently Asked Questions about working-with-intervals

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

FAQPage Schema
How do I calculate durations for time-bounded processes in OPAL?

You can filter time-bounded data by duration windows or time ranges using the filter command in OPAL. After computing a duration column, apply a filter like "dur > 5m" to isolate long intervals, enabling you to identify slow CI/CD runs or throughput bottlenecks.

What is the difference between intervals, events, and resources for time-series analysis?

Intervals represent time-bounded processes with both start_time and end_time, whereas events are point-in-time occurrences and resources are static entities. Analyzing interval datasets focuses on measuring durations and distributions, which is essential for evaluating time-bounded activity like batch jobs and distributed traces.

Can I group duration statistics by service or host in OPAL?

Yes, you can group duration statistics by fields like service, host, or dataset using the statsby command in OPAL. This allows you to aggregate interval data and compare percentile-based statistics, such as p95 duration, across different grouping fields within your time-bounded datasets.

What's the best way to analyze distributed traces for slow intervals?

The best way to analyze distributed traces for slow intervals is to treat them as two-timestamp interval datasets and compute duration distributions. By applying percentile-based statistics and duration filters in OPAL, you can accurately surface and identify slow time-bounded activity patterns.

Do I need specific dependencies to compute percentile statistics for batch jobs?

No specific dependencies are required to compute percentile statistics for batch jobs. You can directly analyze interval datasets in OPAL using built-in commands like make_col for durations and statsby with percentile functions to evaluate time-bounded processes without external components.