Skip to Content
PlatformIntroductionFAQ

Platform FAQ

Getting Started

How do I get access to CloudQuery Platform?

Request access and provide your team name. After your account is provisioned, you’ll receive a URL for your installation and admin login credentials. See Creating a New Account for the full walkthrough.

What’s the difference between CloudQuery Platform and CloudQuery CLI?

  • CloudQuery Platform: Managed service with a web UI, built-in asset inventory, SQL console, reports, policies, automations, AI-powered analysis, and SSO. Data is synced and stored in a managed ClickHouse database.
  • CloudQuery CLI: Command-line tool that runs on your infrastructure. You manage the syncs, choose your own destination database, and handle scheduling yourself.

Platform is the primary product for teams that want visibility, governance, and automation out of the box. CLI is for teams that need full control over the pipeline and destination.

Does CloudQuery Platform support Single Sign-On (SSO)?

Yes. CloudQuery Platform supports SSO through SAML-based identity providers. See Enabling Single Sign-On for setup instructions.

Syncs and Integrations

Which integrations does CloudQuery Platform support?

CloudQuery supports 100+ source integrations including AWS, Google Cloud, Azure, DigitalOcean, GitHub, GitLab, Slack, Jira, Okta, and many more. Browse the full list at CloudQuery Hub.

How often does CloudQuery sync my data?

You control the schedule. Syncs can run daily, weekly, monthly, on a custom cron schedule, or on-demand. Preset schedules run at midnight UTC. See Setting up a Sync for configuration details.

Where does my synced data go?

CloudQuery Platform includes a default managed ClickHouse database. All platform features (Asset Inventory, SQL Console, Reports, Policies) run against this database. You can also configure additional destinations if you need data in your own systems.

Can I sync data from multiple cloud accounts or regions?

Yes. You can set up separate integrations for each account, project, or subscription. Each integration configuration should have a unique name to avoid data conflicts. See the Integration Guides for provider-specific setup.

Features

What are Policies?

Policies are SQL-based detective controls that continuously evaluate your cloud infrastructure. You write a SQL query that defines what a violation looks like, and CloudQuery runs it after every sync. Each row returned is a violation.

Unlike IaC scanners that only catch issues at deployment time, Policies detect problems in resources that already exist, including ones created through the console or by tools that have since drifted.

Policies can be organized into groups (CIS, SOC 2, HIPAA) and trigger notifications to Slack or webhook destinations. See Policies for details.

What can I do with Reports?

Reports give you a visual overview of your cloud resources, security posture, compliance status, and cost optimization opportunities. They’re defined as YAML code, so you can build from scratch or customize one of the built-in templates.

Each report widget is backed by a SQL query. You can click through to the SQL Console from any visualization to explore the underlying data. See Reports for details.

What is the Asset Inventory?

The Asset Inventory is a unified, normalized view of all your cloud assets across every connected integration. Resources from AWS, GCP, Azure, and other providers appear in a single searchable inventory with consistent schemas, organized into categories like Compute, Storage, Networking, Databases, and Identity.

You can filter by any attribute, save filters for reuse, and inspect individual resources including their related resources. See Asset Inventory for the full feature overview.

What is the SQL Console?

The SQL Console lets you run ClickHouse SQL queries directly against your synced data. You can query raw integration tables, the unified Asset Inventory tables, or join across both. Queries can be saved, shared with your team, and managed via the REST API.

The SQL Console is read-only. You can’t modify the underlying data. See SQL Console for details.

What AI features does CloudQuery offer?

CloudQuery Platform includes two AI-powered features:

  • AI Query Writer: Built into the SQL Console. Describe what you want in natural language, and the AI generates the SQL. The model can access table names and schemas but does not have access to your actual data.
  • MCP Server: Connects CloudQuery to Claude Desktop, Cursor, VS Code, or any MCP-compatible tool. In Platform mode, it can execute queries and reason about your data. See CloudQuery MCP Server for setup instructions.

How do notifications work?

CloudQuery Platform supports two notification destination types: Slack (native OAuth integration with channel selection) and Webhook (HTTP POST to any endpoint, including PagerDuty, Opsgenie, or custom services).

Notifications are triggered by policy violations and alerts. Configure destinations in Organization Settings, then attach them to individual policies or alerts. See Notification Destinations for setup details.

Data and Security

Does CloudQuery access my application data?

No. CloudQuery integrations access metadata and configuration data from cloud provider APIs (resource inventories, IAM configurations, network settings). Your application data, file contents, and database records are not accessed.

Where is my data stored on CloudQuery Platform?

Your synced data is stored in a managed ClickHouse database that is part of your CloudQuery Platform installation. The data is accessible through the Asset Inventory, SQL Console, Reports, and Policies features.

Can I delete synced data?

Yes. The Data Management page lets you view all synced integrations and their tables, and selectively delete data. Deletions remove the data from ClickHouse, including any views and historical snapshots built on those tables. If the integration is still active, deleted tables repopulate on the next sync.

Does the AI Query Writer have access to my data?

No. The AI model can access table names and their schemas to generate accurate SQL, and it can test queries for syntax errors. It does not retrieve or see actual data from your warehouse.

Getting Help

Where can I get help with CloudQuery Platform?

How do I report a bug?

  1. Check if the issue already exists on GitHub
  2. If not, create a new issue with:
    • Steps to reproduce the problem
    • Expected vs actual behavior
    • Screenshots of the Platform UI if relevant
    • Your browser and OS version
Last updated on
Getting HelpCreating a New Account