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.

Report types

TypeWhat it showsBuilt from
User ActivityActive users, session time, events per category, and per user the targets, applications and sites they usedActivity events
Authentication ActivitySuccessful and failed logins per day, failed-login reasons, and per user their loginsuser.login and user.failedlogin events
AI Agent ActivityAI agents, models and servers per user and per agent peer, top tool calls and policy violationsThe AI Edge events of every source, and the calls recorded in AI sessions
AI UsageRequests, tokens, cost, latency and MCP tool calls recorded by the Netzilo AI Gateway and Netzilo clientsUsage 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 Reports page under Activity listing seven reports of the types Authentication Activity, AI Activity and AI Usage, each with Report Date, Range and Groups, and view, download and delete buttons

The table lists every report with:

ColumnWhat it shows
TypeThe report type. AI Agent Activity reports are labelled AI Activity in this table.
Report DateWhen the report was generated.
RangeThe period the report covers.
GroupsThe 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

  1. Go to Activity > Reports and click Create Report.
  2. In the Generate Report dialog, pick the Report Type.
  3. Choose the Date Range. The default is the last two weeks.
  4. Optionally pick Groups to limit the report to the users in those groups. Leave it empty to include everyone.
  5. Click Save.

The Generate Report dialog with the Report Type list open, showing User Activity, Authentication Activity (selected), AI Agent Activity and AI Usage

FieldWhat to enter
Report TypeUser Activity, Authentication Activity (the default), AI Agent Activity or AI Usage.
Date RangeThe first and last day of the period. Both days are included.
GroupsUser 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_typeReport
user_activityUser Activity
authenticationAuthentication Activity
ai_activityAI Agent Activity
ai_usageAI 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.