> For the complete documentation index, see [llms.txt](https://docs.yansalabs.com/onesearch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yansalabs.com/onesearch/technical-docs/analytics.md).

# Analytics

OneSearch contains the most granular search session analytics available for any search option within ServiceNow - invaluable to continual improvement of your Knowledge strategy and user experience.

### Analytics Dashboard

That analytics dashboard (**YDS OneSearch -> Analytics**) is a great spot to see an overall view of search behavior, action usage, KB feedback, and result gaps.

<figure><img src="/files/eCVcQLtVlxeSR4fYeZ1d" alt=""><figcaption><p>Analytics Dashboard</p></figcaption></figure>

### Search Sessions

Search Sessions (**YDS OneSearch -> Search Sessions**) provide roll-ups of each individual user search experience. These include:

1. Duration of search session
2. Number of results viewed
3. Number of results used
4. Whether filters were used
5. Whether a manual search was initiated (including all searched terms)
6. Each individual action initiated
7. Page/Record where search was initiated

<figure><img src="/files/Z4fzKENcGmPWu8TzjrRS" alt=""><figcaption><p>Search Session</p></figcaption></figure>

### Search Logs

Search logs are the detailed search actions that comprise a Search Session. Each log includes details such as:

1. User name
2. What type of action was initiated
3. Where the action was initiated
4. Which Searcher Section was being viewed
5. Any results clicked, and where that result ranked
6. Whether the result was viewed or used
7. Which session the action was a part of
8. Whether the action was part of a manual search activity
9. What filter/order terms were in place and how they were ordered
10. The entire payload of search log detail

<figure><img src="/files/V4V15kW9mILudcoCN8Yo" alt=""><figcaption><p>Search Log</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yansalabs.com/onesearch/technical-docs/analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.