Zergaw Cloud Docs

Logs

The Logs page provides comprehensive access to all security events and WAF activity. It allows you to search, filter, and analyze detailed information about every request processed by your Web Application Firewall, helping you investigate incidents, identify patterns, and maintain security compliance.

logs-overview.png
Screenshot: Full logs page view showing stats, filters, and log table


Accessing the Logs Page

  1. Log in to your WAF management portal
  2. Navigate to Logs from the main sidebar menu
  3. You'll see all security events for your organization's domains

Page Components

1. Header and Domain Filter

At the top of the page, you'll find:

Use Cases:


2. Statistics Overview

Three key metrics are displayed at the top of the page:

Blocked Today

Shows the total number of requests that were blocked by the WAF today. This includes all blocked attacks regardless of severity level.

Allowed Today

Displays the number of requests that were allowed through (marked as warnings). These are typically suspicious requests that were logged but not blocked.

Top Rule

Shows the security rule that has been triggered most frequently. This helps identify the most common type of attack or security event.

logs-stats.png
Screenshot: Statistics cards showing Blocked Today, Allowed Today, and Top Rule

Understanding the Stats:


3. Search and Filters

The Logs page provides powerful filtering options to help you find specific events quickly.

Search Tips:

Severity Filter

Severity Levels:

Action Filter

Filtering Best Practices:

  1. Start broad: Begin with "All" filters to see the full picture
  2. Narrow down: Use filters to focus on specific concerns
  3. Combine filters: Use multiple filters together for precise results
  4. Clear filters: Reset to "All" when starting a new investigation

4. Logs Table

The main table displays all security events matching your current filters. Each row represents a single security event.

Table Columns

Timestamp

Client IP

Request URI

Rule

Severity

Action

logs-table.png
Screenshot: Logs table with columns and sample entries

Interacting with the Table


5. Pagination

At the bottom of the table, you'll find pagination controls.

Information Displayed:

How to Use:

Note: Filters automatically reset to page 1 when changed, ensuring you see the most relevant results first.


6. Log Detail Panel

Clicking on any log entry opens a detailed side panel with complete information about that security event.

Panel Sections

Header

Action and Severity Badges

Detailed Information:

log-detail-panel.png
Screenshot: Detailed log information panel

How to Use:

Use Cases:


Common Workflows

Investigating a Specific Attack

  1. Identify the Event: Use search or filters to find the log entry
  2. View Details: Click on the log entry to open the detail panel
  3. Review Information: Check IP address, request URI, and rule details
  4. Take Action:
    • Note the IP address for potential blocking
    • Review the rule to understand the threat type
    • Check if similar attacks are occurring

Finding All Events from an IP Address

  1. Use Search: Enter the IP address in the search bar
  2. Review Results: All events from that IP will be displayed
  3. Analyze Pattern: Look for repeated attacks or suspicious behavior
  4. Consider Blocking: If malicious, add to IP Ban List in Settings

Analyzing Attack Patterns

  1. Filter by Severity: Select "High" or "Critical" to focus on serious threats
  2. Review Top Rule: Check the statistics to see the most common attack type
  3. Examine Request URIs: Identify which pages or endpoints are being targeted
  4. Check Timestamps: Look for patterns in attack timing
  5. Geographic Analysis: Review IP addresses to identify attack sources

Daily Security Review

  1. Check Statistics: Review "Blocked Today" and "Allowed Today" counts
  2. Filter Critical Events: Set severity filter to "Critical"
  3. Review Top Rule: Understand the most common threat type
  4. Investigate Anomalies: Look for unusual patterns or spikes
  5. Document Findings: Note any trends or concerns

Weekly Security Audit

  1. Remove Filters: Start with all logs visible
  2. Review Blocked Attacks: Filter by "Blocked" action
  3. Analyze Patterns: Look for recurring IPs, rules, or URIs
  4. Check Geographic Distribution: Review IP addresses and countries
  5. Export Data: Use log details for compliance reporting

Understanding Log Information

Severity Levels Explained

Critical

High

Medium

Low

Action Types Explained

Blocked

Allowed (Warning)

Rule Information

Rule Name

Rule ID


Tips for Effective Log Analysis

Search Strategies

  1. Start Broad: Begin with general searches, then narrow down
  2. Use Multiple Terms: Combine IP addresses with rule names
  3. Search by Time: Use filters along with timestamp review
  4. Pattern Recognition: Look for repeated patterns in URIs or IPs

Filter Combinations

  1. High-Severity Blocked: Filter by "High" severity and "Blocked" action
  2. Critical Events: Filter by "Critical" severity only
  3. Specific Domain: Use host selector with severity filters
  4. Time-Based: Combine filters with pagination to review by date

Investigation Workflow

  1. Identify: Use search or filters to find relevant events
  2. Examine: Click entries to view detailed information
  3. Analyze: Look for patterns, repeated IPs, or attack types
  4. Document: Note findings for reporting or action
  5. Act: Take appropriate action (block IPs, adjust rules, etc.)

Performance Tips

  1. Use Filters: Filters reduce the number of logs to load
  2. Specific Searches: More specific searches are faster
  3. Domain Filter: Filter by domain when investigating specific issues
  4. Pagination: Navigate through results rather than loading all at once

Troubleshooting

No Logs Appearing

Possible Causes:

Solutions:

Logs Not Updating

Possible Causes:

Solutions:

Can't Find Specific Log

Possible Causes:

Solutions:

Detail Panel Not Opening

Possible Causes:

Solutions:


Best Practices

Regular Monitoring

  1. Daily Checks: Review critical and high-severity events daily
  2. Weekly Reviews: Conduct comprehensive log analysis weekly
  3. Monthly Audits: Perform detailed security audits monthly

Security Response

  1. Immediate Action: Investigate critical events immediately
  2. Pattern Recognition: Look for repeated attacks from same IPs
  3. Documentation: Keep records of significant security events
  4. Follow-Up: Verify that blocked attacks don't recur

Data Management

  1. Focus on Relevant Data: Use filters to focus on important events
  2. Export When Needed: Use detail panel information for reporting
  3. Regular Cleanup: Review and archive old logs periodically
  4. Compliance: Maintain logs according to your compliance requirements

Integration with Other Features

From Logs to Actions

Block IP Addresses:

  1. Identify malicious IPs in log entries
  2. Navigate to Settings → IP Ban List
  3. Add the IP address to the ban list

Adjust Geo-Rules:

  1. Review geographic patterns in log IPs
  2. Navigate to Settings → Geo Access
  3. Block or allow specific countries

Review Dashboard:

  1. Use log insights to understand dashboard metrics
  2. Cross-reference log data with dashboard statistics
  3. Validate security posture

Check Notifications:

  1. Verify notification settings match your log review priorities
  2. Adjust severity filters in notifications based on log analysis
  3. Ensure important events trigger alerts

Next Steps

After reviewing your logs, you may want to:


For more information about other features, see the Overview Guide or Dashboard Guide.