Operations - WunderGraph

Why Use the Operations Page

Track All Operations: Monitor every operation executed against your federated graph
Analyze Deprecated Fields: Identify which operations use deprecated fields and which clients are affected
Make Safe Schema Changes: Use usage data to safely remove deprecated fields
Monitor Client Usage: Track how different clients interact with your operations and identify usage patterns
Debug Performance Issues: Sort operations by latency or error rate to quickly identify problematic operations
Plan Schema Evolution: Use data-driven insights for migration planning and client communication

The Operations page features a responsive two-panel layout designed for efficient operation analysis:

The left panel displays a searchable, filterable list of all operations executed against your federated graph. Search and Filtering Options:

Text Search: Search by operation name or hash
Sort by Metrics: Choose from Request Count (default), Latency, or Error Rate
Sort Direction: Toggle between ascending and descending order
Deprecated Fields Filter: Show only operations with deprecated fields to focus on operations that need attention during schema evolution
Client Name Filter: Filter operations by specific clients to analyze client-specific usage patterns and behavior
Flexible Date Ranges: Choose from predefined ranges or set custom dates, respecting your plan’s retention limits

Each operation displays:

Operation Name: The name of the GraphQL operation (or “Unnamed Operation” for operations without names)
Operation Type: Query, Mutation, or Subscription
Performance Metrics: Based on your selected sorting criteria (latency, request count, or error rate)
Deprecated Fields Indicator: Visual indicator if the operation uses deprecated schema fields

The operation details and analytics panel dynamically displays either:

Overview Analytics: Aggregate metrics for all operations when no specific operation is selected
Operation-Specific Analytics: Detailed metrics and insights for a selected operation

Click on any operation in the left panel to view detailed details and analytics:

Client Usage: View the clients that have used the operation and the number of requests made by them
Deprecated Fields: List of deprecated fields used by the operation
Performance Metrics: Visual charts displaying request rate, P95 latency, and error percentage trends for the selected operation

When working with operations, you can also:

Navigate to Traces: Jump directly to the Analytics Traces page with pre-applied filters for the selected operation
Inspect Operation Content: View the complete GraphQL operation with syntax highlighting in a modal