Common Issues

Data

• No data on a surface - connection not sending / surface not linked / time window too narrow. Check the connection status and Live Stream; verify the surface is wired; widen the window: ProductData | where Timestamp > ago(7d) | take 10.
• Data is delayed or stale - source batching or network latency. Check the source and your network.

Connections

• Connection timeout / Unable to connect - network or firewall, or the source is unreachable. Confirm the source is reachable and outbound HTTPS (443) is allowed.
• Authentication failed / Invalid credentials - wrong or rotated credentials. Re-copy them, rotate with the secondary, and confirm the credential has the access it needs.
• Invalid connection string / endpoint - truncated or malformed. Copy the full value; remove stray spaces or line breaks.

Queries

• Query returns empty - time window too narrow, a field-name typo (KQL is case-sensitive), or a filter too restrictive. Start with ProductData | take 10, then add filters one at a time.

• Invalid KQL syntax - common mistakes:

  Mistake	Fix
  = instead of ==	use == for equals
  single quotes 'text'	use double quotes "text"
  missing pipe between steps	add | where ...
  wrong date format	use datetime(2026-01-01)

• Column not found - check exact names with ProductData | take 1 | project * (case matters).

• Query timeout - put a time filter first: | where Timestamp > ago(1h).

Permissions

• Permission denied - your role doesn't include it. Ask a workspace admin for Editor/Admin (see Team & Access Rights).
• Invalid API key / 401 - expired or revoked token. Generate a new one under APIs -> API Keys.

Surfaces

• Surface not found / 404 - renamed, deleted, or wrong workspace. Check the workspace's surfaces.
• Can't create queries in a surface - you're a Viewer, or no connection is linked. Request Editor, or link a connection first.

Quick reference

Error	Likely cause	Quick fix
No data	connection or time filter	check connection status
Auth failed	credentials	re-copy / rotate secondary
Timeout	firewall / network	check connectivity
Empty query	time or filter	widen the time range
Permission denied	role	ask an admin