Skip to content

ServiceHop

ServiceHop is an Operational Intelligence platform designed for distributed service architectures. It functions simultaneously as an operational observability layer, an analytical reasoning engine, and an investigation workspace. ServiceHop captures API call records, aggregates runtime telemetry, analyzes request and response structures, and continuously evaluates service behavior from multiple perspectives.

Beyond traditional monitoring, ServiceHop transforms raw call data into structured knowledge. It identifies performance characteristics, reliability patterns, payload semantics, schema evolution, and cacheability opportunities. By correlating metrics, metadata, and sampled payloads, the system provides actionable insights rather than isolated measurements.

ServiceHop is built to answer three fundamental questions that arise in modern service ecosystems: - What is happening? → Operational Health & Metrics - Why is it happening? → Insight Snapshots & Reports - How can it be improved? → Recommendations & Optimization Guidance

The platform bridges the gap between low-level telemetry and high-level architectural decision-making. It enables engineers, architects, and operations teams to understand not only service performance, but also service design quality, behavioral stability, integration patterns, and optimization potential.

Through snapshots, reports, and interactive exploration views, ServiceHop provides a coherent model for analyzing service ecosystems over time. The result is a system that supports operational stability, performance tuning, cost optimization, and architectural governance without requiring invasive instrumentation or manual analysis.

Key Concepts

Services are logical groupings of related API calls. Services are created automatically when calls are ingested.

Calls are individual API request-response interactions. Each call includes timestamp, duration, result code, and request/response payloads.

Insights are automated analyses generated from call data:

  • Profile - Request/response field metadata and semantic classification
  • Overview - Traffic patterns and service-level statistics
  • Cacheability - Cache key recommendations with hit rate simulation

Usage Pattern

ServiceHop follows a CLI-first approach for data operations and web for visualization:

Task Tool
Ingest call data CLI
View insights Web UI or CLI
Manage tokens Web UI
Run orchestration CLI

Quick Start

1. Get the CLI

Download the CLI for your platform. See Download & Installation.

2. Configure Authentication

Set your API token:

export SERVICEHOP_API_URL="https://servicehop.example.com"
export SERVICEHOP_API_TOKEN="shp_your_token_here"

3. Ingest Call Data

servicehop-cli ingest --input calls.json

4. View Insights

Once data is ingested, the orchestrator generates insights automatically. View them via CLI:

servicehop-cli insight --list
servicehop-cli insight --latest --service user-service --type CACHEABILITY

Or access the web UI for a visual interface.