Reports
Reports summarise the activity of your users and AI agents over a period you choose. Use them for regular reviews, for audits and to measure how your policies and guardrails work. You can read a report in the dashboard or download it as a PDF.
You find them under Activity > Reports.
Only administrators can open Activity. Reports contain personal data, such as names, e-mail addresses and the activity of each user.
Report types
| Type | What it shows | Built from |
|---|---|---|
| User Activity | Active users, session time, events per category, and per user the targets, applications and sites they used | Activity events |
| Authentication Activity | Successful and failed logins per day, failed-login reasons, and per user their logins | user.login and user.failedlogin events |
| AI Agent Activity | AI agents, models and servers per user and per agent peer, top tool calls and policy violations | The AI Edge events of every source, and the calls recorded in AI sessions |
| AI Usage | Requests, tokens, cost, latency and MCP tool calls recorded by the Netzilo AI Gateway and Netzilo clients | Usage records of the AI Gateway and of clients that record AI sessions |
Use AI Agent Activity to see what AI tools did and what was blocked on every device and browser. Use AI Usage to see the recorded AI usage and what it cost.
The Reports page

The table lists every report with:
| Column | What it shows |
|---|---|
| Type | The report type. AI Agent Activity reports are labelled AI Activity in this table. |
| Report Date | When the report was generated. |
| Range | The period the report covers. |
| Groups | The groups the report is limited to, or All. |
Each row has three buttons:
- View (eye icon) opens the report.
- Download (arrow icon) saves the report as a PDF.
- Delete (bin icon) removes the report after you confirm.
Create a report
- Go to Activity > Reports and click Create Report.
- In the Generate Report dialog, pick the Report Type.
- Choose the Date Range. The default is the last two weeks.
- Optionally pick Groups to limit the report to the users in those groups. Leave it empty to include everyone.
- Click Save.

| Field | What to enter |
|---|---|
| Report Type | User Activity, Authentication Activity (the default), AI Agent Activity or AI Usage. |
| Date Range | The first and last day of the period. Both days are included. |
| Groups | User groups. Empty means all users. For AI Usage, groups limit the report to their members' usage. |
The server builds the report. When it is ready it appears in the table, and you can view or download it. Generating and deleting reports is recorded in Events (Activity report created, Authentication report created, Activity report deleted).
Use the API
Create and read reports with the API:
curl -X POST -H "Authorization: Token $NZ_TOKEN" -H "Content-Type: application/json" \
https://srv.netzilo.com/api/reports \
-d '{"report_type":"ai_activity","from":"2026-10-01","to":"2026-10-07","groups":[]}'
report_type | Report |
|---|---|
user_activity | User Activity |
authentication | Authentication Activity |
ai_activity | AI Agent Activity |
ai_usage | AI Usage |
from and to are dates (YYYY-MM-DD); to is included. groups takes group IDs and is
optional. GET /api/reports lists reports, GET /api/reports/{id} returns one and
DELETE /api/reports/{id} deletes it. On a self-hosted server, use your own domain instead of
srv.netzilo.com.
Troubleshooting
A report is empty. Nothing happened in the period, or the users in the selected groups have no activity. Widen the date range or clear Groups.
The AI Usage report is empty, but devices report AI events. AI Usage counts only traffic through the Netzilo AI Gateway. Use the AI Agent Activity report for traffic seen on devices, in browsers and by coding-agent hooks.
Authentication Activity has no logins on a self-hosted server. Log-in events come from the identity provider. They need the built-in identity provider and the service account it was given at install.
Related Documentation
- User Activity - User behaviour and events per category
- Authentication Activity - Logins and failed logins
- AI Agent Activity - AI agents, tool calls and violations
- AI Usage - Requests, tokens and cost through the AI Gateway
- Events - The events behind the reports
- Event Streaming - Send every event to your SIEM

