DeepSurface: Logging

Documentation
Installation Guide
Overview
Let DeepSurface Host For You
Getting Started
System Requirements
Self Hosted Quick Start - Installing to Cloud Platforms
Self Hosted - Installation Using an OVA
Registration, Package Installation, and Initialization
First Steps After Initialization of the Console
Deployment Options
Main and Subordinate Consoles
Agent-Based Deployment
User Managed Scan Deployment
Credentialed Scanning Deployment
Mixed Environment
Deployment Tools
Active Directory Group Policy
Microsoft Endpoint Configuration Manager (part of InTune)
Tanium Deploy
HCL BigFix
Ivanti
Virtual Machines
VMWare
Virtual Box
VirtualBox Guest Additions
AWS EC2 (BYOL)
AWS EC2 (Usage Based)
Azure Cloud
Google Cloud
Additional Items to Consider
Main Console Server Certificates
LDAP
TOFU
Clock Sync
DeepSurface Commands
Multiple Vulnerability Sources
API Documentation
User Guide
Reporting
Dashboards
Exports
Risk Insight
Hosts
Patches
Vulnerabilities
Vulnerability Instances
Users
Remediation Workflow Manager
Plans
Settings
Integrations
Workflow
Exporting
Accepted Risk Plans
Accepted Risk Workflow
Explore
Model
Paths
Activity
Tasks
Configuration Alerts
Scan Logs
Notification Settings
Scanning
Status
Agents
User Managed
Credentialed Scanning Settings
Credentials
Scan Groups
General Settings
Cloud Scanning
Network Connectivity
Subordinates
Vulnerability Sources
Setup
Sensitive Assets: Polices
Sensitive Assets: Manual
Admin Settings
SMTP Settings
Certificates
Outbound Proxy
Authentication Providers
Users
Tags
Integrations Guide
Vulnerability Sources
CrowdStrike Spotlight
SentinelOne
Carbon Black Cloud
Microsoft Defender for Endpoint
Wazuh
Lansweeper Cloud
Nessus API
Tenable.io API
Security Center/Tenable.sc API
Rapid7 InsightVM API
Qualys API
Nozomi Guardian
Eclypsium
AWS Inspector
Remediation
Jira Software
Tanium (BETA)
Authentication Providers
LDAP (Active Directory)
SAML (Azure Active Directory)
SAML (Google)
SAML (Okta)
PAM
CyberArk
Delinea (Thycotic)
Microsoft LAPS
Security Guide
Firewall Configuration
Base Network Requirements
Agent Network Requirements
Credentialed Scanning Network Requirements
API Network Requirements
How DeepSurface Scans Work
Domain (LDAP) Scanning
Host Scanning Routine
Reasons for the Administrative Access Requirement
Endpoint Protection Considerations
Other Items
Scope of Data Storage and Retention
IPS/IDS Considerations
Logging
Resetting the DSADMIN password
Product Information
Changelogs
Open source Licenses
End User License Agreement (EULA)

DeepSurface maintains multiple types of logs for different purposes. This guide briefly discusses each type of log, their locations, and what common deployment options are available.

Operating System Logs

The base operating system relies on standard logging services (e.g. rsyslogd) and is configured in a way typical of modern Linux distributions. Most system logs can be found under the /var/log directory, which are largely maintained by the rsyslogd service.

Installation Log

When installing DeepSurface, detailed logging information is captured and stored in the /var/log/deepsurface-install.log file. This log is mostly useful if the deepsurface-install script failed unexpectedly. If this occurs, please provide this log file to the DeepSurface support team for further investigation.

Main Appliance Logs

The DeepSurface appliance is the main service of RiskAnalyzer and uses a log management system that is independent from the operating system log service. The current log file is located at /var/log/deepsurface-appliance/current. Several other files can be found in the same directory. Those whose names begin with the @ character are older versions of the current log file. These logs contain verbose logging information generated by the appliance service, but are rotated strictly by size, which means an extensive history may not be kept. Subsets of these logs are tracked separately in the database (as in the case of scan logs) or are sent to the operating system's syslog daemon (as in the case of security audit events).

Scan Logs

When hosts or Windows domains are scanned by DeepSurface, the detailed logs generated by this event are captured in the database and made available in the Web UI. For more information, see the Scan Logs section of documentation.

Output to Syslog

A subset of appliance logs are also sent to the operating system's syslog daemon. This can be tuned by modifying the SYSLOG_LEVELS parameter in the /etc/kanchil/deepsurface.conf file, which contains a list of the different appliance logging levels that can be sent to syslog. By default, only the AUDIT level is reported. The available logging levels are:

Note that DeepSurface reports these events to the to the syslog DAEMON facility stream.

After updating the /etc/kanchil/deepsurface.conf, the appliance service must be restarted for the changes to take effect. You can do this by running the command: sudo svc -k /etc/service/deepsurface-appliance

Sending Syslog Events Off Host

The DeepSurface host operating system uses the rsyslog service to maintain syslog events. This service can be configured to send messages to other systems through the standard syslog protocol as well as a TLS encrypted form of this protocol. For more information on how to do this, refer to the Rsyslog Documentation and TLS client configuration examples.

Updater Service Logs

The DeepSurface updater service runs independently of the main appliance and is designed to perform software upgrades. This service triggers the updates of both operating system package upgrades and DeepSurface software upgrades. This service maintains a log (in the same format as the appliance service) under the /var/log/deepsurface-updater directory.

Submitting Logs to DeepSurface Support

If you need to report a problem to the DeepSurface support team, it will often speed up the resolution process by providing your DeepSurface appliance logs and basic configuration information. To make this process easy, the web console has a feature that allows you to download a ZIP file of the main appliance logs and other supporting information. Simply click on your profile icon in the top right corner of the web console and select About. Then click the "Download Support Info" button at the bottom of the page. It may require several seconds for the file to be generated. If you do not see it appear, you may need to disable your browser's pop-up blocker. Once downloaded, simply transmit the downloaded ZIP file to the DeepSurface support team via secure email or make other arrangments.

More Information