Logs
Log Overview
Sandfly keeps track of almost everything it does in relation to scanning your hosts. The logs here reflect at a high level what is going on with Sandfly. The Logs section of the sidebar contains the following logs:
These logs are described in detail below.
Response Action Log
The Response action log contains a time-ordered record of all manually requested response actions. Each entry shows the status of the request (for example, success, failed, or pending), the action, the target host, the user that requested the action, and a message with the details. Examples of logged actions include:
- Process Kill, Process Suspend, and Process Resume
- Process Retrieve and File Retrieve
- SSH Key Remove and SSH Key Dedup
Users with the Responder role can download or delete the files that retrieve actions collected. Automatic responses from sandflies are not recorded in this log.
AI Analysis
The AI analysis page contains two views:
- Analyses - The AI analyses started on hosts, artifacts, and results, and their conversations.
- Request log - Every request sent to the configured AI provider, for analysis and triage alike. Each entry shows the status, the purpose (Analysis, Host triage, or Artifact triage), the trigger (Manual or Automatic), the user that requested it, the provider and model, the input and output token counts, and the duration.
AI analysis must be enabled by an admin in the AI Configuration settings to view existing analyses and create new ones. If neither AI analysis nor AI triage is enabled, the Request log view shows an AI Not Enabled warning.
Scanning Error Log
The Scanning error log contains high-level, system-level errors. These are errors that happened during the running of Sandfly and are different from the individual sandfly error events described in the Results Viewer section. Errors at the high level are often intermittent and caused by network issues or perhaps problems on the remote host unrelated to Sandfly. Examples of high-level system errors can include:
- Host timeout
- Remote host errors
- SSH login and authentication errors
- Server and database errors
It is rare that a system-level error is fatal. Normally, Sandfly will simply log what happened and carry on. If you see the same error happening repeatedly though, you can contact us for more help diagnosing the problem.
Audit Log
The Audit log contains all the information about the operations Sandfly is performing. Examples include:
- User login/logout
- Scans initiated
- Scheduled scans that have run
- Hosts added or deleted
- Results added or deleted
- Credentials management operations
- Other system operations
The audit log also contains information on failed operations such as scheduled scans, node status failures, and related data.
Updated 15 days ago