> ## Documentation Index
> Fetch the complete documentation index at: https://support.entegrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Resolve common resource collection issues

## Overview

This guide helps you diagnose and resolve common issues with resource collection, configuration, and discovery.

### Resource Not Discovered

If a resource doesn't appear after discovery:

1. Verify the resource exists in the source system
2. Check that the Service Account has READ permissions
3. Ensure the resource is in a schema/database the connection can access
4. Trigger a manual discovery to force a refresh

### Collection Failing

If a resource collection fails:

1. Check the job error message in the Jobs tab
2. Verify source system connectivity and permissions
3. Review filters - overly restrictive filters may cause issues
4. Check for schema changes that broke the collection

### Incremental Load Not Working

If incremental loads are collecting more data than expected:

1. Verify the incremental load field is updating when records change
2. Check the field data type is compatible (date/datetime/timestamp)
3. Review the last collected timestamp in job details
4. Consider using a Full Refresh to reset the incremental cursor

## Best Practices

<CardGroup cols={2}>
  <Card title="Use Incremental Loads" icon="forward">
    For large datasets, use incremental loads to improve performance and reduce costs
  </Card>

  <Card title="Set Unique Keys" icon="key">
    Always define unique keys to ensure data quality and proper deduplication
  </Card>

  <Card title="Apply Filters Early" icon="filter">
    Filter data at the source to reduce transfer time and storage costs
  </Card>

  <Card title="Test Schedule Changes" icon="clock">
    After changing schedules, monitor the first few collections to ensure timing is correct
  </Card>
</CardGroup>