---
title: "AI Usage & Logs"
manual: "AI Foundation"
version: "1.2"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-usage-and-logs@1.2"
source: "Configuration/AIUsageAndLogs/Index.rst"
modified: "2026-09-15T06:30:06+00:00"
---

# AI Usage & Logs

## Purpose

**Transparency** for every AI request on your TYPO3 instance. Use these screens for budget control, debugging, and compliance.

## AI Usage

**Path:** **AI Foundation > AI Usage**

[AI Foundation AI Usage Demo](https://app.supademo.com/embed/cmrbpqbgz0fn3qmo5oaq6j1t9?utm_source=link)

Shows:

-   **Request count** — Total AI calls in the selected period
-   **Tokens** — Input and output volume
-   **By extension** — Which extension called AI (AI Assistant, AI Chatbot, and others)
-   **By feature** — For example `seo.meta_description`
-   **Time range** — Day, week, or month

**Use for:** budget control, team planning, anomaly detection.

Compare usage trends on the [Dashboard](https://docs.typo3.org/permalink/nitsan/ns-t3af:dashboard@1.2).

## AI Logs

**Path:** **AI Foundation > AI Logs**

[AI Foundation AI Logs Demo](https://app.supademo.com/embed/cmrbpsdl20frlqmo521y5if8m?utm_source=link)

Per-request detail includes:

-   Timestamp, user, extension, feature
-   Provider, model, tokens
-   Success or failure

**Use for:** debugging failed requests and compliance audits.

## Scheduler & CLI

**Path:** **AI Foundation > Scheduler & CLI**

[AI Foundation Scheduler and CLI Demo](https://app.supademo.com/embed/cmrbpsi9d0frwqmo59f50ny8s?utm_source=link)

![AI Foundation Scheduler and CLI with scheduled tasks and command list](../../Images/scheduler.png)

Background jobs and CLI commands. Example:

**Flush AI Foundation caches**

```bash
vendor/bin/typo3 ns_t3af:cache:flush
```

Ensure **scheduler cron** runs every minute on production.

## OpenAI org statistics (optional)

Set `openai_admin_api_key` in Extension Configuration for organization-level usage charts. This is **not** the chat API key. See [Configuration](https://docs.typo3.org/permalink/nitsan/ns-t3af:configuration@1.2).

## Privacy

Log detail depends on provider privacy settings and group audit limits from
[AI Permissions](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-permissions@1.2). Configure carefully before enabling full
prompt/response storage.

## Weekly admin habit

1.  Open **AI Foundation > AI Usage** and compare the trend with last week
1.  Scan **AI Foundation > AI Logs** for repeated failures (same user, same feature)
1.  Escalate persistent errors to [Support](https://docs.typo3.org/permalink/nitsan/ns-t3af:support@1.2) with log details

## When logs show high usage

-   Check [AI Features](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-features@1.2) — bulk tasks may need a cheaper model
-   Review group limits in [AI Permissions](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-permissions@1.2)
-   Ask editors if a script or loop triggered many requests

## When logs show failures

-   Run Test connection in [AI Providers](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-providers@1.2)
-   Check vendor status and rate limits
-   See [Known Problems](https://docs.typo3.org/permalink/nitsan/ns-t3af:known-problems@1.2) and [FAQ](https://docs.typo3.org/permalink/nitsan/ns-t3af:faq@1.2)