A day in the life of an Optimizely OMVP: Introducing Query Library and Request Logs: Two Powerful New Features for OptiGraphExtensions v5

I am excited to announce two new features for OptiGraphExtensions v5 that give Optimizely CMS administrators greater visibility and control over their Optimizely Graph integration: Query Library and Request Logs.

  These additions complement our existing suite of tools for managing synonyms, pinned results, and webhooks, making OptiGraphExtensions an even more comprehensive solution for Optimizely Graph management.

  Query Library: Build, Save, and Execute GraphQL Queries

  The Query Library provides a powerful interface for creating, saving, and executing GraphQL queries directly against your Optimizely Graph instance—all from within the CMS admin interface.

  Visual Query Builder

  Not everyone is comfortable writing raw GraphQL. That's why we've included an intuitive visual query builder that lets you:

  - Select content types from a dropdown populated directly from your Graph schema
  - Pick fields using a checkbox interface that displays all available properties
  - Add filters with support for operators like equals, contains, starts with, greater than, and more
  - Configure sorting by any available field in ascending or descending order
  - Filter by language for multilingual content

  The visual builder automatically generates the corresponding GraphQL query, so you can learn GraphQL syntax while you work.

  Raw GraphQL Mode

  For advanced users who prefer writing queries directly, the raw query mode provides:

  - A full-featured text editor for GraphQL queries
  - Support for query variables in JSON format
  - Syntax validation before execution
  - The ability to switch between visual and raw modes, with automatic query conversion

  Save and Reuse Queries

  Build a library of frequently-used queries that your team can access anytime:

  - Save queries with descriptive names and descriptions
  - Mark queries as active or inactive
  - Edit and refine queries over time
  - Run saved queries with a single click

  Export Results to CSV

  Once you've executed a query, export the results to CSV format for further analysis:

  - Export current preview results instantly
  - Full pagination support for large datasets (automatically fetches all pages)
  - Progress indicator for long-running exports
  - Automatically generated filenames with timestamps

 Request Logs: Monitor Your Graph API Interactions

  Understanding what's happening between your CMS and Optimizely Graph is crucial for debugging and performance optimization. The new Request Logs feature provides complete visibility into API communications.

  Comprehensive Log Viewing

  View detailed information about every request made to Optimizely Graph:

  - Request details: HTTP method, path, host, and timestamps
  - Response data: Status codes, success/failure indicators, and duration
  - Operation context: GraphQL operation names and user information
  - Full payloads: View complete request and response bodies for debugging

  Powerful Filtering Options

  Quickly find the logs you need with multiple filtering options:

  Server-side (API) filters:
  - Filter by request ID for tracing specific operations
  - Filter by host or path
  - Filter by success/failure status

  Client-side filters:
  - Date range selection
  - HTTP method filter (GET, POST, PUT, DELETE, etc.)
  - Status filter (success/failed)
  - Free-text search across paths, operations, messages, and users

  Export Capabilities

  Need to share logs with your team or analyze them offline?

  - CSV export: Tabular format ideal for spreadsheet analysis
  - JSON export: Full structured data for programmatic processing
  - Exports respect your current filter selections

  Detail View

  Click on any log entry to see the complete picture:

  - Full request headers and body
  - Complete response data
  - Timing information
  - Error messages and stack traces (when applicable)

  Getting Started

  Both features are available immediately in the OptiGraphExtensions admin interface. Navigate to:

  - Query Library: `/optimizely-graphextensions/administration/query-library`
  - Request Logs: `/optimizely-graphextensions/administration/request-logs`

  Or use the Quick Navigation links on the About page to jump directly to either feature.

  What's Next?

  These features represent our commitment to making Optimizely Graph management as seamless as possible within the CMS environment. We're continuing to improve OptiGraphExtensions based on community feedback.

  Have suggestions or found an issue? We'd love to hear from you!

  ---

  OptiGraphExtensions is an open-source add-on for Optimizely CMS 12 that provides management of synonyms, pinned results, webhooks, queries, and request logs within Optimizely Graph.