帮助手册

Google Remote Procedure Call (gRPC) 监视器

gRPC 是一个开源、高性能的远程过程调用(RPC)框架,可在所有 IT 环境中运行。该框架有助于创建可扩展的 API,并实现更快速的客户端-服务器通信。借助 Site24x7 的 gRPC 监控,您可以运行健康检查以确保 gRPC 服务的可用性以及所有相关服务的功能正常。

gRPC 监控支持以下两项功能:

  • 健康状态检查
    健康状态检查可帮助确认已配置的服务是否处于服务状态,或验证服务是否可以接收 RPC 调用。这些检查将根据配置的检查频率定期执行。
  • 行为或功能检查
    要执行行为或功能检查,您可以提交一个包含特定 gRPC 端点相关详情的 .proto 文件。这些检查将使用为特定方法配置的输入消息来检查端点的性能,并根据配置的检查频率定期执行。

使用场景

我可以监控实时渲染数据的流媒体平台吗?
可以,您可以使用 Site24x7 的 gRPC 监视器跟踪客户端-服务器通信是否正常,确保数据正常渲染并确认 gRPC 端点是否可用。您可以为此目的配置健康状态检查。

如何使用 gRPC 监控跟踪应用程序的性能?
您可以使用行为或功能检查来检查应用程序的性能。这些检查可以帮助您验证服务的可用性、跟踪 RPC 时间,以及确认是否存在预期输出。

当应用程序宕机时,您能收到告警吗?
可以,您可以配置告警设置,以便在监视器状态为宕机时通过您首选的方式接收通知。

当 RPC 时间超过配置的阈值时,您能收到告警吗?
可以。您可以在配置文件中为 RPC 时间配置阈值。超出阈值后,系统将向您发送告警通知。

如何验证 gRPC 响应?
您可以通过指定 JSONPath 断言,根据 JSONPath 表达式验证来自应用程序的 gRPC 响应。您还可以使用"应包含 gRPC 尾部(Trailer)"字段验证 gRPC 尾部是否存在于响应中,或检查其值是否与预期响应匹配。

添加 gRPC 监视器

常规设置

  1. 登录 Site24x7。
  2. 单击管理 > 资产清单 > 监视器 > 添加监视器
  3. 在"添加监视器"页面的监视器列表中选择 gRPC。
  4. 填写以下详情以添加监视器:
    • 显示名称:为您要监控的 gRPC 端点提供一个合适的名称。
    • 主机和端口:提供 gRPC 端点的主机名以及 gRPC 服务正在监听的端口。
    • 使用安全连接(SSL):使用切换按钮启用或禁用安全 SSL 连接。
    • Proto 文件:上传包含 gRPC 服务或端点相关详情的 .proto 文件。
    • 服务:提供或选择您要检查健康状态或调用其中方法的 gRPC 服务名称。
    • 方法:选择您要使用自定义输入消息调用的方法名称。
    • 消息:为所选服务的方法提供或生成输入消息。
    • 检查频率:选择所需的轮询频率。频率可设置为 30 秒至 1 天。如果您使用 Enterprise、Enterprise Web、Enterprise Plus Web、Elite 和 Elite Web 套餐,可配置 30 秒的频率。对于其他用户,最低支持的检查频率为 1 分钟。
      注意

      配置 30 秒检查频率将消耗两个基础监视器的许可证。

    • 监控位置:从下拉列表中选择一个位置配置文件,以确定从哪里监控该网站。如需了解更多,请参阅位置配置文件

  5. 内容检查
    • JSONPath 表达式:您可以指定 JSONPath 断言并测试 JSON 响应中的预期数据。测试成功的前提是断言能够成功解析 JSON 中的 JSON 路径。如需帮助构建 JSONPath 断言以测试您的 JSON 响应,可以使用 Site24x7 JSONpath 评估器。您可以随时添加多个 JSONPath 断言来测试各个使用场景。使用 + 按钮添加更多表达式断言。
    • JSONPath 严重性:您可以将告警严重性指定为宕机或故障。当 JSONPath 断言在测试期间失败时,将自动触发告警。 
    • 应包含 gRPC 尾部(Trailer):输入 gRPC 调用所需的尾部名称和值,验证 gRPC 尾部是否存在或其值是否与预期响应匹配。您可以选择在检查失败时触发故障或宕机告警。配置 gRPC 尾部检查时,必须根据以下条件添加值: 
      • 可以添加多个尾部,每个尾部可以接受多个值。 
      • 单个值可以带或不带双引号配置(例如:keep-alive 或 "keep-alive")。 
      • 如果配置了多个尾部值,需要用空格分隔,并为每个值使用双引号(例如:"gzip" "br")。 
      • 尾部值也支持正则表达式验证。正则表达式模式应为 "${}"\。例如:${\d{4}} 可用于在配置的尾部名称的尾部值中搜索四位连续数字。
    • gRPC 尾部严重性:使用切换按钮将告警严重性指定为宕机或故障。测试失败时,将自动触发告警。 

  6. gRPC 配置 
    • gRPC 元数据:元数据是以键值对形式表示的 RPC 调用信息。您可以自定义默认的 gRPC 元数据,在这种情况下可以添加额外的元数据名称和值。Site24x7 将发送的默认 gRPC 元数据如下:
      user-agent: Site24x7 grpc-java-okhttp/1.49.1
      content-type: application/grpc
      te: trailers
      grpc-accept-encoding: gzip
      grpc-timeout: 598906m
    • 身份验证方法:管理监视器的多种授权方法。
      • Basic/NTLM:配置基于 Basic/NTLM 的授权。Windows NTLM 是运行 Windows 操作系统的系统所使用的身份验证协议。
      • 凭据:为需要 Basic/NTLM 身份验证的 gRPC 端点指定用户名和密码。
      • OAuth:如果您要监控由 OAuth 框架保护的资源,请选择 OAuth 单选按钮。
      • OAuth 提供商名称:从预配置列表中选择 OAuth 提供商名称,或单击 + 按钮创建新的 OAuth 配置文件。了解如何配置 OAuth 提供商
      • Web Token:在您的身份验证服务器上注册 Site24x7,以使用 Web Token 监控受保护的资源。了解如何添加 Web Token。 
      • 客户端证书:对于需要客户端证书身份验证的 gRPC 端点,请上传客户端证书(必须是 PKCS#12 文件)。

  7. 高级配置 
    • 连接超时:指定与目标服务器建立连接所需的时间(秒)。如果在指定时间内未建立连接,监视器将报告为宕机,原因为"无法建立连接"。
    • 首选 IPv6:如果您希望通过启用 IPv6 的位置监控 gRPC 端点,只需在创建或编辑监视器时将切换按钮移至。Site24x7 可根据需要监控基于 IPv4/IPv6 双栈的基础设施。默认协议为 IPv4。启用切换按钮至 IPv6 后,您即可监控 IPv6 基础设施。如果通过 IPv6 连接失败,不会自动回退到 IPv4。了解更多
      在监控表单中启用 IPv6 并不意味着默认兼容监控 IPv4。如果您要监控同时兼容 IPv4 和 IPv6 的资源,需要为此设置两个独立的监视器检查。 
    • 依赖资源:从下拉列表中选择一个监视器作为您的依赖资源。将根据依赖资源的宕机状态来抑制对您监视器的告警。配置依赖资源并根据依赖资源状态抑制告警,是为您提供更好的误报保护的一部分功能。了解更多关于监视器级别告警抑制的信息。
      如果在"依赖资源"字段中选择"无",则告警将按您的正常配置设置进行。由于监视器没有任何依赖资源,此情况下不会抑制任何告警。
    • 监视器组:监视器的多监视器组支持允许一个监视器与不同监视器组中的多个依赖资源关联。如果在正常监视器状态检查期间,任何依赖资源的状态被识别为宕机,该监视器的告警将自动被抑制。但是,监视器级别的依赖配置始终优先于任何监视器组级别的依赖配置来抑制告警。

  8. 检查可用性:填写所有必填信息后,您可以使用此选项测试已创建的配置。服务测试帮助您深入研究代码并获得实践经验。如果出现配置错误,您可以解决后重试。
  9. 配置文件 
    • 阈值和可用性:从下拉列表中选择一个阈值配置文件,或选择可用的默认阈值,当资源超过配置的阈值和可用性时获得通知。了解更多。要创建自定义阈值和可用性配置文件,请参阅阈值和可用性。 
    • 标签:将监视器与预定义标签关联,以帮助创新地组织和管理您的监视器。了解更多
    • IT 自动化模板:选择在网站宕机/故障/恢复/任何状态变更/任何属性变更时执行的自动化操作。当状态发生变化时,定义的操作将被执行,所选用户组将收到告警。了解更多
    • 在计划维护期间执行 IT 自动化:配置计划维护窗口可让您在例行维护任务期间抑制所选 IT 资源的告警。选中此复选框可启用在此期间执行 IT 自动化——脚本执行、服务器命令以及更多——的选项。

  10. 告警设置
    • 用户告警组:选择在中断期间需要接收告警的用户组。要在组中添加多个用户,请参阅用户告警组
    • 值班计划值班计划选项可帮助确保在特定班次时间内向指定人员发送通知,帮助他们快速响应告警或事件。从下拉列表中选择您首选的值班计划。
    • 通知配置文件:从下拉列表中选择一个通知配置文件,或选择可用的默认配置文件。通知配置文件有助于配置在宕机时通知的时间和对象。请参阅通知配置文件创建自定义通知配置文件。无论您配置的值班班次如何,只要监视器与用户组关联,您就可以收到告警。
  11. 第三方集成:将您的监视器与预配置的第三方服务关联。这样您就可以将监视器告警推送到所选服务,从而改善事件管理。如果您尚未设置任何集成,请导航至管理 > 第三方集成进行创建。了解更多
  12. 单击保存。如果您想运行配置并查看监视器是否运行正常,然后再保存,可以单击检查并保存。如果出现错误,监视器将不会被保存。监视器设置完成后,Site24x7 深度发现向导会扫描您的域名,并自动检测所有相关的互联网资源,以便将其添加到您的账户中进行全面的互联网服务监控。进一步了解互联网服务深度发现

本文档对您有帮助吗?

您愿意帮助我们改进文档吗?请告诉我们哪些方面可以做得更好。


很抱歉本文档未能让您满意。我们希望了解可以从哪些方面改进您的体验。


感谢您抽出时间分享反馈。我们将利用您的反馈来改进在线帮助资源。

短链接已复制!