JustAnalytics/Documentation

Service Map

Visualize dependencies and communication between your services.

Overview#

The Service Map provides a real-time topology view of your distributed system. It shows how services communicate with each other, including request rates, error rates, and latency between services.

How It Works#

The service map is built automatically from your trace data. When one service calls another, JustAnalytics records the relationship and aggregates metrics.

Each node in the map represents a service (identified by the serviceName in your SDK configuration). Edges between nodes represent communication paths with:

  • Request rate (requests per minute)
  • Error rate (percentage of failed requests)
  • Average latency (p50, p95, p99)

Reading the Map#

Nodes#

Each node shows:

  • Service name -- as configured in JA.init()
  • Request rate -- total requests per minute
  • Error rate -- color-coded (green/yellow/red)
  • Health status -- derived from error rate and latency

Edges#

Arrows between nodes indicate the direction of calls. Edge labels show:

  • Requests/min between the two services
  • Error % on that specific path
  • Average latency for that call path

Service Dependencies#

The service map reveals:

  • Upstream dependencies -- services that call a given service
  • Downstream dependencies -- services that a given service calls
  • Database connections -- PostgreSQL, Redis, and other data stores
  • External APIs -- third-party services your application calls

Example Architecture#

Browser → API Gateway → User Service → PostgreSQL
                      → Order Service → PostgreSQL
                                      → Payment Service (Stripe)
                      → Notification Service → Redis
                                             → Email Provider

Filtering#

Filter the service map by:

  • Time range -- see how the topology changes over time
  • Environment -- production, staging, development
  • Service -- focus on a specific service and its neighbors

Alerts#

Configure alerts based on service map metrics:

  • Service error rate exceeds threshold
  • Service latency exceeds threshold
  • New service detected (topology change)
  • Service becomes unreachable