Documentation Index
Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt
Use this file to discover all available pages before exploring further.
Try free on Pangolin Cloud
Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
What are HTTPS Request Logs?
HTTPS Request logs capture every HTTPS request that passes through a reverse proxy, including the request details, the decision made (allow or deny), and the reason for that decision. These logs are useful for:- Monitoring traffic patterns and request volumes
- Debugging access issues and rule configurations
- Analyzing API usage and endpoint popularity
- Understanding geographic distribution of requests
- Identifying potential security threats or unusual traffic patterns
- Troubleshooting connectivity and routing issues
HTTPS Request Log Fields
Each HTTPS request log entry contains the following fields:| Field | Type | Description |
|---|---|---|
timestamp | number | Unix timestamp (in seconds) when the request was made |
action | boolean | Whether the request was allowed (true) or denied (false) |
reason | number | Numeric code indicating the reason for the decision |
actorType | string | The type of actor making the request (“user”, “apiKey”, or null for anonymous) |
actor | string | The display name of the authenticated actor (username or API key name) |
actorId | string | The unique identifier for the authenticated actor |
resourceId | number | The ID of the resource that received the request |
ip | string | The IP address of the client making the request |
location | string | The geographic location (country code) based on IP address |
userAgent | string | The user agent string of the client browser or application |
metadata | string | Additional contextual information in JSON format |
headers | string | HTTP request headers in JSON format |
query | string | URL query parameters in JSON format |
originalRequestURL | string | The full original URL of the request |
scheme | string | The protocol scheme (http or https) |
host | string | The hostname from the request |
path | string | The URL path of the request |
method | string | The HTTP method (GET, POST, PUT, DELETE, etc.) |
tls | boolean | Whether the connection used TLS/SSL |
Log Retention
HTTPS Request log retention is controlled by the organization setting. By default, HTTPS request logs are retained for 7 days.HTTPS Request logs can generate significant data volume depending on your traffic. Consider your storage capacity when configuring retention periods.