Sync Providers

After connecting your billing data providers, you need to manually sync their data into NarevAI for analysis. This guide explains how to trigger and manage your billing data synchronization.

​

How data sync works

NarevAI uses manual synchronization - you trigger data imports when needed rather than on a schedule. This gives you full control over when and what data to import.

​

Sync process

1. Connect Provider - Link your cloud account (see provider guides)
2. Trigger Sync - Manually start data import
3. Monitor Progress - Track sync status and results
4. Retry if Needed - Handle any failed synchronizations

​

Starting a data sync

​

1. Navigate to data sync

1. In the NarevAI sidebar, under Data Connections, click Sync
2. You’ll see the sync management interface with three main sections:
   • Primary Actions: Health Check, Refresh, Trigger Sync
   • Sync History Table: All previous sync runs
   • Action Menus: Details, retry, cancel options per sync

​

2. Trigger new sync

1. Click the Trigger Sync button
2. In the sync configuration dialog, set: Provider (Optional)
   • Choose specific provider (AWS, Azure, GCP, OpenAI) or leave empty for all
   Date Range Options:
   • Days Back: Number of days to sync backwards (default: 30, range: 1-365)
   • OR Custom Range: Set specific start and end dates
3. Click Start Sync to begin the process

​

Monitoring sync status

​

Sync run table columns

• Run ID: Unique identifier (first 8 characters shown)
• Provider: Which provider is being synced
• Status: Current sync state with colored badges
• Started: When the sync began (relative time)
• Duration: How long the sync takes
• Records: Count of processed, created, and updated records

​

Status types

• Pending (gray) - Queued for execution
• Running (blue) - Currently importing data
• Completed (green) - Successfully finished
• Failed (red) - Encountered errors
• Cancelled (gray) - Manually stopped

​

Managing sync runs

​

Available actions

For each sync run, you can:

• View Details - See comprehensive run information
• Copy Run ID - Copy identifier to clipboard
• Retry Sync - Re-run failed or cancelled syncs
• Cancel Sync - Stop running or pending syncs

​

Action availability

• Retry: Only available for failed or cancelled runs
• Cancel: Only available for running or pending runs
• View Details: Always available

​

Troubleshooting sync issues

​

Common problems

Sync Fails Immediately

• Check provider credentials haven’t expired
• Verify network connectivity
• Ensure provider permissions are still valid

No Data Found

• Confirm billing data exists in provider for requested date range
• Check if exports are properly configured (24-48 hour delay is normal)
• Verify account access to billing information

Partial Data Import

• Review detailed error messages in sync details
• Try smaller date ranges to isolate issues
• Check provider-specific limits and quotas

Sync Takes Too Long

• Reduce the date range being synced
• Check provider API rate limits
• Monitor system resources

​

Getting help

1. View Sync Details - Click on any sync run for comprehensive information
2. Check Health Status - Use the Health Check button to verify sync service
3. Review Error Messages - Failed syncs show specific error details
4. Provider Troubleshooting - Reference individual provider guides for specific issues

​

Data Import Frequency

Since syncs are manual, consider these guidelines:

• Initial Setup: Import 30-90 days of historical data
• Regular Updates: Weekly or bi-weekly syncs for recent data
• Analysis Prep: Sync before important cost reviews
• Issue Investigation: On-demand syncs when investigating cost spikes

​

What to do next

After successful data synchronization:

1. Verify data - Check that expected records imported
2. Explore Analytics - Navigate to cost analysis dashboards
3. Set Baselines - Establish cost benchmarks from imported data
4. Plan Regular Syncs - Decide on your manual sync frequency

Your billing data is now ready for analysis in NarevAI