search_logs_by_ip
Search pfSense firewall or system log lines for activity tied to a specific IP address to investigate connections, access, or security incidents.
Instructions
Search logs for activity related to a specific IP address
WARNING (tracked by upstream PR #860): this endpoint may fail on firewalls with large log files due to a known pfSense REST API bug (server-side OOM at the 512 MB PHP limit). If it fails, suggest reviewing logs via SSH or the pfSense web UI instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ip_address": "<ip_address>"
},
"name": "search_logs_by_ip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | No | Number of newest raw log lines to search (default 50, max 50); no match does not prove there was no older activity | |
| log_type | No | Type of logs to search (firewall, system, etc.) | firewall |
| ip_address | Yes | IP address to search for |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||