Add CPU utilization update demo and related configurations. Introduce new environment variables for CPU utilization CSV path and dry run mode in .env.example. Update README with detailed instructions for the CPU utilization update demo, including CSV format requirements and usage examples. Enhance .gitignore to exclude the data directory and add new npm scripts for CPU utilization demo.

Author: fortran01

.env.example

@@ -5,4 +5,6 @@ LOG_LEVEL=info
 BULK_BATCH_SIZE=50
 BULK_CONCURRENT_BATCHES=3
 BULK_RETRY_ATTEMPTS=3
-BULK_RETRY_DELAY=1000 
+BULK_RETRY_DELAY=1000
+CPU_UTILIZATION_CSV_PATH=data-examples/server-utilization.csv
+DRY_RUN=false 

.gitignore

@@ -1,6 +1,7 @@
 plans/
 TODO.md
 backups/
+data/
 
 # Dependencies
 node_modules/

README.md

@@ -31,10 +31,12 @@ TIDAL_WORKSPACE=your_workspace_name
 TIDAL_USERNAME=your_username
 TIDAL_PASSWORD=your_password
 LOG_LEVEL=info
-BULK_BATCH_SIZE=50
-BULK_CONCURRENT_BATCHES=3
-BULK_RETRY_ATTEMPTS=3
-BULK_RETRY_DELAY=1000
+BULK_BATCH_SIZE=5
+BULK_CONCURRENT_BATCHES=1
+BULK_RETRY_ATTEMPTS=5
+BULK_RETRY_DELAY=2000
+CPU_UTILIZATION_CSV_PATH=data-examples/server-utilization.csv
+DRY_RUN=false
 ```
 
 The base URL is automatically generated as `https://{workspace}.tidal.cloud/api/v1`.
@@ -107,9 +109,54 @@ Or run directly:
 npx ts-node examples/server-backup-demo.ts
 ```
 
+### CPU Utilization Update Demo
+
+Updates server custom fields with CPU utilization data from CSV. Configure the CSV file path in your `.env` file using `CPU_UTILIZATION_CSV_PATH`.
+
+**CSV Format Requirements:**
+```csv
+Name,CPU Utilization %,Memory Utilization %,Disk Utilization % (Peak)
+server01,25.5,65.2,45.3
+server02,78.9,92.1,67.8
+```
+
+**Dry Run Mode:**
+Preview changes before applying them:
+
+```bash
+# Using npm script (recommended)
+npm run demo:cpu-utilization:dry-run
+
+# Using command line flag
+npx ts-node examples/cpu-utilization-update-demo.ts --dry-run
+
+# Using environment variable
+DRY_RUN=true npm run demo:cpu-utilization
+```
+
+**Apply Changes:**
+```bash
+npm run demo:cpu-utilization
+```
+
+Or run directly:
+
+```bash
+npx ts-node examples/cpu-utilization-update-demo.ts
+```
+
+**Rate Limiting:**
+The demo includes built-in rate limiting protection:
+- Sequential processing (not concurrent) to avoid overwhelming the API
+- 500ms delays between individual API calls
+- 2-3 second delays between batches
+- Automatic retry with exponential backoff for 429 errors
+- Conservative batch sizes (5 records per batch)
+
 ### Available Examples
 
 - `basic-authentication.ts` - Authentication methods and client setup
+- `cpu-utilization-update-demo.ts` - Update server custom fields from CSV data
 - `server-backup-demo.ts` - Server backup operations
 - `hostname-to-fqdn-demo.ts` - Hostname to FQDN conversion
 - `hostname-to-tag-demo.ts` - Hostname to tag operations

data-examples/README.md

@@ -0,0 +1,43 @@
+# Data Directory
+
+This directory contains sample data files used by the examples.
+
+## server-utilization.csv
+
+Sample CSV file for the CPU utilization update demo. This file demonstrates the required format for importing server utilization data.
+
+### Format Requirements
+
+The CSV file must have the following structure:
+
+```csv
+Name,CPU Utilization %,Memory Utilization %,Disk Utilization % (Peak)
+server01,25.5,65.2,45.3
+server02,78.9,92.1,67.8
+```
+
+### Column Descriptions
+
+- **Name**: Server hostname (must match hostnames in your Tidal workspace)
+- **CPU Utilization %**: CPU utilization percentage (used to update the `cpu-util-manual-pct` custom field)
+- **Memory Utilization %**: Memory utilization percentage (currently for reference only)
+- **Disk Utilization % (Peak)**: Peak disk utilization percentage (currently for reference only)
+
+### Usage
+
+1. Replace the sample data with your actual server utilization data
+2. Ensure server names match the hostnames in your Tidal workspace
+3. Configure the path in your `.env` file:
+   ```env
+   CPU_UTILIZATION_CSV_PATH=data-examples/server-utilization.csv
+   ```
+4. Run the demo:
+   ```bash
+   npm run demo:cpu-utilization
+   ```
+
+### Notes
+
+- Rows with missing or invalid CPU utilization data (empty or "-") will be skipped
+- The demo will search for exact hostname matches (case-insensitive)
+- Servers not found in Tidal will be reported in the failed updates section 

data-examples/server-utilization.csv

@@ -0,0 +1,11 @@
+Name,CPU Utilization %,Memory Utilization %,Disk Utilization % (Peak)
+server01,25.5,65.2,45.3
+server02,78.9,92.1,67.8
+web-server-01,45.2,78.5,34.6
+db-server-01,89.3,95.7,78.2
+app-server-01,34.7,56.8,23.9
+web-server-02,52.1,71.3,56.4
+db-server-02,91.2,88.9,82.1
+cache-server-01,12.8,34.5,15.7
+api-server-01,67.4,82.3,49.5
+load-balancer-01,23.6,45.8,12.3