Summary

Starting June 16, Glean is launching a new event type called WorkflowRun across all customer-facing event logs. With this launch, you now have the ability to comprehensively track and analyze usage across all Glean AI products. These include Agents, which are the most frequently requested feature for these logs, AI Answers, Summarization, Deep Research, Daily Digests, and more. This article explains what’s being introduced, what new metrics will be supported as part of this launch, and best practices for incorporating the new metrics in your analytics.

What’s New

Background: Assistant and Agent interactions in Glean are executed as workflows. To provide deeper visibility into these executions, and enable rich metrics around assistant usage, agent activity, and AI-driven features, we’ve introduced a new log type in Glean Customer Event Logs: WorkflowRun. This log captures each top-level workflow invocation as a single, well-structured entry. It consolidates all relevant execution data in one place, enabling simpler, more reliable, and more performant analysis.

Who Should Read This

Admins

Managing analytics pipelines, log integrations, and product dashboards

Data/Business Analysts

Building queries or KPI dashboards from Glean event logs

Developers/IT

Who join Glean logs with other systems or manage feature adoption

End Users

Who rely on metrics or dashboards powered by workflow data

Key Fields in WorkflowRun

Each WorkflowRun event includes:
For a detailed description of these fields, please refer to the Glean Data Dictionary.

Building Metrics Across Chat, Workflow, and WorkflowRun Logs

Migration Period: For April-June 2025 data, you’ll need to join across Chat, Workflow, and WorkflowRun logs to get complete metrics. After June 16, use WorkflowRun exclusively.
The transition involves three event types:
  • CHAT: Base chat interactions (continues to exist)
  • WORKFLOW: Deprecated June 16, 2025 (April-June data only)
  • WORKFLOW_RUN: New comprehensive workflow tracking (June 16+ data)

Sample Queries and Use Cases

Check out the Sample Queries section in the Data Dictionary for detailed examples of how to work with WorkflowRun data.
Common use cases include:
  • Agent Usage Analysis: Track user engagement with custom agents
  • AI Feature Adoption: Monitor usage of AI Answers, Summarization, etc.
  • Performance Monitoring: Analyze workflow execution times and success rates
  • User Behavior Insights: Understand how users interact with AI features

Further Resources

Data Dictionary and Sample Queries

As part of this rollout, we have published an updated Data Dictionary, which includes detailed schema definitions and sample queries for the new WorkflowRun log type. This resource is designed to help you:
  • Understand the structure and purpose of each field
  • Identify the differences between Chat, Workflow, and WorkflowRun logs
  • Find stitching queries for the April-June transition period
If you’re building or updating dashboards or pipelines, we recommend starting with the Data Dictionary.

Change History

DateChange
June 2025WorkflowRun logs deployed; Workflow logs replaced

Frequently Asked Questions (FAQ)

Need Help?

Still have questions or want implementation advice? Reach out to your Glean admin.