容器 Azure Monitor 为 Azure Kubernetes 服务提供丰富的监视体验 (AKS) 和 AKS Engine 群集。 本文介绍如何使用 Azure Arc 启用对 Azure 外部托管的 Kubernetes 群集的监视,以实现类似的监视体验。
可以使用 PowerShell 或 Bash 脚本为 Kubernetes 的一个或多个现有部署启用容器 Azure Monitor。
支持的配置
容器 Azure Monitor 支持监视启用了 Azure Arc 的 Kubernetes (预览版) 如 概述 文章中所述,以下功能除外:
- 实时数据 (预览)
以下内容是针对容器 Azure Monitor 正式支持的:
-
Kubernetes 和支持策略的版本与 AKS 支持的版本相同。
-
支持以下容器运行时:Docker、Moby 和 CRI 兼容的运行时,例如 CRI-O 和 ContainerD。
-
支持的主节点和辅助节点的 Linux OS 版本为: Ubuntu (18.04 LTS 和 16.04 LTS) 。
先决条件
在开始之前,请确保做好以下准备:
-
Log Analytics 工作区。
用于容器的 Azure Monitor 支持在 Azure 产品(按区域) 中列出的区域中的 Log Analytics 工作区。 若要创建你自己的工作区,可通过 Azure 资源管理器、PowerShell 或 Azure 门户进行创建。
-
若要启用和访问容器 Azure Monitor 中的功能,至少需要是 Azure 订阅中的 Azure 参与者 角色的成员,以及配置了 Azure Monitor for 容器的 Log Analytics 工作区的 Log Analytics 参与者 角色的成员。
-
你是 Azure Arc 群集资源中 " 参与者 " 角色的成员。
-
若要查看监视数据,你是使用为容器 Azure Monitor 配置的 Log Analytics 工作区的 " Log Analytics 读取 者角色" 权限的成员。
-
HELM 客户端,用于为指定的 Kubernetes 群集载入适用于容器的 Azure Monitor 图表。
-
适用于 Linux 的 Log Analytics 代理的容器化版本与 Azure Monitor 进行通信需要以下代理和防火墙配置信息:
代理资源 端口 *.ods.opinsights.azure.com端口 443 *.oms.opinsights.azure.com端口 443 *.dc.services.visualstudio.com端口 443 -
容器化代理要求在群集的所有节点上打开 Kubelet 的
cAdvisor secure port: 10250或unsecure port :10255以收集性能指标。 建议你在 Kubelet 的 cAdvisor 上配置secure port: 10250(如果尚未配置)。 -
容器化代理要求在容器上指定以下环境变量,以便与群集中的 Kubernetes API 服务通信以收集清单数据 -
KUBERNETES_SERVICE_HOST和KUBERNETES_PORT_443_TCP_PORT。IMPORTANT 支持启用 Arc 的 Kubernetes 群集支持的最低代理版本为 ciprod04162020 或更高版本。
-
如果你使用 PowerShell 脚本方法启用监视,则需要Powershell Core 。
-
如果使用 Bash 脚本方法启用监视,则需要bash 版本 4 。
标识工作区资源 ID
若要使用之前下载并与现有 Log Analytics 工作区集成的 PowerShell 或 bash 脚本来启用群集监视,请执行以下步骤以首先确定 Log Analytics 工作区的完整资源 ID。 workspaceResourceId当你运行命令对指定的工作区启用监视外接程序时,此参数是必需的。 如果没有要指定的工作区,则可以跳过包括 workspaceResourceId 参数,并让脚本为你创建新的工作区。
-
使用以下命令列出你有权访问的所有订阅:
az account list --all -o table输出如下所示:
Name CloudName SubscriptionId State IsDefault ------------------------------------ ----------- ------------------------------------ ------- ----------- Microsoft Azure AzureCloud 0fb60ef2-03cc-4290-b595-e71108e8f4ce Enabled True复制 SubscriptionId 的值。
-
使用以下命令切换到托管 Log Analytics 工作区的订阅:
az account set -s <subscriptionId of the workspace> -
以下示例以默认 JSON 格式显示订阅中的工作区列表。
az resource list --resource-type Microsoft.OperationalInsights/workspaces -o json在输出中,找到工作区名称,然后在字段 ID 下复制该 Log Analytics 工作区的完整资源 ID。
使用 PowerShell 启用监视
-
使用以下命令将脚本下载并保存到使用监视外接程序配置群集的本地文件夹:
Invoke-WebRequest https://aka.ms/enable-monitoring-powershell-script -OutFile enable-monitoring.ps1 -
$azureArcClusterResourceId通过设置的相应值来配置变量subscriptionId,resourceGroupName并clusterName表示启用了 Azure Arc 的 Kubernetes 群集资源的资源 ID。$azureArcClusterResourceId = "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Kubernetes/connectedClusters/<clusterName>" -
$kubeContext通过运行命令,配置具有群集的 kube 上下文 的变量kubectl config get-contexts。 如果要使用当前上下文,请将值设置为""。$kubeContext = "<kubeContext name of your k8s cluster>" -
如果要使用现有 Azure Monitor Log Analytics 工作区,请
$logAnalyticsWorkspaceResourceId使用表示工作区资源 ID 的相应值配置变量。 否则,将变量设置为,""并且如果区域中尚不存在默认工作区,该脚本将在群集订阅的默认资源组中创建一个默认工作区。 创建的默认工作区类似于 DefaultWorkspace-<SubscriptionID>-<Region> 格式。$logAnalyticsWorkspaceResourceId = "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/microsoft.operationalinsights/workspaces/<workspaceName>" -
如果启用了 Arc 的 Kubernetes 群集通过代理服务器通信,请
$proxyEndpoint使用代理服务器的 URL 来配置该变量。 如果群集未通过代理服务器进行通信,则可以将值设置为""。 有关详细信息,请参阅本文稍后的配置代理终结点。 -
运行以下命令以启用监视。
.\enable-monitoring.ps1 -clusterResourceId $azureArcClusterResourceId -kubeContext $kubeContext -workspaceResourceId $logAnalyticsWorkspaceResourceId -proxyEndpoint $proxyEndpoint
启用监视后,可能需要约 15 分钟才能查看群集的运行状况指标。
使用服务主体
脚本 enable-monitoring.ps1 使用交互式设备登录。 如果你更喜欢非交互式登录,则可以使用现有的服务主体,也可以创建一个具有所需权限的新服务主体,如 先决条件中所述。 若要使用服务主体,你必须将 $servicePrincipalClientId、$servicePrincipalClientSecret 和 $tenantId 参数替换为你打算用于 enable-monitoring.ps1 脚本的服务主体的值。
$subscriptionId = "<subscription Id of the Azure Arc connected cluster resource>"
$servicePrincipal = New-AzADServicePrincipal -Role Contributor -Scope "/subscriptions/$subscriptionId"
下面的角色分配仅适用于使用与 K8s 连接的群集资源不同的 Azure 订阅中的现有 Log Analytics 工作区的情况。
$logAnalyticsWorkspaceResourceId = "<Azure Resource Id of the Log Analytics Workspace>" # format of the Azure Log Analytics workspace should be /subscriptions/<subId>/resourcegroups/<rgName>/providers/microsoft.operationalinsights/workspaces/<workspaceName>
New-AzRoleAssignment -RoleDefinitionName 'Log Analytics Contributor' -ObjectId $servicePrincipal.Id -Scope $logAnalyticsWorkspaceResourceId
$servicePrincipalClientId = $servicePrincipal.ApplicationId.ToString()
$servicePrincipalClientSecret = [System.Net.NetworkCredential]::new("", $servicePrincipal.Secret).Password
$tenantId = (Get-AzSubscription -SubscriptionId $subscriptionId).TenantId
例如:
.\enable-monitoring.ps1 -clusterResourceId $azureArcClusterResourceId -servicePrincipalClientId $servicePrincipalClientId -servicePrincipalClientSecret $servicePrincipalClientSecret -tenantId $tenantId -kubeContext $kubeContext -workspaceResourceId $logAnalyticsWorkspaceResourceId -proxyEndpoint $proxyEndpoint
启用使用 bash 脚本
执行以下步骤以使用提供的 bash 脚本启用监视。
-
使用以下命令将脚本下载并保存到使用监视外接程序配置群集的本地文件夹:
curl -o enable-monitoring.sh -L https://aka.ms/enable-monitoring-bash-script -
azureArcClusterResourceId通过设置的相应值来配置变量subscriptionId,resourceGroupName并clusterName表示启用了 Azure Arc 的 Kubernetes 群集资源的资源 ID。export azureArcClusterResourceId="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Kubernetes/connectedClusters/<clusterName>" -
kubeContext通过运行命令,配置具有群集的 kube 上下文 的变量kubectl config get-contexts。 如果要使用当前上下文,请将值设置为""。export kubeContext="<kubeContext name of your k8s cluster>" -
如果要使用现有 Azure Monitor Log Analytics 工作区,请
logAnalyticsWorkspaceResourceId使用表示工作区资源 ID 的相应值配置变量。 否则,将变量设置为,""并且如果区域中尚不存在默认工作区,该脚本将在群集订阅的默认资源组中创建一个默认工作区。 创建的默认工作区类似于 DefaultWorkspace-<SubscriptionID>-<Region> 格式。export logAnalyticsWorkspaceResourceId="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/microsoft.operationalinsights/workspaces/<workspaceName>" -
如果启用了 Arc 的 Kubernetes 群集通过代理服务器通信,请
proxyEndpoint使用代理服务器的 URL 来配置该变量。 如果群集未通过代理服务器进行通信,则可以将值设置为""。 有关详细信息,请参阅本文稍后的配置代理终结点。 -
若要在群集上启用监视,可以根据部署方案提供不同的命令。
运行以下命令以使用默认选项启用监视,如使用当前 kube、创建默认 Log Analytics 工作区,而不指定代理服务器:
bash enable-monitoring.sh --resource-id $azureArcClusterResourceId运行以下命令以创建默认 Log Analytics 工作区,而不指定代理服务器:
bash enable-monitoring.sh --resource-id $azureArcClusterResourceId --kube-context $kubeContext运行以下命令以使用现有 Log Analytics 工作区,而不指定代理服务器:
bash enable-monitoring.sh --resource-id $azureArcClusterResourceId --kube-context $kubeContext --workspace-id $logAnalyticsWorkspaceResourceId运行以下命令以使用现有 Log Analytics 工作区并指定代理服务器:
bash enable-monitoring.sh --resource-id $azureArcClusterResourceId --kube-context $kubeContext --workspace-id $logAnalyticsWorkspaceResourceId --proxy $proxyEndpoint
启用监视后,可能需要约 15 分钟才能查看群集的运行状况指标。
使用服务主体
Bash 脚本 enable-monitoring.sh 使用交互式设备登录。 如果你更喜欢非交互式登录,则可以使用现有的服务主体,也可以创建一个具有所需权限的新服务主体,如 先决条件中所述。 若要使用服务主体,你必须将你打算用于 enable-monitoring.sh bash 脚本的服务主体的客户端 id、--客户端密码和--租户 id 值传递给。
subscriptionId="<subscription Id of the Azure Arc connected cluster resource>"
servicePrincipal=$(az ad sp create-for-rbac --role="Contributor" --scopes="/subscriptions/${subscriptionId}")
servicePrincipalClientId=$(echo $servicePrincipal | jq -r '.appId')
下面的角色分配仅适用于使用与 K8s 连接的群集资源不同的 Azure 订阅中的现有 Log Analytics 工作区的情况。
logAnalyticsWorkspaceResourceId="<Azure Resource Id of the Log Analytics Workspace>" # format of the Azure Log Analytics workspace should be /subscriptions/<subId>/resourcegroups/<rgName>/providers/microsoft.operationalinsights/workspaces/<workspaceName>
az role assignment create --role 'Log Analytics Contributor' --assignee $servicePrincipalClientId --scope $logAnalyticsWorkspaceResourceId
servicePrincipalClientSecret=$(echo $servicePrincipal | jq -r '.password')
tenantId=$(echo $servicePrincipal | jq -r '.tenant')
例如:
bash enable-monitoring.sh --resource-id $azureArcClusterResourceId --client-id $servicePrincipalClientId --client-secret $servicePrincipalClientSecret --tenant-id $tenantId --kube-context $kubeContext --workspace-id $logAnalyticsWorkspaceResourceId --proxy $proxyEndpoint
配置代理终结点
对于容器 Azure Monitor 容器化代理,你可以配置代理终结点,使其能够通过代理服务器进行通信。 容器化代理和 Azure Monitor 之间的通信可以是 HTTP 或 HTTPS 代理服务器,并且支持匿名身份验证和基本身份验证 (用户名/密码) 。
代理配置值具有以下语法:[protocol://][user:password@]proxyhost[:port]
Note: 如果代理服务器不需要身份验证,那么你仍需指定伪用户名/密码。 这可以是任何用户名或密码。
| 属性 | 说明 |
|---|---|
| 协议 | http 或 https |
| user | 用于代理身份验证的可选用户名 |
| password | 用于代理身份验证的可选密码 |
| proxyhost | 代理服务器的地址或 FQDN |
| port | 代理服务器的可选端口号 |
例如: http://user01:password@proxy01.contoso.com:3128
如果将协议指定为“http”,则使用 SSL/TLS 安全连接创建 HTTP 请求。 代理服务器必须支持 SSL/TLS 协议。
使用 PowerShell 进行配置
指定代理服务器的用户名和密码、IP 地址或 FQDN 以及端口号。 例如:
$proxyEndpoint = https://<user>:<password>@<proxyhost>:<port>
使用 bash 进行配置
指定代理服务器的用户名和密码、IP 地址或 FQDN 以及端口号。 例如:
export proxyEndpoint=https://<user>:<password>@<proxyhost>:<port>
后续步骤
-
启用监视功能以收集启用了 Arc 的 Kubernetes 群集的运行状况和资源使用情况,并了解 如何使用 容器 Azure Monitor。
-
默认情况下,容器化代理收集所有命名空间(kube 除外)中运行的所有容器的 stdout/stderr 容器日志。 若要配置特定于特定命名空间或命名空间的容器日志集合,请查看 Container Insights 代理配置 ,将所需的数据收集设置配置为 ConfigMap 配置文件。
-
若要从群集中擦除和分析 Prometheus 指标,请查看 配置 Prometheus 指标抓取
-
若要了解如何停止监视启用了 Arc 的 Kubernetes 群集与 Azure Monitor 的容器,请参阅 如何停止监视混合群集。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
