Azure Local离线模式：按需日志收集（On-Demand Logs）

来源：Collect Logs On-Demand with Azure Local Disconnected Operations

1. 适用场景

官方原文："On-demand log collection involves manually gathering and sending diagnostic logs to Microsoft. These logs are stored in an Azure Data Explorer database that Microsoft Support can access to help investigate and resolve your reported issues. The collected diagnostic data is retained for up to 30 days."

当 appliance 能工作、但有服务异常：用 on-demand 直接传日志给 Microsoft
当 appliance 完全 down ：用 fallback 方法（mount VHD 取日志）

⚠️ 官方原文 Important ："Before you use on-demand direct log collection, complete the prerequisites and set up observability with the Set-ApplianceObservabilityConfiguration cmdlet. If you skip these steps, you might see an error."

2. 前置条件

项	说明
已部署断开操作	<deploy-appliance.md>
已配置 observability	见 §3
磁盘空间	普通日志 ≥ 25 GB 空闲；appliance 大包可压缩后 >25 GB ；预留压缩后体积 2 倍（10GB 压缩 → 至少 20GB 空闲；25GB → 至少 50GB）

建议分批上传，避免一次性占满磁盘。

3. 设置 Observability（首次部署时建议做）

官方原文："We recommend that you set up observability to get telemetry and logs for your first deployment. This allows Azure Local Disconnected to connect to Azure through Arc registration and use a managed identity to upload logs, metrics, and telemetry from the appliance VM."

⚠️ 完全 Air-gapped 模式不需要此步------observability 本身需要出站。

3.1 准备的参数

参数	说明
Azure resource group	资源组名，例 `azure-disconnectedoperations`
SPN	有 `Azure Connected Machine Resource Administrator` 权限
SPN credentials	appId + password
Subscription	Azure 订阅 ID
Tenant ID
Azure region
资源提供方	注册以下 RP：Microsoft.Compute、Microsoft.AzureArcData（可选）、Microsoft.HybridConnectivity、Microsoft.GuestConfiguration、Microsoft.HybridCompute

3.2 配置步骤

复制代码

# 1. 登录
az login

# 2. 建 RG
az group create -g <ResourceGroupName> -l <AzureRegion>

# 3. 列云
az cloud list -o table

# 4. 取订阅/租户
az account show

# 5. 建 SPN
az ad sp create-for-rbac `
    --name "<SPNName>" `
    --role "Azure Connected Machine Resource Administrator" `
    --scopes /subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>
# → 输出 appId + password

# 6. 设置 Observability（用上一步的 appId / password）
$observabilityConfiguration = New-ApplianceObservabilityConfiguration `
    -ResourceGroupName "azure-disconnectedoperations" `
    -TenantId "<TenantID>" `
    -Location "<Location>" `
    -SubscriptionId "<SubscriptionId>" `
    -ServicePrincipalId "<AppId>" `
    -ServicePrincipalSecret ("<Password>" | ConvertTo-SecureString -AsPlainText -Force)

Set-ApplianceObservabilityConfiguration -ObservabilityConfiguration $observabilityConfiguration

# 7. 验证
Get-ApplianceObservabilityConfiguration

也可以在 bootstrap 阶段通过 Install-Appliance -ObservabilityConfiguration $observabilityConfiguration 一起传，省一次调用。

4. 工作流

Prerequisites（§2）
选日志收集方法（基于连通场景）
收集日志
监控进度
本地查看或送给 Microsoft

4.1 Supported scenarios（官方表格摘要）

场景	收集方式
设备能连 Azure	On-demand direct（直传 Microsoft）
设备无法连 Azure（air-gapped）	Fallback ------ mount VHD 取日志

文档后续步骤（cmdlet 用法、参数详解）因抓取截断未完整显示，按 OperationsModule Get-Help 即可。

5. "官方没明说"的事项

"30 天保留"------是 Microsoft 端的数据保留，本地日志保留周期没说
"Microsoft Support can access"------没说"P1/P2/P3 哪种 ticket 才能访问"
"分批上传"------没说"单批多大合适"
文档没说"上传速度限制"
完全 air-gapped 模式必须走 fallback 路径------但 fallback 也没说"能不能自动 push 到 Microsoft"，应该是手工出网