用途:通过 Python 查询 Azure Monitor 与 Log Analytics 工作区的日志和指标数据。
安装:pip install azure-monitor-query
环境变量:日志查询需 AZURE_LOG_ANALYTICS_WORKSPACE_ID;指标查询需 AZURE_METRICS_RESOURCE_URI。认证使用 azure.identity 的 DefaultAzureCredential。
主要能力:LogsQueryClient 查询工作区日志,支持相对时间(timedelta)与绝对时间范围、批量查询(LogsBatchQuery)、部分结果状态处理(LogsQueryStatus.PARTIAL/FAILURE),结果可转为 pandas DataFrame。MetricsQueryClient 查询资源指标,支持指定 metric_names、granularity、聚合类型(AVERAGE/MAXIMUM/MINIMUM/COUNT)、按维度 filter,并可列出指标定义与命名空间。提供 aio 异步客户端。
使用方式:创建客户端后调用 query_workspace 或 query_resource,遍历返回的 tables/rows 或 metrics/timeseries/data 获取数据。
适用场景:日志分析、指标监控、Kusto 查询(如按状态码统计请求、异常趋势、慢请求、Top 错误)。
限制:仅在任务明确匹配上述范围时使用;输出不能替代环境相关的验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。具体收费与平台细节暂未提供。