将外部监视解决方案与 Azure Stack Hub 集成

2025-10-29

若要对 Azure Stack Hub 基础结构进行外部监视，需要监视 Azure Stack Hub 软件、物理计算机和物理网络交换机。这些区域中的每一个都提供了一种方法来获取健康状况和警报信息。

Azure Stack Hub 软件提供基于 REST 的 API 来检索运行状况和警报。使用软件定义的技术（如存储空间直通、存储运行状况和警报）是软件监视的一部分。
物理计算机可以通过基板管理控制器（BMC）提供运行状况和警报信息。
物理网络设备可以通过 SNMP 协议提供运行状况和警报信息。

每个 Azure Stack Hub 解决方案附带硬件生命周期主机。此主机针对物理服务器和网络设备运行原始设备制造商（OEM）硬件供应商的监视软件。请咨询 OEM 提供商，了解其监视解决方案是否可以与数据中心中的现有监视解决方案集成。

重要

你使用的外部监视解决方案必须是无代理的。无法在 Azure Stack Hub 组件中安装第三方代理。

下图显示了 Azure Stack Hub 集成系统、硬件生命周期主机、外部监视解决方案和外部票证/数据收集系统之间的流量流。

显示 Azure Stack Hub、监视与票证解决方案之间的流量的示意图。

注释

访问控制列表（ACL）不允许直接与物理服务器进行外部监控集成，并会主动阻止这种行为。支持直接与物理网络设备进行外部监视集成。请与 OEM 提供商联系，了解如何启用此功能。

本文介绍如何将 Azure Stack Hub 与外部监视解决方案（例如 System Center Operations Manager 和 Nagios）集成。此外，还介绍如何使用 PowerShell 或 REST API 调用以编程方式处理警报。

与 Operations Manager 集成

可以使用 Operations Manager 对 Azure Stack Hub 进行外部监视。使用适用于 Azure Stack Hub 的 System Center 管理包，可以使用单个 Operations Manager 实例监视多个 Azure Stack Hub 部署。管理包使用健康资源提供程序和更新资源提供程序 REST API 来与 Azure Stack Hub 通信。如果计划绕过硬件生命周期主机上运行的 OEM 监视软件，可以安装供应商管理包来监视物理服务器。还可以使用 Operations Manager 网络设备发现来监视网络交换机。

Azure Stack Hub 的管理包提供以下功能：

可以管理多个 Azure Stack Hub 部署。
支持Microsoft Entra ID 和 Active Directory 联合身份验证服务（AD FS）。
可以检索和关闭警报。
有运行状况和容量仪表板。
正在修补和更新 (P&U) 时可以执行自动维护模式检测。
包括针对部署和区域的强制更新任务。
可以将自定义信息添加到区域。
支持通知功能和报告功能。

若要下载 System Center 管理包和关联的用户指南，请参阅下载适用于 Azure Stack Hub 的 System Center 管理包。

对于票证解决方案，可以将 Operations Manager 与 System Center Service Manager 集成。集成产品连接器支持双向通信，可在解决 Service Manager 中的服务请求后关闭 Azure Stack Hub 和 Operations Manager 中的警报。

下图显示了 Azure Stack Hub 与现有 System Center 部署的集成。可以使用 System Center Orchestrator 或 Service Management Automation（SMA）进一步自动化服务管理器，以在 Azure Stack Hub 中运行操作。

演示与 OM、Service Manager 和 SMA 集成的示意图。

与 Nagios 集成

可以设置和配置用于 Azure Stack Hub 的 Nagios 插件。

Nagios 监视插件是与合作伙伴 Cloudbase 解决方案一起开发的，根据 MIT（麻省理工学院）的宽松免费软件许可条款提供。

该插件以 Python 编写，利用运行状况资源提供程序 REST API。它提供在 Azure Stack Hub 中检索和关闭警报的基本功能。与 System Center 管理包一样，它可以让你添加多个 Azure Stack Hub 部署以及发送通知。

在版本 1.2 中，Azure Stack Hub - Nagios 插件利用 Microsoft ADAL 库，支持使用服务主体通过机密或证书进行身份验证。此外，配置过程已通过单个配置文件与新的参数进行简化。它现在支持使用 Microsoft Entra ID 和 AD FS 作为标识系统来部署 Azure Stack Hub。

重要

AD FS 仅支持交互式登录会话。如果需要对自动化场景进行非交互式登录，则必须使用 SPN。

该插件适用于 Nagios 4x 和 XI。若要下载该插件，请参阅监视 Azure Stack Hub 警报。下载站点还包含安装和配置详细信息。

Nagios 的要求

Nagios 的最低版本是 4.x
Microsoft Entra Python 库。可以使用 Python PIP 安装该库。
```
sudo pip install adal pyyaml six
```

安装插件

本部分介绍如何安装采用 Nagios 默认安装的 Azure Stack Hub 插件。

插件包包含以下文件：

azurestack_plugin.py
azurestack_handler.sh
samples/etc/azurestack.cfg
samples/etc/azurestack_commands.cfg
samples/etc/azurestack_contacts.cfg
samples/etc/azurestack_hosts.cfg
samples/etc/azurestack_services.cfg

将插件 azurestack_plugin.py 复制到以下目录：/usr/local/nagios/libexec。
将处理程序 azurestack_handler.sh 复制到以下目录：/usr/local/nagios/libexec/eventhandlers。

确保将插件文件设置为可执行文件：

sudo cp azurestack_plugin.py <PLUGINS_DIR>
sudo chmod +x <PLUGINS_DIR>/azurestack_plugin.py

配置插件

可在 azurestack.cfg 文件中配置以下参数。无论选择哪种身份验证模型，都需要配置以粗体显示的参数。

有关如何创建 SPN 的详细信息，请参阅使用应用标识来访问资源。

参数	DESCRIPTION	身份验证
External_domain_fqdn	外部域 FQDN
地区：	区域名称
tenant_id：	租户 ID*
client_id：	客户 ID	包含机密的 SPN
client_secret：	客户端密码	包含机密的 SPN
client_cert**：	证书的路径	包含证书的 SPN
client_cert_thumbprint**：	证书指纹	包含证书的 SPN

*使用 AD FS 的 Azure Stack Hub 部署不需要租户 ID。

** 客户端机密和客户端证书互斥。

其他配置文件包含可选的配置设置，也可以在 Nagios 中配置这些设置。

注释

检查 azurestack_hosts.cfg 和 azurestack_services.cfg 中的位置目标。

配置	DESCRIPTION
azurestack_commands.cfg	处理程序配置没有更改要求
azurestack_contacts.cfg	通知设置
azurestack_hosts.cfg	Azure Stack Hub 部署命名
azurestack_services.cfg	服务的配置

设置步骤

修改配置文件。
将修改后的配置文件复制到以下文件夹：/usr/local/nagios/etc/objects。

更新 Nagios 配置

需要更新 Nagios 配置才能确保加载 Azure Stack Hub - Nagios 插件。

打开以下文件：
```
/usr/local/nagios/etc/nagios.cfg
```

添加以下项：

# Load the Azure Stack Hub Plugin Configuration
cfg_file=/usr/local/Nagios/etc/objects/azurestack_contacts.cfg
cfg_file=/usr/local/Nagios/etc/objects/azurestack_commands.cfg
cfg_file=/usr/local/Nagios/etc/objects/azurestack_hosts.cfg
cfg_file=/usr/local/Nagios/etc/objects/azurestack_services.cfg

重新加载 Nagios。
```
sudo service nagios reload
```

手动关闭活动的警报

可以使用自定义通知功能在 Nagios 内部关闭活动的警报。自定义通知必须是：

/close-alert <ALERT_GUID>

还可以运行以下命令使用终端关闭警报：

/usr/local/nagios/libexec/azurestack_plugin.py --config-file /usr/local/nagios/etc/objects/azurestack.cfg --action Close --alert-id <ALERT_GUID>

故障排除

通过在终端中手动调用插件，对插件进行故障排除。使用以下方法：

/usr/local/nagios/libexec/azurestack_plugin.py --config-file /usr/local/nagios/etc/objects/azurestack.cfg --action Monitor

使用 PowerShell 监视运行状况和警报

如果不使用 Operations Manager、Nagios 或基于 Nagios 的解决方案，可以使用 PowerShell 来启用广泛的监视解决方案，以便与 Azure Stack Hub 集成。

Az 模块
AzureRM 模块

若要使用 PowerShell，请确保已针对 Azure Stack Hub 操作员环境安装并配置 PowerShell。在可以访问资源管理器（管理员）终结点 (https://adminmanagement.[region].[External_FQDN]) 的本地计算机上安装 PowerShell。

以 Azure Stack Hub 操作员身份运行以下命令，以连接到 Azure Stack Hub 环境：

Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint https://adminmanagement.[Region].[External_FQDN] `
   -AzureKeyVaultDnsSuffix adminvault.[Region].[External_FQDN] `
   -AzureKeyVaultServiceEndpointResourceId https://adminvault.[Region].[External_FQDN]

Connect-AzAccount -EnvironmentName "AzureStackAdmin"

使用如下所示的命令来处理警报：

# Retrieve all alerts
$Alerts = Get-AzsAlert
$Alerts

# Filter for active alerts
$Active = $Alerts | Where-Object { $_.State -eq "active" }
$Active

# Close alert
Close-AzsAlert -AlertID "ID"

#Retrieve resource provider health
$RPHealth = Get-AzsRPHealth
$RPHealth

# Retrieve infrastructure role instance health
$FRPID = $RPHealth | Where-Object { $_.DisplayName -eq "Capacity" }
   Get-AzsRegistrationHealth -ServiceRegistrationId $FRPID.RegistrationId

若要使用 PowerShell，请确保已针对 Azure Stack Hub 操作员环境安装并配置 PowerShell。在可以访问资源管理器（管理员）终结点 (https://adminmanagement.[region].[External_FQDN]) 的本地计算机上安装 PowerShell。