--- title: Access Logs description: Retrieve information about requests to your site from WP Engine User Portal url: https://developers.wpengine.com/docs/headless-platform/platform-guides/access-logs/ image: https://developers.wpengine.com/og/docs/headless-platform/platform-guides/access-logs.png --- # Access Logs This guide describes access logs available to Headless Platform users. Access logs contain records of all requests made to your website that pass through our CDN network. They can help you identify malicious activity, resolve issues related to website availability and functionality, gain insights into popular content and identify traffic patterns. ## Available Log Fields Logs are available for download as a `.csv` file with the following headers: | CSV Header | Description | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Timestamp | The date and time when the request was made | | Response Status | The HTTP status code returned by the server | | Host | The hostname to which the client made the request | | Cache Status | The status of CDN cache when serving the request. It indicates whether the content was served from CDN cache or fetched from the origin server. | | IP | The IP address of the user making the request | | Path | The path of the requested URL, excluding the domain name and the query string. | | Method | The HTTP method used for the request (GET, POST, etc.). | | User Agent | The User-Agent string provided by the client (usually a web browser or a bot). The User-Agent string includes information about the client’s browser, operating system, and other attributes. | | Country | The country from which the client made the request, as determined by the IP address of the client. | ## Requesting Access Logs To download a `.csv` file containing access logs for your website follow these steps: ### Open Access Logs Panel Visit the Environment Details page of a Headless Platform environment you’re interested in and navigate to left-hand submenu `Logs` item (first image below), then select the `Access Logs` tab (second image below): ![Access logs tab in User Portal](https://developers.wpengine.com/_astro/open-logs-from-submenu.oXxuBfna_Z2ikjaU.webp) ![Access logs tab in User Portal](https://developers.wpengine.com/_astro/access-logs-tab.D36TV6XM_Z1GLNbb.webp) ### Select Datetime Range Select the start and end date of the range you want to retrieve logs for. Datetime pickers will use your local timezone. You can request logs for up to a 24 hour window. ![Select start and end date of the time range](https://developers.wpengine.com/_astro/access-logs-time-picker.DzHCyB3__Ztnie6.webp) After clicking the `Request Logs` button, the following confirmation message should appear on your screen: ![Confirmation - operation successful](https://developers.wpengine.com/_astro/access-logs-success.BuUccJMX_Z177ynY.webp) ### Await Download Link Notifications Access log requests are processed in the background. When they are ready for download you will receive notifications in the User Portal and via email. > **Note** > > Notifications are delivered to the user that requested access logs in the User Portal and to the e-mail associated with that user. Links to download access logs are only valid for 24 hours. #### Portal Notification A notification will appear in the User Portal notifications feed. You can click the `Download` button to download the access log file. ![Portal notification with link](https://developers.wpengine.com/_astro/access-logs-notification.p0D_cmBv_Z98s56.webp) #### Email Notification You will also receive an email notification. You can click the link in the email to download the access log file. ![E-mail notification with link](https://developers.wpengine.com/_astro/access-logs-success-email.DE0Mo-yE_Z1Upj3S.webp) ## Usage limits At the moment the following limitations are in place: ### Duration and Time Span The maximum span between ‘start time’ and ‘end time’ for which access logs can be requested is 24 hours. In the User Portal, users can request logs from maximum 4 days ago. If older logs are needed, please contact the [WP Engine Support team](https://developers.wpengine.com/docs/headless-platform/platform-guides/support/). ### Max Requests Per Day Access logs can be requested a maximum of 20 times per Headless Platform environment within 24 hours. ## Errors and troubleshooting In case your request was failed to be processed, you’ll receive the following notification and an e-mail about the failure: ![Error in User Portal](https://developers.wpengine.com/_astro/access-logs-error.DjXV5n9t_Z2a3FmI.webp) In case there are no logs for the time period you requested, you’ll receive an e-mail with a note that there are no logs available for that time range: ![E-mail - no access logs found](https://developers.wpengine.com/_astro/access-logs-empty-email.Bt2XmfJm_Z4j5Br.webp) [Section titled “Feedback”](https://developers.wpengine.com/docs/headless-platform/platform-guides/access-logs/#feedback) The Headless Platform product team is actively seeking your feedback! If you have any thoughts about the feature, ideas for improvements, or find something that doesn’t work you’d expect it to - please submit your feedback through our feedback tool. You can access it in the WP Engine User Portal, by scrolling all the way down to the bottom of the page and clicking on “Product feedback”. ![Provide feedback in the User Portal](https://developers.wpengine.com/_astro/access-logs-feedback.F6odUNMJ_2vgdFH.webp) Our team is actively monitoring the channel and will respond to these messages timely. ## Was this helpful? Thanks for the feedback! ```json {"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://developers.wpengine.com/#website","name":"WP Engine Product Documentation","url":"https://developers.wpengine.com/","description":"Resources for developing, deploying, and scaling on WP Engine.","inLanguage":"en-US","keywords":["API documentation","product documentation","headless WordPress","managed WordPress hosting"],"publisher":{"@id":"https://wpengine.com/#organization"}}]} ```