---
title: "Enable Agent Debug Logs"
slug: "how-to-1"
updated: 2026-06-15T09:59:28Z
published: 2026-06-15T09:59:28Z
canonical: "kb.ctera.com/how-to-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.ctera.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable Agent Debug Logs

You can change the logging level of the CTERA Agent.

## Step-by-step guide

1. Log in to the agent.
2. Navigate to the hidden CLI page: [Use the Agent Command Line Interface (CLI)](/v1/docs/how-to-2).
3. Under **CLI Execution**, enter the following command to enable debug logging: `dbg level [level1] [level2] ... [leveln]` where level1 ...leveln can be:
  - aapi = 0x00000020 – api calls sent for an action
  - alert = 0x00020000 – log from alert messages
  - apps = 0x04000000
  - auth = 0x00200000 – SSO: communication with Kerberos
  - av = 0x00080000
  - backup = 0x00000800 – cloud backup and sync
  - caching = 0x20000000
  - cbck = 0x00040000
  - cloud_extender = 0x02000000
  - collaboration = 0x00800000
  - cttp = 0x00004000 – CTTP connection: suspected bad communication to the portal
  - cttp_data = 0x00008000 – information about the CTTP data stream
  - db = 0x00001000
  - debug = 0x00000004 – log from debug messages
  - dns = 0x00000200 – DNS communication
  - error = 0x00000001 – log from error messages
  - error_abort = 0x01000000
  - evictor = 0x08000000 – eviction of cached data
  - evictor_verbose = 0x10000000 – eviction of cached data
  - files = 0x00002000
  - http = 0x00000100 – HTTP communication
  - index = 0x00100000
  - info = 0x00000003 – log from info messages
  - license = 0x00400000 – the licensing from the portal
  - none = 0x00000000 – no logging
  - ntp = 0x00000400 – NTP connectivity
  - process = 0x00000008 – information about running processes such as the portal version and sync info
  - rsync = 0x00010000 – file level backup
  - samba = 0x00000010 – SSO: communication with Active Directory
  - storage = 0x00000040 – storage processes (repair (fsck), scrubbing)
  - upload = 0x00000080 – uploading information such as portal version
  - warning = 0x00000002 – log from warning messages

For example, enter the following command to set the Agent debug level to debug backup: `dbg level debug backup` CTERA Support may recommend different debug levels. For example, `dbg level debug storage backup` sets the level to debug for storage and backup

The log file is located in Windows in: C:\ProgramData\CTERA\CTERA Agent\log In Mac OS X and Linux, the log file is in: /var/log/

To turn off agent debug logging, run: `dbg level none`