← Back to SKIT

SKIT User Manual

A plain-English guide to using SKIT — no technical background needed.

Contents

  1. What is SKIT?
  2. Getting your logs into SKIT
  3. Chat — ask the AI questions
  4. Dashboard — see what was found
  5. DML Logs
  6. Logs — uploading files & running a scan
  7. The Log Forwarding Agent (automatic uploads)
  8. Team Admin
  9. Usage Admin
  10. Billing Admin
  11. Audit Log Admin
  12. Settings
  13. Common questions

🛡 What is SKIT?

SKIT watches the activity logs from your Odoo system and looks for anything unusual — things like someone trying many passwords in a row, a new admin account being created out of nowhere, a server running out of memory, or a database error that keeps repeating. It flags these as anomalies so you don't have to read through thousands of log lines yourself.

You can also just ask it questions in plain English — like "Were there any login attacks today?" — and it will answer using your own logs.

📥 Getting your logs into SKIT

Before SKIT can find anything, it needs your logs. There are two ways to get them in:

1
Upload a file by hand — good for a quick test, or a one-time check. See Logs below.
2
Install the Log Forwarding Agent — this is the real, ongoing setup. It runs quietly on your server and keeps sending new log activity to SKIT automatically, so you never have to upload a file again. See The Log Forwarding Agent below.
New here? Uploading a file once is the fastest way to see SKIT actually catch something. Setting up the Agent afterward is what makes detection ongoing and automatic.

💬 Chat — ask the AI questions

This is the first screen you see when you log in. Type a question about your Odoo logs, or click one of the ready-made questions on the left (like "Login failures / brute force" or "Prioritise for me") and SKIT will answer using your own log data — nothing made up, nothing from the internet.

Some things you can ask:

Clicking Ask AI anywhere in SKIT (for example, next to an item on the Dashboard) brings you straight to this Chat screen with that question already answered.

📊 Dashboard — see what was found

The Dashboard shows every unusual event SKIT has found, most serious first. Each row shows when it happened, which server it came from, how serious it is (Critical, High, Medium), and a short plain-English explanation.

Two buttons on each row:

The circle on the left side of the screen shows your overall risk score — the higher the percentage, the more your logs show serious problems.

📋 DML Logs

This tab (only shown if your logs come from an Odoo database) lists every database change SKIT noticed — records being updated or deleted, timeouts, and access-denied events. Useful for tracing exactly what changed and who did it.

⬆ Logs — uploading files & running a scan

Uploading a log file

1
Open the Logs tab.
2
Click Choose Files and pick one or more .log, .txt, or .csv files (100 MB each, max).
3
(Optional) Type a short name for the server this log came from, e.g. web1.
4
Click Upload.

Running the scan (finding anomalies)

Uploading a file only stores it — SKIT doesn't look through it until you tell it to. Right below the upload box, you'll find a Run Collector Now section on this same page (it's also available under Settings, if you prefer):

Click Run Collector and watch the progress in the box underneath. When it finishes, check the Dashboard for anything it found.

You no longer need to go to Settings to run a scan after uploading — this button is right here on the Logs page too.

📡 The Log Forwarding Agent (automatic uploads)

Instead of uploading files by hand every time, install the Agent once on each server you want watched. It quietly keeps sending new log activity to SKIT in the background — no more manual uploads.

You can download it from the Settings page.

Windows

1
Download the Windows Agent from Settings.
2
Run it. A small window opens.
3
Fill in your Receiver URL, your API Key (see below), a name for this server, and the folder your logs are written to.
4
Click Save & Start. The window disappears into the system tray and keeps running from then on.

Linux — with a desktop screen

Same idea as Windows: download, run run_agent.sh, fill in the same four fields in the window that opens, click Save & Start.

Linux — server with no screen (SSH / terminal only)

Many production Linux servers don't have a desktop at all — you connect to them with a terminal (SSH). The Agent now handles this automatically: if it doesn't find a screen to open a window on, it simply asks for the same information as plain text questions, right there in your terminal.

1
Download the Linux Agent from Settings and copy it to your server.
2
In your terminal, run: bash run_agent.sh
3
Answer the questions it asks — Receiver URL, API Key, a name for this server, and which folder to watch.
4
It saves your answers and starts sending logs right away. Leave this running (or start it inside a tool like screen or tmux so it keeps going after you disconnect).

Next time you run it, it remembers your last answers and just asks "Use this configuration?" — press Enter to reuse it, or type n to change something.

Getting your API Key

In SKIT, go to Settings → Log Receiver → Generate / Regenerate Key. Copy it immediately — for security, SKIT only shows it to you once.

Treat your API Key like a password. Anyone with it can send data into your SKIT account. If you think it's been exposed, generate a new one — the old one stops working immediately.

👥 Team Admin only

Add and manage the people on your team. Each person gets a role:

📊 Usage Admin only

Shows how much of your plan's allowance you're using — team members and storage — so you know when it's time to consider a bigger plan.

💳 Billing Admin only

See your current plan, change to a different plan, or cancel. A few things worth knowing:

📜 Audit Log Admin only

A record of important actions taken on your account — who did what, and when. Useful for keeping track of changes your team makes.

⚙ Settings

Account

Change your own password here.

Log Receiver Admin only

Generates the API Key the Log Forwarding Agent needs — see above.

Ollama AI

Technical setting for connecting SKIT to the AI model that powers Chat and the anomaly explanations. Your administrator or SKIT support will usually set this up once and you won't need to touch it.

Log Forwarding Agent

Download links for Windows and Linux — see above.

Run Collector Now

The same scan button described under Logs — this copy exists here too since it's also useful when you're already on the Settings page.

Danger zone

Clear MongoDB collections permanently deletes all of your stored logs and detected anomalies. This cannot be undone. Only use this if you genuinely want to start over.

❓ Common questions

I uploaded a log but the Dashboard is empty.

Uploading only stores the file — you still need to click Run Collector (on the Logs page or in Settings) to actually scan it.

What's the difference between uploading a file and using the Agent?

An uploaded file is a snapshot of that moment only — anything that happens on your server afterward won't show up until you upload again. The Agent keeps sending new activity automatically, so detection stays current without you doing anything.

My Linux server has no screen — will the Agent still work?

Yes. It automatically switches to asking for the same information as plain text questions in your terminal instead of opening a window. See The Log Forwarding Agent above.

I lost my API Key.

Go to Settings → Log Receiver → Generate / Regenerate Key to create a new one. Any Agent still using the old key will need the new one entered too.

Who can I ask if I'm stuck?

Contact whoever manages your SKIT account (usually your COMPANY_ADMIN) or your SKIT support contact.