> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base Analytics

> View article-level analytics for the IT knowledge base — view counts, linked ticket counts, and last-updated dates with sortable columns.

The Knowledge Base Analytics page (`/it/knowledge-base/analytics`) shows usage metrics for IT knowledge base articles, including view counts, linked ticket counts, and last-updated dates. It is gated by the `it.knowledge_base.manage` permission.

## Overview

The page loads all articles (up to 500) via `useKnowledgeBaseArticles`. A category filter dropdown narrows the table. All columns — title, category, view count, linked ticket count, and last updated — are sortable. Default sort is `view_count` descending. Article titles link to `/it/knowledge-base/:id`.

## Who it's for

Users with permission `it.knowledge_base.manage` (enforced via `RequirePermission` inside the component, within the outer `ITViewGuard`).

## Before you start

* Hold the `it.knowledge_base.manage` permission.

## Steps

<Steps>
  <Step title="Open Knowledge Base Analytics">
    Navigate to `/it/knowledge-base/analytics`.
  </Step>

  <Step title="Filter by category">
    Use the category dropdown in the top-right corner to narrow results to a specific article category.
  </Step>

  <Step title="Sort the table">
    Click any column header (Title, Category, Views, Linked Tickets, Last Updated) to sort. Click again to reverse sort direction.
  </Step>

  <Step title="Open an article">
    Click an article title link to navigate to the article detail page.
  </Step>
</Steps>

## Key concepts

| Concept               | Description                                                            |
| --------------------- | ---------------------------------------------------------------------- |
| `view_count`          | Number of times the article has been viewed                            |
| `linked_ticket_count` | Number of IT tickets associated with this article                      |
| Sort fields           | `title`, `category`, `view_count`, `linked_ticket_count`, `updated_at` |

## Related

<Columns cols={2}>
  <Card title="IT Service Management" icon="headset" href="/it/overview">
    IT Service Management overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/it.tsx
  * src/cores/it/pages/knowledge-base/KnowledgeBaseAnalyticsPage.tsx
  * src/cores/it/hooks/useKnowledgeBaseArticles.ts
</Accordion>