5.2. 以开发者身份访问指标
您可以访问指标来监控集群工作负载的性能。
5.2.1. 查看可用指标列表 复制链接链接已复制到粘贴板!
作为集群管理员或具有所有项目查看权限的用户,您可以查看集群中可用的指标列表,并以 JSON 格式输出列表。
先决条件
-
您是一个集群管理员,或者您可以使用具有
cluster-monitoring-view
集群角色的用户访问集群。 -
已安装 OpenShift Container Platform CLI (
oc
)。 - 您已获取 Thanos Querier 的 OpenShift Container Platform API 路由。
您可以使用
oc whoami -t
命令获取 bearer 令牌。重要您只能使用 bearer 令牌身份验证来访问 Thanos Querier API 路由。
流程
如果您还没有为 Thanos Querier 获取 OpenShift Container Platform API 路由,请运行以下命令:
oc get routes -n openshift-monitoring thanos-querier -o jsonpath='{.status.ingress[0].host}'
$ oc get routes -n openshift-monitoring thanos-querier -o jsonpath='{.status.ingress[0].host}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 运行以下命令,以 JSON 格式从 Thanos Querier API 路由检索指标列表。此命令使用
oc
通过 bearer 令牌进行身份验证。curl -k -H "Authorization: Bearer $(oc whoami -t)" https://<thanos_querier_route>/api/v1/metadata
$ curl -k -H "Authorization: Bearer $(oc whoami -t)" https://<thanos_querier_route>/api/v1/metadata
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 将
<thanos_querier_route>
替换为 Thanos Querier 的 OpenShift Container Platform API 路由。
您可以使用 OpenShift Container Platform 指标查询浏览器来运行 Prometheus Query Language (PromQL)查询来检查图表中呈现的指标。此功能提供有关您要监控的任何用户定义的工作负载的信息。
作为开发者,您必须在查询指标时指定项目名称。您必须具有所需权限才能查看所选项目的指标。
Metrics UI 包括预定义查询,如 CPU、内存、带宽或网络数据包。这些查询仅限于所选项目。您还可以对所有对象运行自定义 Prometheus Query Language (PromQL) 查询。
先决条件
- 对于您要查看指标的项目,您可以作为开发者或具有查看权限的用户访问集群。
- 您已为用户定义的项目启用了监控。
- 您已在用户定义的项目中部署了服务。
-
您已为该服务创建了
ServiceMonitor
自定义资源定义(CRD),以定义如何监控该服务。
流程
-
在 OpenShift Container Platform web 控制台中点 Observe
Metrics。 要添加一个或多个查询,请执行以下操作:
Expand 选项 描述 选择现有的查询。
在 Select query 下拉列表中选择一个现有的查询。
创建自定义查询。
将 Prometheus Query Language (PromQL) 查询添加到 Expression 字段中。
当您输入 PromQL 表达式时,自动完成建议会出现在下拉列表中。这些建议包括功能、指标、标签和时间令牌。使用键盘箭头选择其中一项建议的项目,然后按 Enter 将项目添加到您的表达式中。将鼠标指针移到建议的项目上,以查看该项目的简短描述。
添加多个查询。
点 Add query。
复制现有的查询。
选择查询旁边的 Options 菜单
,然后选择 Duplicate 查询。
禁用查询正在运行。
选择查询旁边的 Options 菜单
并选择 Disable query。
要运行您创建的查询,请点 Run queries。图表中会直观呈现查询的指标。如果查询无效,则 UI 会显示错误消息。
注意- 如果查询对大量数据进行运算,这可能会在绘制时序图时造成浏览器超时或过载。要避免这种情况,请点 Hide graph,并只使用 metrics 表来校准查询。然后,在找到可行的查询后,启用图表来绘制图形。
- 默认情况下,查询表会显示一个展开的视图,列出每个指标及其当前值。点 ˅ 下箭头来最小化查询的展开视图。
- 可选:保存页面 URL,以便在将来再次使用此查询。
探索视觉化指标。最初,图表中显示所有启用的查询中的所有指标。通过执行以下操作来选择显示哪些指标:
Expand 选项 描述 隐藏查询中的所有指标。
点查询的 Options 菜单
并点 Hide all series。
隐藏特定指标。
前往查询表,再点指标名称旁边的带颜色的方格。
放大图表并更改时间范围。
执行以下操作之一:
- 点击图表并在水平方向上拖动,以可视化方式选择时间范围。
- 使用菜单选择时间范围。
重置时间范围。
点 Reset zoom。
在特定时间点显示所有查询的输出。
将鼠标悬停在您感兴趣的点上。查询输出会出现在弹出窗口中。
隐藏图表。
点 Hide graph。
5.2.3. 以开发者身份查看监控仪表板 复制链接链接已复制到粘贴板!
作为开发者,您可以查看与您具有权限的项目相关的仪表板。
从 OpenShift Container Platform 4.19 开始,Web 控制台中的视角会统一。Developer 视角不再默认启用。
所有用户都可以与所有 OpenShift Container Platform Web 控制台功能交互。但是,如果您不是集群所有者,您可能需要请求从集群所有者访问特定功能的权限。
您仍然可以启用 Developer 视角。在 web 控制台中的 Getting Started 窗格中,您可以浏览控制台,查找有关设置集群的信息,查看启用 Developer 视角的快速启动,并按照链接探索新功能。
先决条件
- 您可以使用开发人员或用户访问集群。
- 有您通过仪表板查看的项目的查看权限。
- 集群管理员在 web 控制台中 启用了 Developer 视角。
流程
- 在 OpenShift Container Platform Web 控制台的 Developer 视角中,点 Observe 并进入 Dashboards 标签页。
- 从 Project: 下拉列表中选择一个项目。
- 从 Dashboard 下拉列表中选择一个仪表板,以查看过滤的指标。
可选:在 Time Range 列表中为图形选择一个时间范围。
- 选择预定义的时间段。
点 Time Range 列表中的 Custom 时间范围来设置自定义时间范围。
- 输入或选择 From 和 To date and time。
- 单击 Save 以保存自定义时间范围。
- 可选:选择一个 Refresh Interval。
- 将鼠标悬停在仪表板中的每个图形上,以显示特定项目的详细信息。