المهارات Azure Monitor Ingestion SDK for Python
📦

Azure Monitor Ingestion SDK for Python

آمن

向 Azure Monitor 发送自定义日志

此技能使 Claude Code 能够使用官方日志摄取 API 将自定义应用程序日志发送到 Azure Monitor Log Analytics 工作区。它提供了将 Azure 监控集成到 Python 应用程序的代码示例和最佳实践。

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "Azure Monitor Ingestion SDK for Python". 如何将日志上传到 Azure Monitor?

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

要上传日志到 Azure Monitor,请使用您的数据收集端点创建 LogsIngestionClient,并使用 DefaultAzureCredential 进行身份验证。然后使用您的规则 ID、流名称和日志数据数组调用 client.upload()。

استخدام "Azure Monitor Ingestion SDK for Python". 支持哪些身份验证方法?

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

SDK 支持 Azure Identity 库,包括 DefaultAzureCredential、ManagedIdentityCredential 和 ServicePrincipalCredential。DefaultAzureCredential 自动尝试多种身份验证方法,包括托管标识、环境变量和交互式登录。

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

آمن
v1 • 2/25/2026

This is a prompt-only skill containing only documentation (SKILL.md). No executable code was scanned. The skill provides reference documentation for the Microsoft Azure Monitor Ingestion SDK for Python. No security risks identified.

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

درجة الجودة

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

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

应用程序性能监控

将 Python 服务的应用程序日志、指标和跟踪数据发送到 Azure Monitor 进行集中日志记录和分析。

安全审计日志记录

将安全事件、身份验证日志和合规性数据摄取到 Log Analytics 以进行安全监控和威胁检测。

业务分析集成

将 Python 应用程序的业务指标和运营数据推送到 Log Analytics 以进行自定义报告和仪表板展示。

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

基本日志上传
向我展示如何使用 Azure Monitor 摄取 SDK 将自定义日志上传到 Log Analytics 工作区。包括使用 DefaultAzureCredential 的客户端设置。
错误处理
如何处理向 Azure Monitor 发送日志时的部分上传失败?展示一个带有错误回调和重试逻辑的示例。
异步摄取
编写一个使用异步 LogsIngestionClient 在高吞吐量 Python 应用程序中上传日志的示例。
主权云配置
如何为 Azure Government 云而不是公共 Azure 配置 Azure Monitor 摄取客户端?

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

  • 始终在日志条目中包含 TimeGenerated 字段 - 这是 Azure Monitor 必需的
  • 使用 on_error 回调来处理部分失败,并为失败的日志实现重试逻辑
  • 将您的日志架构与数据收集规则列定义匹配,以确保正确摄取

تجنب

  • 不要在应用程序代码中硬编码凭据 - 请使用 Azure Identity
  • 不要跳过错误处理 - 网络失败和部分上传在日志摄取中很常见
  • 不要发送不符合 DCR 架构的日志 - 不匹配的数据将被拒绝

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

Azure Monitor 中的 DCE 和 DCR 有什么区别?
数据收集端点 (DCE) 是发送日志的摄取 URL。数据收集规则 (DCR) 定义了日志的架构、转换和目标表。
我需要先创建 Log Analytics 表吗?
对于自定义表,当 DCR 处理其首次摄取时,表会自动创建。内置表必须在发送数据之前存在。
SDK 如何处理大量日志?
SDK 会自动将日志分批为 1MB 块,使用 gzip 压缩,并并行上传。您不需要手动实现批处理。
我可以将此 SDK 与 Azure Government 一起使用吗?
是的,使用 AzureAuthorityHosts 为 Azure Government 或其他主权云配置 authority 和 credential_scopes。
如果某些日志上传失败会怎样?
SDK 提供了一个 on_error 回调,用于接收失败的日志条目。您可以实现重试逻辑来重新发送这些日志。
是否支持异步?
是的,使用 azure.monitor.ingestion.aio 中的 LogsIngestionClient 配合 async/await 模式来处理高吞吐量场景。

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

بنية الملفات

📄 SKILL.md