Agentskillz Logo

microsoft/azure-skills / azure-kusto

azure-kusto

Установки
551,647
Автор
microsoft/azure-skills

Помогает работать с Azure Data Explorer (Kusto): выполнять KQL-запросы, исследовать схему таблиц, анализировать логи, телеметрию и временные ряды. Полезен для поиска аномалий, агре

Установить скилл

npx skills add https://github.com/microsoft/azure-skills --skill azure-kusto

Аудит безопасности

Gen Agent Trust Hub

pass

This skill enables analysis of Azure Data Explorer data using Kusto Query Language (KQL). It uses established Azure CLI tools and official service endpoints, aligning with standard administrative practices for Microsoft Azure.

Audited: 4/22/2026, 10:04:54 PM

Socket

pass

No alerts

Audited: 4/22/2026, 10:05:04 PM

Snyk

pass

Risk: LOW · No issues

Audited: 4/22/2026, 10:04:29 PM

Runlayer

warn

1/1 file flagged

Audited: 3/11/2026, 9:39:28 PM

ZeroLeaks

pass

Score: 93/100 · 2 sections analyzed

Audited: 4/15/2026, 10:02:33 PM

Промпт скилла

Azure Data Explorer (Kusto) Query & Analytics

Execute KQL queries and manage Azure Data Explorer resources for fast, scalable big data analytics on log, telemetry, and time series data.

Skill Activation Triggers

Use this skill immediately when the user asks to:

  • "Query my Kusto database for [data pattern]"
  • "Show me events in the last hour from Azure Data Explorer"
  • "Analyze logs in my ADX cluster"
  • "Run a KQL query on [database]"
  • "What tables are in my Kusto database?"
  • "Show me the schema for [table]"
  • "List my Azure Data Explorer clusters"
  • "Aggregate telemetry data by [dimension]"
  • "Create a time series chart from my logs"

Key Indicators:

  • Mentions "Kusto", "Azure Data Explorer", "ADX", or "KQL"
  • Log analytics or telemetry analysis requests
  • Time series data exploration
  • IoT data analysis queries
  • SIEM or security analytics tasks
  • Requests for data aggregation on large datasets
  • Performance monitoring or APM queries

Overview

This skill enables querying and managing Azure Data Explorer (Kusto), a fast and highly scalable data exploration service optimized for log and telemetry data. Azure Data Explorer provides sub-second query performance on billions of records using the Kusto Query Language (KQL).

Key capabilities:

  • Query Execution: Run KQL queries against massive datasets
  • Schema Exploration: Discover tables, columns, and data types
  • Resource Management: List clusters and databases
  • Analytics: Aggregations, time series, anomaly detection, machine learning

Core Workflow

  1. Discover Resources: List available clusters and databases in subscription
  2. Explore Schema: Retrieve table structures to understand data model
  3. Query Data: Execute KQL queries for analysis, filtering, aggregation
  4. Analyze Results: Process query output for insights and reporting

Query Patterns

Pattern 1: Basic Data Retrieval

Fetch recent records from a table with simple filtering.

Example KQL:

Events
| where Timestamp > ago(1h)
| take 100

Use for: Quick data inspection, recent event retrieval

Pattern 2: Aggregation Analysis

Summarize data by dimensions for insights and reporting.

Example KQL:

Events
| summarize count() by EventType, bin(Timestamp, 1h)
| order by count_ desc

Use for: Event counting, distribution analysis, top-N queries

Pattern 3: Time Series Analytics

Analyze data over time windows for trends and patterns.

Example KQL:

Telemetry
| where Timestamp > ago(24h)
| summarize avg(ResponseTime), percentiles(ResponseTime, 50, 95, 99) by bin(Timestamp, 5m)
| render timechart

Use for: Performance monitoring, trend analysis, anomaly detection

Pattern 4: Join and Correlation

Combine multiple tables for cross-dataset analysis.

Example KQL:

Events
| where EventType == "Error"
| join kind=inner (
    Logs
    | where Severity == "Critical"
) on CorrelationId
| project Timestamp, EventType, LogMessage, Severity

Use for: Root cause analysis, correlated event tracking

Pattern 5: Schema Discovery

Explore table structure before querying.

Tools: kusto_table_schema_get

Use for: Understanding data model, query planning

Key Data Fields

When executing queries, common field patterns:

  • Timestamp: Time of event (datetime) - use ago(), between(), bin() for time filtering
  • EventType/Category: Classification field for grouping
  • CorrelationId/SessionId: For tracing related events
  • Severity/Level: For filtering by importance
  • Dimensions: Custom properties for grouping and filtering

Result Format

Query results include:

  • Columns: Field names and data types
  • Rows: Data records matching query
  • Statistics: Row count, execution time, resource utilization
  • Visualization: Chart rendering hints (timechart, barchart, etc.)

KQL Best Practices

🟢 Performance Optimized:

  • Filter early: Use where before joins and aggregations
  • Limit result size: Use take or limit to reduce data transfer
  • Time filters: Always filter by time range for time series data
  • Indexed columns: Filter on indexed columns first

🔵 Query Patterns:

  • Use summarize for aggregations instead of count() alone
  • Use bin() for time bucketing in time series
  • Use project to select only needed columns
  • Use extend to add calculated fields

🟡 Common Functions:

  • ago(timespan): Relative time (ago(1h), ago(7d))
  • between(start .. end): Range filtering
  • startswith(), contains(), matches regex: String filtering
  • parse, extract: Extract values from strings
  • percentiles(), avg(), sum(), max(), min(): Aggregations

Best Practices

  • Always include time range filters to optimize query performance
  • Use take or limit for exploratory queries to avoid large result sets
  • Leverage summarize for aggregations instead of client-side processing
  • Store frequently-used queries as functions in the database
  • Use materialized views for repeated aggregations
  • Monitor query performance and resource consumption
  • Apply data retention policies to manage storage costs
  • Use streaming ingestion for real-time analytics (< 1 second latency)
  • Integrate with Azure Monitor for operational insights

MCP Tools Used

ToolPurpose
kusto_cluster_listList all Azure Data Explorer clusters in a subscription
kusto_database_listList all databases in a specific Kusto cluster
kusto_queryExecute KQL queries against a Kusto database
kusto_table_schema_getRetrieve schema information for a specific table

Required Parameters:

  • subscription: Azure subscription ID or display name
  • cluster: Kusto cluster name (e.g., "mycluster")
  • database: Database name
  • query: KQL query string (for query operations)
  • table: Table name (for schema operations)

Optional Parameters:

  • resource-group: Resource group name (for listing operations)
  • tenant: Azure AD tenant ID

Fallback Strategy: Azure CLI Commands

If Azure MCP Kusto tools fail, timeout, or are unavailable, use Azure CLI commands as fallback.

CLI Command Reference

OperationAzure CLI Command
List clustersaz kusto cluster list --resource-group <rg-name>
List databasesaz kusto database list --cluster-name <cluster> --resource-group <rg-name>
Show clusteraz kusto cluster show --name <cluster> --resource-group <rg-name>
Show databaseaz kusto database show --cluster-name <cluster> --database-name <db> --resource-group <rg-name>

KQL Query via Azure CLI

For queries, use the Kusto REST API or direct cluster URL:

az rest --method post \
  --url "https://<cluster>.<region>.kusto.windows.net/v1/rest/query" \
  --body "{ \"db\": \"<database>\", \"csl\": \"<kql-query>\" }"

When to Fallback

Switch to Azure CLI when:

  • MCP tool returns timeout error (queries > 60 seconds)
  • MCP tool returns "service unavailable" or connection errors
  • Authentication failures with MCP tools
  • Empty response when database is known to have data

Common Issues

  • Access Denied: Verify database permissions (Viewer role minimum for queries)
  • Query Timeout: Optimize query with time filters, reduce result set, or increase timeout
  • Syntax Error: Validate KQL syntax - common issues: missing pipes, incorrect operators
  • Empty Results: Check time range filters (may be too restrictive), verify table name
  • Cluster Not Found: Check cluster name format (exclude ".kusto.windows.net" suffix)
  • High CPU Usage: Query too broad - add filters, reduce time range, limit aggregations
  • Ingestion Lag: Streaming data may have 1-30 second delay depending on ingestion method

Use Cases

  • Log Analytics: Application logs, system logs, audit logs
  • IoT Analytics: Sensor data, device telemetry, real-time monitoring
  • Security Analytics: SIEM data, threat detection, security event correlation
  • APM: Application performance metrics, user behavior, error tracking
  • Business Intelligence: Clickstream analysis, user analytics, operational KPIs

Все файлы скилла

Другие скиллы автора

azure-diagnostics

554,288 установок

microsoft/azure-skills

Скилл для системной диагностики и устранения проблем Azure в продакшене: от App Service, Functions и AKS до виртуальных машин и очередей сообщений. Использует AppLens, Azure Monitor и проверку ресурсов, чтобы быстро находить первопричины сбоев, анализировать логи и предлагать шаги по восстановлению.

azure-prepare

553,704 установок

microsoft/azure-skills

Скилл готовит проекты к развёртыванию в Azure: анализирует кодовую базу, выбирает подходящий сценарий (Bicep, Terraform или AZD) и создаёт всю необходимую инфраструктуру — план развёртывания, конфигурационные файлы и Dockerfile. Автоматизирует подготовительный этап, чтобы последующая валидация и деплой прошли без ошибок.

azure-ai

553,621 установок

microsoft/azure-skills

Скилл для работы с сервисами Azure AI: поиск (включая векторный и гибридный), распознавание и синтез речи, транскрибация, OCR и документы. Помогает быстро выполнять задачи через MCP-инструменты или подсказывает нужные SDK-примеры для Python, TypeScript и .NET. Ускоряет интеграцию с Azure AI Search, Speech, OpenAI и Document Intelligence.

azure-deploy

553,594 установок

microsoft/azure-skills

Навык автоматизирует развертывание уже подготовленных приложений в Azure с помощью azd, terraform и az deployment. Он проверяет готовность плана, выполняет деплой, обрабатывает ошибки и подтверждает успешный запуск, возвращая ссылки на ресурсы. Полезен для надежного и повторяемого деплоя без ручных шагов.

azure-validate

553,079 установок

microsoft/azure-skills

Проверяет готовность Azure-окружения к развертыванию: конфигурацию, Bicep/Terraform-шаблоны, роли RBAC и разрешения managed identity. Позволяет выявить проблемы до деплоя, сэкономить время и избежать сбоев.

azure-storage

552,529 установок

microsoft/azure-skills

Скилл для работы с Azure Storage: управление блоб-хранилищем, файловыми ресурсами, очередями и таблицами. Помогает выбирать уровни доступа (hot/cool/cold/archive) и варианты избыточности, а также выполнять операции через CLI или MCP. Полезен для загрузки, скачивания и перечисления объектов в облаке Azure.

entra-app-registration

552,269 установок

microsoft/azure-skills

Скилл помогает регистрировать приложения в Microsoft Entra ID, настраивать OAuth 2.0 и подключать MSAL для аутентификации пользователей и сервисов. Охватывает создание app registration, настройку API-разрешений, клиентских секретов и сертификатов, а также лучшие практики безопасности. Удобен для быстрой настройки аутентификации в веб-, мобильных и фоновых приложениях.

appinsights-instrumentation

552,016 установок

microsoft/azure-skills

Скилл предоставляет руководство по инструментированию веб-приложений с помощью Azure Application Insights: описывает паттерны телеметрии, настройку SDK и конфигурацию. Помогает разработчикам добавлять мониторинг в приложения, а также разграничивает случаи, когда следует использовать azure-prepare для внесения изменений в проект.

azure-resource-lookup

551,937 установок

microsoft/azure-skills

Находит и перечисляет ресурсы Azure любого типа по подпискам и группам ресурсов через Azure Resource Graph. Помогает отвечать на вопросы «что у меня есть», искать ресурсы по тегам, обнаруживать осиротевшие диски и неиспользуемые IP-адреса. Используется, когда нет выделенного MCP-инструмента для нужного типа ресурсов.

azure-resource-visualizer

551,932 установок

microsoft/azure-skills

Анализирует группы ресурсов Azure и создает подробные диаграммы архитектуры в формате Mermaid. Помогает визуализировать взаимосвязи между ресурсами, группировать их по слоям и документировать инфраструктуру. Полезен для понимания структуры облачных решений и создания наглядной документации.

azure-compliance

551,896 установок

microsoft/azure-skills

Проводит аудит безопасности и соответствия Azure: оценивает ресурсы по лучшим практикам, находит неверно настроенные и потерянные ресурсы, а также проверяет ключи, секреты и сертификаты Key Vault на истечение срока действия. Помогает выявлять критические риски и планировать их устранение.

azure-aigateway

551,722 установок

microsoft/azure-skills

Настраивает Azure API Management как AI-шлюз для управления моделями, MCP-инструментами и агентами. Включает семантическое кэширование, лимиты токенов, контроль безопасности, балансировку нагрузки и мониторинг. Помогает централизованно управлять доступом к AI-сервисам и снижать расходы.

azure-messaging

541,378 установок

microsoft/azure-skills

Навык для диагностики и устранения неполадок в Azure Messaging SDK (Event Hubs, Service Bus). Помогает решать проблемы с подключением, аутентификацией, обработкой сообщений и конфигурацией. Использует инструменты MCP для проверки состояния ресурсов, поиска документации и анализа ошибок.

azure-compute

495,407 установок

microsoft/azure-skills

Помогает подбирать, сравнивать и создавать виртуальные машины и масштабируемые наборы в Azure, а также оценивать их стоимость. Разбирается в сценариях резервирования мощности, автомасштабирования и управления машинами, направляя запрос к нужному рабочему процессу.

azure-rbac

486,709 установок

microsoft/azure-skills

Помогает подобрать роль Azure RBAC с минимальными правами для идентичности, сгенерировать команды CLI и код Bicep для её назначения. Также подскажет, какие разрешения нужны, чтобы выдать доступ другому пользователю или сервису.

azure-cloud-migrate

485,404 установок

microsoft/azure-skills

Помогает оценить и перенести существующие облачные нагрузки в Azure: конвертирует код и конфигурацию, формирует отчёт о миграции. Поддерживает переезд AWS Lambda, Elastic Beanstalk, Heroku, Google App Engine, Kubernetes, Cloud Run и Spring Boot в Azure Functions, App Service и Container Apps.

azure-hosted-copilot-sdk

438,545 установок

microsoft/azure-skills

Скилл автоматизирует сборку, развертывание и доработку приложений на GitHub Copilot SDK в Azure: определяет наличие SDK в коде, создаёт инфраструктуру, настраивает модели (включая BYOM) и запускает деплой. Полезен, когда нужно быстро подготовить или модифицировать Copilot-приложение без ручной настройки Azure.

azure-quotas

421,637 установок

microsoft/azure-skills

Помогает проверять и управлять квотами Azure: лимитами ресурсов, текущим использованием и доступной ёмкостью в регионах. Позволяет планировать развёртывание, сравнивать регионы по доступности квот, запрашивать увеличение лимитов и избегать ошибок превышения. Использует Azure CLI для точных данных.

azure-upgrade

413,773 установок

microsoft/azure-skills

Навык для оценки и автоматизации обновления Azure-ресурсов: планов, SKU, тарифов, а также модернизации Azure SDK в коде. Поддерживает сценарии: обновление Azure Functions (Consumption→Flex), миграцию App Service на Container Apps, обновление Java SDK (com.microsoft.azure→com.azure) и миграцию Azure Cache

azure-enterprise-infra-planner

388,208 установок

microsoft/azure-skills

Навык проектирует корпоративную инфраструктуру Azure: сети, безопасность, identity, мультирегиональные сценарии. Генерирует код Bicep или Terraform, проверяет его на соответствие лучшим практикам и безопасность, затем разворачивает с подтверждением. Помогает архитекторам и инженерам быстро создавать надёжные облачные решения.

azure-kubernetes

381,128 установок

microsoft/azure-skills

Навык помогает планировать и создавать кластеры Azure Kubernetes Service (AKS): выбирать SKU, проектировать сеть, настраивать безопасность, наблюдаемость, обновления и оптимизацию затрат. Различает решения Day-0 (сеть, API-сервер) и Day-1 (автомасштабирование, VPA, Spot-пулы), предоставляет чек-листы и сценарии для глубокой настройки.

azure-cost

356,363 установок

microsoft/azure-skills

Навык для управления затратами в Azure: позволяет запрашивать исторические данные о расходах, прогнозировать будущие затраты и получать рекомендации по оптимизации. Помогает анализировать затраты по подпискам, группам ресурсов и другим областям, а также выявлять возможности для сокращения расходов.

airunway-aks-setup

300,339 установок

microsoft/azure-skills

Скилл помогает развернуть AI Runway на кластере AKS: проверяет готовность кластера, устанавливает контроллер, выбирает провайдера инференса и запускает модель. Пошагово проводит от начальной настройки до первого развертывания, с проверкой статуса на каждом этапе.