| name | cisco-dime-cli |
| description | Use when managing Cisco CUCM log files via the cisco-dime CLI — selecting, downloading, and listing service logs from Cisco UC products via DIME. |
| license | MIT |
| metadata | {"author":"sieteunoseis","version":"1.0.0"} |
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
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
