本页面介绍了如何为 Google Distributed Cloud 集群创建提醒政策。
准备工作
您必须拥有以下权限才能创建提醒政策:
monitoring.alertPolicies.create
monitoring.alertPolicies.delete
monitoring.alertPolicies.update
如果您具有以下任何角色,则表示具备这些权限:
monitoring.alertPolicyEditor
monitoring.editor
- Project Editor
- 项目所有者
如需使用 Google Cloud CLI 创建基于日志的提醒政策,您还必须具有 serviceusage.serviceUsageConsumer
角色。
如需查看您的角色,请转到 Google Cloud Console 中的 IAM 页面。
创建示例政策:API 服务器不可用
在本练习中,您将为 Kubernetes API 服务器创建提醒政策。实施此政策后,您可以安排在集群的 API 服务器不可用时接收通知。
下载政策配置文件:apiserver-unavailable.json。
创建政策:
gcloud alpha monitoring policies create --policy-from-file=POLICY_CONFIG
将 POLICY_CONFIG 替换为您刚刚下载的配置文件的路径。
查看您的提醒政策:
控制台
在 Google Cloud 控制台中,转到 Monitoring 页面。
选择左侧的提醒。
在政策下方,您可以看到提醒政策的列表。
在列表中,选择 Anthos cluster API server unavailable (critical) 以查看新政策的详细信息。在条件下,您可以查看政策的说明。例如:
Policy violates when ANY condition is met Anthos cluster API server uptime is absent for 5m
gcloud
gcloud alpha monitoring policies list
输出会显示有关政策的详细信息。例如:
combiner: OR conditions: - conditionAbsent: aggregations: - alignmentPeriod: 60s crossSeriesReducer: REDUCE_MEAN groupByFields: - resource.label.project_id - resource.label.location - resource.label.cluster_name - resource.label.namespace_name - resource.label.container_name - resource.label.pod_name perSeriesAligner: ALIGN_MAX duration: 300s filter: resource.type = "k8s_container" AND metric.type = "kubernetes.io/anthos/container/uptime" AND resource.label."container_name"=monitoring.regex.full_match("kube-apiserver") trigger: count: 1 displayName: Anthos cluster API server uptime is absent for 5m name: projects/…/alertPolicies/…/conditions/… displayName: Anthos cluster API server unavailable (critical) enabled: true mutationRecord: mutateTime: … mutatedBy: … name: projects/…/alertPolicies/…
创建其他提醒政策
本部分针对一组建议的提醒政策提供了说明和配置文件。
要创建政策,请按照您在之前的练习中所用的步骤操作:
点击右列中的链接以下载配置文件。
(可选)调整条件以更好地满足您的特定需求,例如,您可以为部分集群添加其他过滤条件,或调整阈值以在噪声和重要性之间取得平衡。
运行
gcloud alpha monitoring policies create
以创建政策。
控制平面组件可用性
提醒名称 | 说明 | Cloud Monitoring 中的提醒政策定义 |
---|---|---|
API 服务器不可用(严重) | API 服务器正常运行时间指标不可用 | apiserver-unavailable.json |
调度器不可用(严重) | 调度器正常运行时间指标不可用 | scheduler-unavailable.json |
控制器管理器不可用(严重) | 控制器管理器正常运行时间指标不可用 | controller-manager-unavailable.json |
Kubernetes 系统
提醒名称 | 说明 | Cloud Monitoring 中的提醒政策定义 |
---|---|---|
Pod 崩溃循环(警告) | Pod 不断重启且可能处于崩溃循环状态 | pod-crash-looping.json |
Pod 处于尚未就绪状态超过一小时(严重) | Pod 处于尚未就绪状态超过一小时 | pod-not-ready-1h.json |
容器 CPU 用量超过 80%(警告) | 容器 CPU 使用率超过限制 80% | container-cpu-usage-high-reaching-limit.json |
容器内存用量超过 85%(警告) | 容器内存用量超过上限的 85% | container-memory-usage-high-reaching-limit.json |
永久性卷用量高(严重) | 已声明的永久性卷的可用空间不足 3% | persistent-volume-usage-high.json |
节点 CPU 用量超过 80%(警告) | 节点 CPU 使用率在 5 分钟内超过总可分配量的 80% | node-cpu-usage-high.json |
节点磁盘用量超过 85%(警告) | 每个磁盘装载点在 10 分钟内可用的量不足 15% | node-disk-usage-high.json |
节点内存用量超过 80%(警告) | 节点内存用量在 5 分钟内超过总可分配内存的 80% | node-memory-usage-high.json |
节点处于尚未就绪状态超过一小时(严重) | 节点处于尚未就绪状态超过一小时 | node-not-ready-1h.json |
Kubernetes 性能
提醒名称 | 说明 | Cloud Monitoring 中的提醒政策定义 |
---|---|---|
API 服务器错误率超过 20%(严重) | API 服务器在 15 分钟的时间里,针对每个动词的所有请求中有超过 20% 显示 5xx 或 429 错误 | apiserver-error-ratio-high.json |
ETCD 主节点更改或提案失败过于频繁(警告) | etcd 主节点更改或提案失败过于频繁 |
etcd-leader-changes-or-proposal-failures-frequent.json |
ETCD 服务器未达到法定数(严重) | 5 分钟内未提交任何 etcd 服务器提案,因此这些提案可能会丢失法定人数 |
etcd-server-not-in-quorum.yaml |
ETCD 存储空间超过上限的 90%(警告) | etcd 存储空间用量超过上限的 90% |
etcd-storage-usage-high.json |
使用 PromQL 的提醒政策
提醒政策中的查询也可以使用 PromQL(而不是 MQL)表示。例如,API server error ratio exceeds 20
percent (critical)
政策的 PromQL 版本可供下载:apiserver-error-ratio-high-promql.json。
如需了解详情,请参阅 Google Distributed Cloud 文档的使用 Managed Service for Prometheus 以及 Cloud Monitoring 文档的使用 PromQL 的提醒政策。
接收通知
创建提醒政策后,您可以为该政策定义一个或多个通知渠道。通知渠道有多种类型。例如,您可能会收到电子邮件、Slack 频道或移动应用发出的通知。您可以选择符合您需求的渠道。
如需了解如何配置通知渠道,请参阅管理通知渠道。