> ## Documentation Index
> Fetch the complete documentation index at: https://www.narev.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync provider billing data

> Trigger manual syncs, monitor scheduled imports, and troubleshoot failures when ingesting cloud and AI provider billing data into Varne.

> [!NOTE]
>
> This page documents **Varne v0**. **Varne v1 is in development**. These instructions apply to v0, not the developing v1 branch.

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

## How data sync works

Varne 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](https://www.narev.ai/docs/varne/v0/connect-providers.md))
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 Varne 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

> [!NOTE]
>
> **Sync Duration**: Syncs can take several minutes to hours depending on:
>
> 1. Amount of historical data requested
>
> 2. Provider data availability and processing speed
>
> 3. Number of providers being synced simultaneously

## 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 Varne


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.