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

# Tracking

> The tracking type stores aggregated usage statistics for platform operations such as agent runs, tool calls, and knowledge retrievals.

export const EditionBadge = ({edition}) => <Tooltip tip={edition === "ee" ? "Requires an Enterprise Edition license." : "Available in the Community Edition."}>
    <span style={{
  fontFamily: "RobotoMono, monospace",
  fontSize: "12px",
  textTransform: "uppercase",
  letterSpacing: "0.04em",
  border: "1px solid var(--imp-hair-light)",
  padding: "2px 8px"
}}>
      {edition === "ee" ? "Enterprise" : "Community"}
    </span>
  </Tooltip>;

`tracking` records are the raw statistics events written by the platform during normal operation. Each record captures a named operation type, its total cost or count, and the user, role, and project that generated it. The administration analytics view is built on top of this type. See [Administration](/administration/analytics).

```graphql theme={null}
type tracking {
  name: String
  label: String
  type: typeEnum
  total: Float
  user: Float
  role: String
  project: String
  last_processed_at: Date
  embeddings_updated_at: Date
  createdAt: Date
  updatedAt: Date
  id: ID!
}
```

## Field notes

| Field                   | Notes                                                                                                                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`                  | Operation type enum. Values: `CONTEXT_RETRIEVE`, `SOURCE_UPDATE`, `EMBEDDER_UPSERT`, `EMBEDDER_GENERATE`, `EMBEDDER_DELETE`, `WORKFLOW_RUN`, `CONTEXT_UPSERT`, `TOOL_CALL`, `AGENT_RUN`. |
| `name`                  | Human-readable operation name (e.g. the agent name for `AGENT_RUN` events).                                                                                                              |
| `label`                 | Secondary label (e.g. model name for `AGENT_RUN`, tool ID for `TOOL_CALL`).                                                                                                              |
| `total`                 | Numeric measure of the operation: token count for `AGENT_RUN`, item count for `SOURCE_UPDATE`, etc.                                                                                      |
| `user`                  | Numeric ID of the user who triggered this operation; `null` for system-initiated operations.                                                                                             |
| `role`                  | Role ID string of the user at the time of the operation.                                                                                                                                 |
| `project`               | Project ID string the operation was scoped to, if any.                                                                                                                                   |
| `last_processed_at`     | Timestamp of the last knowledge-embedding pass over this record.                                                                                                                         |
| `embeddings_updated_at` | Timestamp when vector embeddings were last regenerated.                                                                                                                                  |

## Example query

```graphql theme={null}
query {
  trackingPagination(
    limit: 100
    filters: [{ type: { eq: AGENT_RUN } }]
    sort: { field: "createdAt", direction: DESC }
  ) {
    items {
      id
      type
      name
      label
      total
      user
      project
      createdAt
    }
    pageInfo {
      currentPage
      hasNextPage
    }
  }
}
```