Skip to content

Commit e2a7259

Browse files
dm-chelupaticraigshoemaker
authored andcommitted
docs: add query tools section to ADX connector Learn article
1 parent 8e7c9f6 commit e2a7259

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

articles/sre-agent/adx-cluster-grouping.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,35 @@ With the ADX connector, your agent can:
3030
- Run scheduled health checks against your telemetry data.
3131
- Power [Kusto tools](kusto-tools.md) with deterministic, parameterized queries.
3232

33+
## What the connector enables
34+
35+
Once you create an ADX connector, your agent automatically gains access to Kusto query tools—no additional setup required. These tools let the agent:
36+
37+
| Tool | What it does |
38+
|------|--------------|
39+
| **Query** | Run KQL queries against any connected cluster and database |
40+
| **List databases** | Discover available databases on a cluster |
41+
| **List tables** | Show tables within a database |
42+
| **Table schema** | Inspect column names and types for a table |
43+
| **Sample data** | Preview rows from a table |
44+
45+
This means the moment your connector tests successfully, you can ask your agent questions like:
46+
47+
```text
48+
Show me error rates from the servicetelemetry database in the last 24 hours
49+
```
50+
51+
The agent writes and executes KQL on your behalf, using the connector's managed identity for authentication.
52+
53+
### Two ways to query
54+
55+
| Approach | How it works | Best for |
56+
|----------|-------------|----------|
57+
| **Ad-hoc queries** | Agent generates KQL during chat based on your question | Investigations, exploration, one-off analysis |
58+
| **Kusto tools** | Pre-built, parameterized KQL templates you define once | Repeatable health checks, standardized reports |
59+
60+
Ad-hoc queries work immediately with the connector. For Kusto tools, see [Kusto tools](kusto-tools.md) to create reusable query templates.
61+
3362
## How the ADX connector works
3463

3564
The ADX connector supports **multiple clusters in a single connector** through cluster groups. Each group shares a managed identity, so you don't need to create separate connectors for every cluster.

0 commit comments

Comments
 (0)