Connect to Azure Data Explorer (ADX)

What you'll build

A connection to your Azure Data Explorer (Kusto) cluster so your agent can query logs and telemetry. Learn more → Kusto Tools. Time: ~15 minutes.

Prerequisites

• An existing ADX cluster
• Admin access to grant database permissions
• Agent created in SRE Agent portal

Steps

Step 1: Get cluster details

Find your cluster URL:

https://{cluster-name}.{region}.kusto.windows.net

Note the database name you want to query.

Step 2: Grant agent permissions

Your agent's managed identity needs database access:

.add database {database-name} viewers ('aadapp={agent-managed-identity-id}')

Step 3: Add connector in portal

1. Go to Builder → Connectors

2. Click Add connector

3. Select Kusto

4. Enter:

   • Name: descriptive name (e.g., "production-logs")
   • Cluster URL: from Step 1
   • Database: default database name

5. Click Test connection

   You should see a Connection successful confirmation. If the test fails, check the Troubleshooting section.

6. Click Save

Checkpoint: The connector appears in your Connectors list with a Connected status badge.

Step 4: Verify access

Ask your agent:

List the tables in the production-logs database

What you learned

• How to find your ADX cluster URL and grant the agent database access
• How to add and test a Kusto connector in the portal
• How to verify the connection by querying tables through chat

Troubleshooting

Issue	Solution
Connection test fails	Verify cluster URL is correct, ensure managed identity has viewer role, check firewall allows SRE Agent IPs

Related

Resource	What you'll learn
Create Kusto Tool	Build reusable queries
Diagnose with 3P Observability	Use Kusto for diagnosis