Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xloud.tech/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

An audit is a point-in-time analysis of the cluster. When you create an audit, the Optimization collects current cluster metrics, applies the selected strategy algorithm, and generates a prioritized action plan. Audits are fast — typically 30 seconds to 2 minutes depending on cluster size and data source responsiveness.
Prerequisites
  • Optimization enabled on your platform
  • At least 1 hour of metric data collected (for telemetry-backed strategies)
  • Project access with the member role or above

​
Create and Run an Audit

Navigate to Audits

Navigate to Optimization → Audits.

Create a new audit

Click Create Audit and fill in the parameters:
FieldDescriptionExample
NameDisplay name for the auditdaily-consolidation-2026-03
GoalOptimization objectiveserver_consolidation
ScopeTarget scopeCLUSTER
StrategyOptional overrideLeave blank for default
Auto TriggerRun on a scheduleOptional
Leave Strategy blank to use the default strategy for the selected goal. Override only if your administrator has configured custom strategies.

Confirm the audit

Click Create. The audit status progresses:PENDING → ONGOING → SUCCEEDED
Audit reaches SUCCEEDED status and an action plan is generated.

​
Audit States

StateMeaning
PENDINGAudit queued, waiting for Decision Engine capacity
ONGOINGDecision Engine is collecting metrics and computing recommendations
SUCCEEDEDAudit complete — action plan generated
FAILEDAudit could not complete — check error detail
CANCELLEDManually cancelled before completion

​
Audit Scope Options

ScopeDescriptionWhen to Use
CLUSTERAnalyze all hosts and instances in the clusterFull cluster rebalancing
ZONEAnalyze only instances in a specific availability zoneZone-specific consolidation
Run zone-scoped audit
watcher audit create \
  --goal zone_migration \
  --scope ZONE \
  --name zone-a-rebalance

​
Strategy Parameters

Override default strategy thresholds when creating an audit:
Audit with custom consolidation threshold
watcher audit create \
  --goal server_consolidation \
  --parameter threshold=0.15 \
  --parameter period=7200 \
  --name low-threshold-consolidation
ParameterStrategyDefaultDescription
thresholdserver_consolidation0.2Utilization ratio below which a host is underutilized
periodAll3600Look-back window in seconds
granularityTelemetry-backed300Metric sample granularity in seconds

​
Next Steps

Action Plans

Review and approve the migration plan generated by your audit.

Execute Actions

Start a recommended action plan to rebalance workloads.

Optimization Goals

Understand which goal to select for different operational scenarios.

Troubleshooting

Resolve audit failures and empty action plan scenarios.