第 5 章 访问指标

流程

1. 如果您还没有为 Thanos Querier 获取 OpenShift Container Platform API 路由，请运行以下命令：

   $ oc get routes -n openshift-monitoring thanos-querier -o jsonpath='{.status.ingress[0].host}'

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，以 JSON 格式从 Thanos Querier API 路由检索指标列表。此命令使用 oc 通过 bearer 令牌进行身份验证。

   $ curl -k -H "Authorization: Bearer $(oc whoami -t)" https://<thanos_querier_route>/api/v1/metadata 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <thanos_querier_route> 替换为 Thanos Querier 的 OpenShift Container Platform API 路由。

流程

1. 在 OpenShift Container Platform web 控制台中点 Observe Metrics。

2. 要添加一个或多个查询，请执行以下操作：

   Expand

   选项	描述
   选择现有的查询。	在 Select query 下拉列表中选择一个现有的查询。
   创建自定义查询。	将 Prometheus Query Language (PromQL) 查询添加到 Expression 字段中。 当您输入 PromQL 表达式时，自动完成建议会出现在下拉列表中。这些建议包括功能、指标、标签和时间令牌。使用键盘箭头选择其中一项建议的项目，然后按 Enter 将项目添加到您的表达式中。将鼠标指针移到建议的项目上，以查看该项目的简短描述。
   添加多个查询。	点 Add query。
   复制现有的查询。	选择查询旁边的 Options 菜单 ，然后选择 Duplicate 查询。
   禁用查询正在运行。	选择查询旁边的 Options 菜单 并选择 Disable query。

   Show more

3. 要运行您创建的查询，请点 Run queries。图表中会直观呈现查询的指标。如果查询无效，则 UI 会显示错误消息。

   注意
   • 如果查询对大量数据进行运算，这可能会在绘制时序图时造成浏览器超时或过载。要避免这种情况，请点 Hide graph，并只使用 metrics 表来校准查询。然后，在找到可行的查询后，启用图表来绘制图形。
   • 默认情况下，查询表会显示一个展开的视图，列出每个指标及其当前值。点 ˅ 下箭头来最小化查询的展开视图。
4. 可选：保存页面 URL，以便在将来再次使用此查询。

5. 探索视觉化指标。最初，图表中显示所有启用的查询中的所有指标。通过执行以下操作来选择显示哪些指标：

   Expand

   选项	描述
   隐藏查询中的所有指标。	点查询的 Options 菜单 并点 Hide all series。
   隐藏特定指标。	前往查询表，再点指标名称旁边的带颜色的方格。
   放大图表并更改时间范围。	执行以下操作之一： 点击图表并在水平方向上拖动，以可视化方式选择时间范围。 使用菜单选择时间范围。
   重置时间范围。	点 Reset zoom。
   在特定时间点显示所有查询的输出。	将鼠标悬停在您感兴趣的点上。查询输出会出现在弹出窗口中。
   隐藏图表。	点 Hide graph。

   Show more

流程

1. 在 OpenShift Container Platform web 控制台中进入 Observe Targets。此时会打开 Metrics targets 页面，其中包含为指标提取的所有服务端点目标的列表。

   本页显示了 OpenShift Container Platform 默认项目和用户定义的项目的目标的详细信息。本页列出了每个目标的以下信息：

   • 正在提取的服务端点 URL
   • 被监控的 ServiceMonitor 资源
   • 目标的 up 或 down 状态
   • 命名空间
   • 最后提取的时间
   • 最后一次提取持续的时间

2. 可选：要查找特定的目标，请执行以下操作：

   Expand

   选项	描述
   根据状态和源过滤目标。	在 Filter 列表中选择过滤。 可用的过滤选项如下： Status 过滤器： Up。目标当前已启动，正在主动抓取指标。 Down。目标当前已停机，没有提取指标。 Source 过滤器： Platform。平台级别目标仅与默认 Red Hat OpenShift Service on AWS 项目相关。这些项目提供 Red Hat OpenShift Service on AWS 核心功能。 User。用户目标与用户定义的项目相关。这些项目是用户创建的，可以进行自定义。
   根据名称或标签搜索目标。	在搜索框旁边的 Text 或 Label 字段中输入搜索词。
   对目标进行排序。	点一个或多个 Endpoint Status,Namespace,Last Scrape, 和 Scrape Duration 列标头。

   Show more

3. 点目标的 Endpoint 列中的 URL，以进入其 Target 详情页。本页提供有关目标的信息，包括以下信息：

   • 为指标提取的端点 URL
   • 目标的当前 Up 或 Down 状态
   • 到命名空间的链接
   • 到 ServiceMonitor 资源详情的链接
   • 附加到目标的标签
   • 为指标提取目标的最长时间

流程

1. 在 OpenShift Container Platform web 控制台中进入 Observe Dashboards。
2. 在 Dashboard 列表中选择一个仪表板。有些仪表板（如 etcd 和 Prometheus 仪表板）在被选中时会生成额外的子菜单。

3. 可选：在时间范围列表中为图形 选择一个时间范围。

   • 选择预定义的时间段。

   • 点 Time range 列表中的 Custom 时间范围 来设置自定义时间范围。

     1. 输入或选择 From 和 To date and time。
     2. 单击 Save 以保存自定义时间范围。
4. 可选：选择一个 刷新间隔。
5. 将鼠标悬停在仪表板中的每个图形上，以显示特定项目的详细信息。