المهارات Azure Monitor Query SDK for Java
📦

Azure Monitor Query SDK for Java

آمن

使用 Java 查询 Azure Monitor 日志和指标

开发人员需要分析 Azure 资源遥测数据并高效地排查问题。此技能提供使用官方 Azure Monitor Query Java SDK 的 Kusto 查询模式和指标检索方法。

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Azure Monitor Query SDK for Java". 查询工作区中按活动计数排名前 10 的资源组

النتيجة المتوقعة:

控制台输出显示 ResourceGroup 名称及对应的活动计数,按降序排列

استخدام "Azure Monitor Query SDK for Java". 检索 API Management 资源的 SuccessfulCalls 和 TotalCalls 指标

النتيجة المتوقعة:

打印时间序列数据,包含每个时间间隔的时间戳和指标值

استخدام "Azure Monitor Query SDK for Java". 批量查询中有一个查询失败

النتيجة المتوقعة:

显示成功查询的结果;失败查询显示失败消息和错误详情

التدقيق الأمني

آمن
v1 • 2/25/2026

Static analysis scanned 0 files with 0 suspicious patterns detected. Manual review confirms this is a documentation-only skill providing usage guidance for the official Azure Monitor Query Java SDK. All code examples demonstrate legitimate SDK usage with proper credential handling via DefaultAzureCredentialBuilder. No executable code, network calls, or security concerns identified.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

DevOps 工程师排查生产问题

查询 Log Analytics 以调查应用程序错误、追踪请求失败并识别跨 Azure 资源的性能瓶颈。

平台团队构建监控仪表板

使用程序化 SDK 访问提取指标时间序列数据,用于自定义仪表板、警报和容量规划报告。

安全分析师调查安全事件

查询 AzureActivity 日志和安全相关表以检测异常行为并审计访问模式。

جرّب هذه الموجهات

基本日志查询
使用 Azure Monitor Query Java SDK 编写一个 Kusto 查询,从我的 Log Analytics 工作区查找过去 24 小时内的所有错误。
指标聚合
使用 MetricsQueryClient 查询我的 VM 规模集的 CPU 百分比和内存指标,在过去一周内按小时聚合。
批量查询多个工作区
创建一个 Java 示例,在三个不同的 Log Analytics 工作区上运行相同的 Kusto 查询并合并结果。
自定义模型映射与错误处理
展示如何将 LogsQueryResult 映射到自定义 Java 类,并正确处理 PARTIAL_FAILURE 和 HttpResponseException。

أفضل الممارسات

  • 使用批量查询将多个查询合并为单个请求以减少延迟
  • 为长时间运行的查询设置适当的服务器超时,并始终检查查询结果状态以发现部分失败
  • 使用 Kusto 运算符(如 top 或 take)限制结果大小,并仅投影所需的列

تجنب

  • 运行没有时间限制的无界查询,可能超出服务限制或超时
  • 忽略 PARTIAL_FAILURE 状态并假设所有查询结果都是完整的
  • 硬编码工作区 ID 或资源 ID 而不是使用环境变量或配置

الأسئلة المتكررة

此 SDK 使用什么身份验证方法?
SDK 通过 DefaultAzureCredentialBuilder 使用 TokenCredential,支持托管标识、环境凭据、CLI 凭据和其他 Azure 身份验证方法。
为什么此包已弃用?
Microsoft 将功能拆分为两个专注的包:azure-monitor-query-logs 用于 Log Analytics 查询,azure-monitor-query-metrics 用于指标查询。迁移指南可用。
我可以在单个请求中查询多个工作区吗?
可以,使用 LogsQueryOptions 配合 setAdditionalWorkspaces 在跨工作区查询中包含最多 10 个工作区。
如何处理大型结果集?
使用 Kusto 查询运算符(如 take、top 或 limit)限制行数。对于非常大的数据集,考虑使用分页模式并在适当时缓存结果。
这支持 Azure 主权云吗?
是的,使用 builder endpoint 方法配置自定义端点,以支持 Azure 中国云或其他主权云环境。
LogsQueryClient 和 LogsQueryAsyncClient 有什么区别?
LogsQueryClient 提供阻塞同步调用,适用于简单脚本。LogsQueryAsyncClient 返回响应式类型,用于高吞吐量应用程序中的非阻塞操作。

تفاصيل المطور

بنية الملفات

📄 SKILL.md