---
title: "AI Usage & Logs"
manual: "AI Foundation"
version: "main"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-usage-and-logs@main"
source: "Configuration/AIUsageAndLogs/Index.rst"
modified: "2026-09-15T14:55:33+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@main).

## 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@main).

## Privacy

Local logs never store prompt or response text. Privacy level on each
[AI provider](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-providers@main) (and optional UserTSconfig
`nst3af.privacyLevel`) controls **local AI Usage telemetry only**. It does
not change what is sent to the AI provider.

Full DPA and GDPR notes, including BYOK vs Credits, retention, and cleanup
commands: [DPA & GDPR](https://docs.typo3.org/permalink/nitsan/ns-t3af:data-processing-agreement@main).

## 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@main) with log details

## When logs show high usage

-   Check [AI Features](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-features@main) — bulk tasks may need a cheaper model
-   Review group limits in [AI Permissions](https://docs.typo3.org/permalink/nitsan/ns-t3af:ai-permissions@main)
-   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@main)
-   Check vendor status and rate limits
-   See [Known Problems](https://docs.typo3.org/permalink/nitsan/ns-t3af:known-problems@main) and [FAQ](https://docs.typo3.org/permalink/nitsan/ns-t3af:faq@main)