Getting Help

GitHub Issues

If you can't find a solution in the documentation:

• Bug Reports
• Feature Requests
• Discussions

Troubleshooting

Common Issues

Authentication Problems

• Verify your cloud platform credentials are valid (currently Azure)
• Check that your account has appropriate permissions
• Ensure you're targeting the correct cloud environment

Database Connection Issues

• Verify your graph database is running and accessible
• Check connection strings and credentials
• Ensure firewall rules allow connections

Data Collection Problems

• Review debug logs with the --debug flag
• HTTP 429 responses might occur in large environments. Retry logic is built into Cirro.
• Verify permissions for target resources

Debug Mode

Enable detailed logging for troubleshooting:

# Collection with debug output
cirro collect az azcli --debug

# Ingestion with debug output
cirro graph ingest --type az --file cirro_output.db --debug