Data Dictionary
Overview
Overview
Glean’s usage analytics log provides a structured, easy-to-analyze record of key user actions such as searches, clicks, chats, and feedback. These logs enable clients to measure engagement, improve adoption, and build custom dashboards for internal analysis. Please reach out to your Glean point-of-contact to understand the options to consume these logs.Glean Customer Event Types
The table below summarizes the key event types captured in the Glean customer event log, along with a brief description and examples to help you understand what each event represents and how it can be used in your analytics.| Event Type | Description | Example Action Logged |
|---|---|---|
| SEARCH | Metadata about user search actions, including queries, filters, and surfaces. | A user types a search query in the Glean New Tab Page. |
| SEARCH_CLICK | Captures clicks on search results. | A user clicks the second result on the full-page web app. |
| SEARCH_FEEDBACK | User-submitted feedback on the quality or helpfulness of search results. | A user rates search results as 3/5 and leaves a comment. |
| AUTOCOMPLETE | Logs interactions with autocomplete suggestions while typing. | Autocomplete suggestions appear as a user types “onboard…”. |
| CHAT | Represents a message sent to the Glean Assistant. | A user sends a question on New Tab Page. |
| CHAT_CITATIONS | Lists source documents referenced in the AI response to a chat. | AI cites a Google Doc and a Confluence page in response. |
| CHAT_CITATION_CLICK | Logs when a user clicks on a cited source in a chat response. | A user clicks on the linked Google Doc cited by the AI. |
| CHAT_FEEDBACK | Captures feedback left by users on a chat message or assistant response. | A user downvotes an Assistant reply and adds a comment. |
| AI_ANSWER | Logs the AI-generated response returned for a search query. Note: Starting July 2025, AI Answers are now available in Workflow runs instead. See the AI Answer Analysis query for how to query both event types. | The AI generates a short answer summarizing multiple docs. |
| AI_ANSWER_VOTE | Tracks upvotes/downvotes on AI-generated answers. | A user upvotes an AI answer in a search result panel. |
| AI_SUMMARY | Records when an AI summary is generated. | A user requests a summary of a long Slack thread. |
| AI_SUMMARY_VOTE | Captures user votes on AI-generated summaries. | A user clicks thumbs-down on a doc summary. |
| SHORTCUT | Logs use of Glean shortcuts (e.g., go/alias). | A user visits go/standups which redirects to a calendar. |
| CLIENT_EVENT | Frontend interactions like button clicks, page loads, and other UI activity. | A user clicks “See more” on a suggested docs carousel. |
| WORKFLOW_RUN | A single invocation of a Workflow, the underlying execution unit for Agent and Assistant requests. | A user runs an Agent. |
| WORKFLOW | Detailed logs providing execution details for a Workflow. DEPRECATED as of 2025-06-13: use WORKFLOW_RUN events instead. | A user initiates a content review workflow. |
| GLEAN_BOT_ACTIVITY | Background actions or proactive behaviors by the Glean bot, such as reminders or nudges. | The Gleanbot nudges a user to follow up on an unread file. |
| PRODUCT_SNAPSHOT | This event type contains once-daily snapshots (not event logs) of entities in Glean, across three types: USER, WORKFLOW, and WORKFLOW_STEP. Each snapshot captures the state of the object at a point in time and is useful for understanding historical configuration and metadata for users and workflows. | Captures the attributes of users, eg: departmentID, startdate, etc. |