Quickstart guide
Get from zero to full cloud cost visibility in under 10 minutes. This guide walks you through connecting your first cloud account and exploring your cost data.
Prerequisites
- A running CLARITY instance (provided by your administrator)
- Cloud credentials with read-only access to billing and resource APIs
- A modern web browser (Chrome, Firefox, Safari, or Edge)
Step 1: log in
Navigate to your CLARITY instance URL and sign in with the credentials provided during setup.
TIP
If this is a fresh installation, your administrator will have set up an initial admin account during deployment.
Step 2: add your first Cloud account
- Navigate to the Organizations page in the sidebar
- Click the Add Account button in the top-right corner
- Select your cloud provider — AWS, Azure, or GCP
- Fill in a Display Name and your provider credentials
AWS credentials
| Field | Description |
|---|---|
| Display Name | A friendly label (e.g., "Production AWS") |
| Access Key ID | Your IAM user access key (starts with AKIA...) |
| Secret Access Key | Your IAM user secret key |
| Account ID | Your 12-digit AWS account ID |
Azure credentials
| Field | Description |
|---|---|
| Display Name | A friendly label (e.g., "Production Azure") |
| Subscription ID | Your Azure subscription ID |
| Tenant ID | Your Azure AD tenant ID |
| Client ID | Service Principal application (client) ID |
| Client Secret | Service Principal client secret |
GCP credentials
| Field | Description |
|---|---|
| Display Name | A friendly label (e.g., "Production GCP") |
| Project ID | Your GCP project ID |
| Service Account Email | The service account email address |
| Private Key | The private key from your JSON key file |
- Optionally add tags (e.g.,
prod,dev) to organize your accounts - Click Create Account to store and validate your credentials
WARNING
Ensure your cloud credentials have read-only access. CLARITY never modifies your cloud resources. See the Cloud Setup guides for minimum required permissions per provider.
TIP
All credentials are encrypted at rest using AES-256 encryption before being stored. They are never logged or exposed through the interface.
Step 3: wait for initial sync
Once your credentials are validated, CLARITY automatically begins syncing your cloud data. The initial sync typically takes 2-5 minutes depending on the size of your environment.
You can monitor sync progress in the sidebar — a sync indicator will appear while data collection is in progress.
During the sync, CLARITY will:
- Pull billing data from your cloud provider's cost management APIs
- Discover all active resources across regions
- Collect performance metrics for optimization analysis
- Fetch existing commitment details (Reserved Instances, Savings Plans, CUDs)
- Query for provider-native recommendations
Step 4: explore your dashboard
Once the sync completes, your Dashboard will populate with:
- Total spend across all connected providers
- Month-over-month cost comparison
- Spend by provider breakdown
- Top services by cost
- Regional distribution of spend
- Cost forecast for the current billing period
Step 5: review recommendations
Navigate to the Insights page to see optimization recommendations:
- Idle resources — resources with near-zero utilization that can be terminated
- Underutilized resources — resources that can be downsized to a smaller instance type
- Cost optimization — provider-native recommendations for savings
TIP
If AI analysis is enabled on your instance, every recommendation is automatically validated by AI before being surfaced. You can also click Explain on any insight for a detailed, context-aware explanation.
A note on cloud-API charges
CLARITY queries your cloud provider's APIs every sync cycle to keep dashboards fresh. Most of those APIs are free — but AWS Cost Explorer charges $0.01 per request, and CLARITY uses it as the primary AWS cost source. The honest disclosure:
| What we call | Frequency | Approximate AWS bill impact per account |
|---|---|---|
Cost Explorer (GetCostAndUsage + GetCostAndUsageWithResources + sub-service decomposition) | ~8-10 calls per sync × 4 syncs/day | ~$9-12 per month |
| Pricing API, EC2/RDS/etc. describe APIs, CloudWatch metrics | every sync | $0 (within free tiers for typical fleet sizes) |
| Azure ARM list / Resource Graph / Azure Monitor metrics | every sync | $0 (within free tiers) |
| GCP Cloud Asset / Cloud Monitoring / Cloud Billing Catalog | every sync | $0 |
For a typical AWS bill of $5K-$200K/month, Cost Explorer fees are 0.005-0.2 % of the spend you're optimizing — small in absolute terms, but we want you to know the line item is there before you spot it on your AWS bill.
Tunable
The sync cadence is configurable. Customers who want to reduce Cost Explorer charges can dial sync frequency back in Settings → Sync Schedule; the trade-off is dashboard freshness.
What we deliberately don't ingest
We intentionally do not ingest the AWS Cost & Usage Report (CUR) or VPC Flow Logs as primary data sources. Both would add real customer cost (S3 storage + Athena queries for CUR; vended-logs charges for Flow Logs — easily $50-500/mo per busy VPC). They remain optional Enterprise-tier add-ons gated behind explicit opt-in. See ADR-0003 and ADR-0004 for the design decisions.
What's next?
Now that you have your first cloud account connected, explore the full feature set:
- Resources — Browse your complete cloud resource inventory with cost attribution
- Anomaly Detection — Set up alerts for unexpected cost spikes
- Forecasting — Review projected spend for budget planning
- Cost Allocation — Configure chargeback and showback for your teams
- Commitments — Review RI, Savings Plan, and CUD recommendations
- Reports — Generate executive reports for stakeholders
Need to connect additional providers? Repeat Step 2 for each cloud account. CLARITY supports multiple accounts per provider.