cisco-dime CLI

CLI for downloading log files from Cisco UC products (VOS) via DIME.

Setup

Configure a cluster (one-time, interactive prompt for password — never pass credentials on the command line):

cisco-dime config add <name> --host <host> --username <user> --insecure
# You will be prompted securely for the password
cisco-dime config test

For Secret Server integration:

cisco-dime config add <name> --host '<ss:ID:host>' --username '<ss:ID:username>' --password '<ss:ID:password>' --insecure

Or use environment variables (set via your shell profile, a .env file, or a secrets manager — never hardcode credentials):

export CUCM_HOST=<host>
export CUCM_USERNAME=<user>
export CUCM_PASSWORD=<pass>

Discover Available Logs

cisco-dime list-services

Built-in Presets

Preset	Services
sip-traces	Cisco CallManager, Cisco CTIManager
cti-traces	Cisco CTIManager
curri-logs	Cisco Extended Functions
syslog	messages, CiscoSyslog
tomcat	Tomcat, Tomcat Security
oamp	Cisco Unified OS Admin, Cisco Unified CM Admin
audit	Cisco Audit Logs

Common Workflows

Grab SIP traces from last 30 minutes

cisco-dime select sip-traces --last 30m --download --insecure

Select logs then download specific files

cisco-dime select sip-traces --last 2h --insecure
cisco-dime download 1,3,5 --insecure

Query all cluster nodes

cisco-dime select sip-traces --last 1h --all-nodes --insecure
cisco-dime download --all --organize --insecure

Select by date range

cisco-dime select "Cisco CallManager" --from "2026-03-19 08:00" --to "2026-03-19 09:00" --timezone America/Chicago --insecure

Download and decompress

cisco-dime download --all --decompress --output-dir ./logs --insecure

Output Formats

• --format table (default) — human-readable
• --format json — for scripting/parsing
• --format toon — token-efficient for AI agents (recommended)
• --format csv — for spreadsheets

Global Flags

• --insecure — required for self-signed CUCM certs (most environments)
• --all-nodes — query all cluster nodes automatically
• --last <duration> — relative time (30m, 2h, 1d)
• --download — download immediately after select
• --organize — save files in host/date subdirectories
• --decompress — gunzip .gz files after download
• --debug — enable verbose logging