--- title: "Enabling and disabling the xAgent logging policy" slug: "enabling-and-disabling-the-xagent-logging-policy-1" updated: 2026-09-08T19:19:55Z published: 2026-09-08T19:19:55Z canonical: "docs.trellix.com/enabling-and-disabling-the-xagent-logging-policy-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Enabling and disabling the xAgent logging policy [Skip to main content](/docs/enabling-and-disabling-the-xagent-logging-policy-1#content-wrapper) You can enable and disable the xAgent logging policy for all host sets using the xAgent default policy. You can also enable and disable the xAgent logging policy for selected host sets using a custom policy. This section covers the following topics: - [Enabling the Agent Logging Policy](/docs/enabling-and-disabling-the-xagent-logging-policy-1#UUID-b6bb2e0f-62a5-65f9-fe07-1f81ded7af28) - [Disabling the Agent Logging Policy](/docs/enabling-and-disabling-the-xagent-logging-policy-1#UUID-4bf87e90-b24b-651d-b6df-0854ea7818df) ### Note The xAgent Component Logging features permit you to enable enhanced logging on your HX appliance. You should only enable these features when instructed by the Trellix support team. ##### Enabling the xAgent logging policy To enable the xAgent logging policy for all host endpoints: 1. Log in to the Web UI as an administrator. 2. From the **Admin** menu, select **Policies** to access the **Policies** page. 3. In the Policies table, click the **Agent Default Policy** link to go to the **Edit Policy** page. 4. Select the **Agent Logging** tab. ![Agent_Logging_tab_LogStorage.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-37603daa-01cf-0ccf-02c8-7471c6379bfb(2).jpg?sv=2026-02-06&spr=https&st=2026-11-22T12%3A53%3A09Z&se=2026-11-22T13%3A53%3A09Z&sr=c&sp=r&sig=TN5Su2YeSe9uquFAefpnKiiH94fIbV%2BtzaZTrSckACM%3D) 5. Toggle the **Agent Logging ON/OFF** switch to **ON**. 6. Click the **Agent log level** menu and select the agent log level. See [Understanding Agent Logging Levels](/docs/understanding-xagent-logging-levels-1) for more information. 7. Enter the size of the log database in the **Log Storage** box. - Default value: 50,000 events - Minimum:10,000 events - Maximum: 5,000,000 events 8. From the Component Logging section, click the **checkbox** next to the each component to enable agent logging. 9. Click **Save**. To enable an xAgent logging policy for selected host sets: 1. Log in to the Web UI as an administrator. 2. From the **Admin** menu, select **Policies** to access the **Policies** page. 3. In the Policies table, click the link for the custom policy you want to modify. 4. Select the **Agent Logging** tab to access the **Edit Policies** page. ![Agent_Logging_tab_LogStorage.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-37603daa-01cf-0ccf-02c8-7471c6379bfb(2).jpg?sv=2026-02-06&spr=https&st=2026-11-22T12%3A53%3A09Z&se=2026-11-22T13%3A53%3A09Z&sr=c&sp=r&sig=TN5Su2YeSe9uquFAefpnKiiH94fIbV%2BtzaZTrSckACM%3D) 5. Toggle the **Agent Logging ON/OFF** switch to **ON**. 6. Click the **Agent log level** menu and select the agent log level. See [Understanding Agent Logging Levels](/docs/understanding-xagent-logging-levels-1) for more information. 7. Enter the size of the log database in the **Log Storage** box. 8. From the Component Logging section, click the checkbox next to each component to enable agent logging. 9. Click **Save**. ##### Disabling the xAgent logging policy To disable the agent logging policy for all host endpoints: 1. Log in to the Web UI as an administrator. 2. From the **Admin** menu, select **Policies** to access the **Policies** page. 3. In the Policies table, click the **Agent Default Policy** link to go to the **Edit Policy** page. 4. Select the **Agent Logging** tab. ![Agent_Logging_tab_LogStorage.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-37603daa-01cf-0ccf-02c8-7471c6379bfb(2).jpg?sv=2026-02-06&spr=https&st=2026-11-22T12%3A53%3A09Z&se=2026-11-22T13%3A53%3A09Z&sr=c&sp=r&sig=TN5Su2YeSe9uquFAefpnKiiH94fIbV%2BtzaZTrSckACM%3D) 5. Toggle the **Agent Logging ON/OFF** switch to **OFF**. 6. Click **Save**. To disable an agent logging policy for selected host sets: 1. Log in to the Web UI as an administrator. 2. From the **Admin** menu, select **Policies** to access the **Policies** page. 3. In the Policies table, click the **link** for the custom policy you want to modify. 4. Select the **Agent Logging** tab to access the **Edit Policies** page. ![Agent_Logging_tab_LogStorage.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-37603daa-01cf-0ccf-02c8-7471c6379bfb(2).jpg?sv=2026-02-06&spr=https&st=2026-11-22T12%3A53%3A09Z&se=2026-11-22T13%3A53%3A09Z&sr=c&sp=r&sig=TN5Su2YeSe9uquFAefpnKiiH94fIbV%2BtzaZTrSckACM%3D) 5. Toggle the **Agent Logging ON/OFF** switch to **OFF**. 6. Click **Save**. :