> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/legacy-products/proxy-builder/proxy-builder-cloud-dashboard/logs-and-logging.md).

# Logs & Logging

Manage how your Proxidize device stores, views, and clears proxy logs, both at the host level and per individual endpoint.

## Overview

Proxy logging records request data passing through your endpoints, including timestamps, proxy type, error codes, source IP, destination IP, bytes sent/received, HTTP method, and URL.

**Logging is controlled at two levels:**

* **Host level:** configure logging behavior for all endpoints on a host at once (enable/disable, scheduled deletion, clear all logs)
* **Endpoint level:** manage logs for a specific endpoint individually (view logs, schedule deletion, clear logs)

{% hint style="info" %}
If proxy logging is disabled at the host level, the "View Proxy Logs" option will be greyed out for all endpoints on that host.
{% endhint %}

***

## Host-Level Log Settings

These settings are found in the **Host Settings** tab of your Cloud Dashboard.

### Enable / Disable Proxy Logging

By default, proxy logging is enabled. You can toggle it off if you want to minimize data storage or prevent any request data from being recorded on that host.

Keep in mind that disabling logging means no historical data will be available for troubleshooting. If an issue occurs while logging is off, there will be nothing to inspect after the fact.

To change the status, click the **Change** button next to **Proxy Logging**.

![](/files/9e7206a25c493d723260a2946d3e470bd55d1800)

### Scheduled Logs Deletion

This setting lets you automatically delete logs across all endpoints on a host at a set interval, so your server doesn't accumulate unnecessary data over time.

You can set the interval in **days**, **weeks**, or **months**. Once set, logs will be deleted automatically at each interval. You can also terminate an existing schedule at any time using the **Terminate Schedule** button.

To configure it, click **Change** next to **Scheduled Logs Deletion** in Host Settings.

![](/files/5030dbc1f2024de7ad2f246881facbfd7f281fa8)

### Clear All Proxy Logs

This permanently deletes all proxy logs stored on the selected host in one action — across every endpoint. This is useful for freeing up server space or removing sensitive data quickly.

{% hint style="warning" %}
This action is irreversible. Once cleared, logs cannot be recovered. Back up anything important before proceeding.
{% endhint %}

To use it, click **Clear** next to **Clear All Proxy Logs** in Host Settings.

![](/files/85749bdb33db71337508d9b38f9b3a234313bf2b)

***

## Endpoint-Level Log Management

Per-endpoint log actions are accessible from the **Endpoints** tab. Select any endpoint, then open the **Log Actions** dropdown.

![](/files/91ef45ce0d296ed33f3789ea5c0fc8cba4408521)

### View Proxy Logs

Opens the proxy log viewer for that specific endpoint, showing a detailed table of all recorded requests with the following columns:

| Column                | Description                   |
| --------------------- | ----------------------------- |
| Timestamp             | When the request was made     |
| Proxy Type            | HTTP, HTTPS, SOCKS5, etc.     |
| Error Code            | Response or error status      |
| Source IP             | IP initiating the request     |
| Destination IP        | IP being accessed             |
| Bytes Sent / Received | Data volume                   |
| Method                | HTTP method (GET, POST, etc.) |
| URL                   | Full request URL              |

{% hint style="info" %}
This option is greyed out if proxy logging is disabled in the host's settings.
{% endhint %}

### Schedule Logs Deletion (Per Endpoint)

Works the same way as the host-level scheduled deletion, but applies only to the selected endpoint. Set an interval in **days**, **weeks**, or **months**, and logs will be automatically cleared at each cycle.

You can also terminate an active schedule without setting a new one.

![](/files/0a40a66af61802c112b7c65a7d9a552cebb00086)

### Clear Logs (Per Endpoint)

Permanently deletes all logs for the selected endpoint only. Use this when you want to clear a specific endpoint without affecting the rest of the host.

{% hint style="warning" %}
This action is irreversible. Logs cannot be recovered once cleared.
{% endhint %}

***

## Activity Logs

**Available on:** Business plan only

Activity Logs give you a full account-level audit trail of every action performed on your Proxidize dashboard, who did what, on which host, and when. This is designed for accountability, not proxy diagnostics.

Each entry includes:

| Column     | Description                                                           |
| ---------- | --------------------------------------------------------------------- |
| Action     | What was performed (e.g. IP rotation, reboot, remote support session) |
| Host       | Which host the action was performed on                                |
| User Email | The account that triggered the action                                 |
| Time       | When the action took place                                            |

You can find Activity Logs in the left sidebar of your Cloud Dashboard.

### Filtering & Export

* **Filter by email:** narrow down actions performed by a specific user
* **Filter by host:** view all actions on a specific host
* **Column visibility:** toggle individual columns on or off depending on what you need
* **CSV export:** export the full log for record-keeping or sharing with your team

***

## Quick Reference

| Action                   | Scope                              | Where to Find It            |
| ------------------------ | ---------------------------------- | --------------------------- |
| Enable / Disable Logging | [Entire host](#Host-level)         | Host Settings tab           |
| Scheduled Logs Deletion  | Entire host                        | Host Settings tab           |
| Clear All Proxy Logs     | Entire host                        | Host Settings tab           |
| View Proxy Logs          | [Single endpoint](#Endpoint-level) | Endpoints tab → Log Actions |
| Schedule Logs Deletion   | Single endpoint                    | Endpoints tab → Log Actions |
| Clear Logs               | Single endpoint                    | Endpoints tab → Log Actions |

***

## Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.proxidize.com/legacy-products/proxy-builder/proxy-builder-cloud-dashboard/logs-and-logging.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.