帮助手册

全局参数

全局参数是自定义的名称-值对,可作为 Site24x7 全局配置的一部分进行定义。定义后,这些参数将嵌入您访问的监控表单和文本字段中,并与其他默认参数一起赋值。您只需在表单或文本字段中输入 $ 符号并选择相应参数,即可调用全局参数。全局参数的格式为 ${PARAMETERNAME}。表单数据渲染或使用时,定义的参数名称将自动替换为对应的常量值或动态生成的值。全局参数可在您 Site24x7 账户中以下监控表单和文本字段中使用:

  • 邮件模板:主题和正文
  • 添加/编辑监视器表单: 请求头名称、请求头值和请求体(POST 方法)
  • 添加/编辑调用 URL 操作:HTTP 请求头名称和请求头值、请求体中的自定义参数
                                                       (POST 方法)
  • Webhook 与第三方集成:请求头名称和请求头值

添加全局参数

  1. 登录 Site24x7。
  2. 点击管理 > 配置文件 > 全局参数
  3. 点击添加参数按钮,创建新的全局参数。
  4. 填写以下信息以自定义全局参数:
    • 参数名称:为全局参数指定唯一名称。
      注意

      参数名称不得包含空格或"$"标签。此外,两个不同的参数不能使用相同的名称。

    • 参数类型:参数分为两种类型——常量动态。适当切换开关按钮,以在输出中生成常量值或动态值。
    • 常量参数类型: 常量参数允许您定义在任务执行(或表单渲染)期间保持不变的值。
      • 参数值:可指定所需的参数值。参数值字段允许输入任意普通文本,唯一限制是该字段为必填项。
    • 动态参数类型:动态参数允许您定义在每次任务执行时都会变化的值。选择动态参数类型后,您可以灵活选择多种策略并相应定义参数值。输入值表达式后,还可点击"生成示例值"链接预览实际输出结果。 
      • 策略:您可以为动态参数选择合适的策略,然后定义参数值。策略支持创建多个动态参数。支持的策略包括:
        • 当前日期和时间
        • 按长度生成随机数
        • 按最大值生成随机数
        • 毫秒级时间戳
    • 当前日期和时间:您可以在参数值字段中以所需格式定义日期和时间。 例如,如果将动态参数值定义为"yyyy.MM.dd G 'at' HH:mm:ss z",则在监控表单和文本字段中使用该参数名称的所有位置,当前日期和时间将在表单渲染时自动格式化。示例:2017.07.04 AD at 12:08:56 PDT
      注意

      如需查看当前日期和时间格式的详细列表,请参阅此链接

       
    • 按长度生成随机数:在参数值字段中指定位数(须小于 10),以生成具有相同位数长度的随机数作为输出。例如,如果指定值为 3,则将生成一个三位随机数(如 930),并在每次用于各种动态表单和字段时替换参数名称。
    • 按最大值生成随机数:生成一个介于零和您指定的最大值之间的随机数。例如,如果指定值为 3500,则生成的输出值将是小于 3500 的任意数字。
    • 毫秒级时间戳:选择此策略以毫秒为单位渲染当前时间,将使用 UNIX 时间戳。 
    • UUID 生成器:生成通用唯一标识符(UUID)——一个 128 位的字母数字编码,可用于在互联网上唯一标识某个对象或实体。 仅支持版本 4 UUID 生成器。
  5. 定义常量或动态参数后,点击 保存 按钮以生成全局参数。
    注意

    全局参数生成后,将显示在全局参数仪表板中。您随时可以修改或删除已有的全局参数。

使用案例示例

自定义邮件模板

邮件模板的主题或内容字段中输入 $ 符号可调用全局参数。全局参数将与标准参数一起列出,格式为 {PARAMETERNAME}。邮件通知触发并发送给相关用户后,全局参数名称将被替换为对应的常量值或动态值。

监视器表单:请求体

全局参数可在监视器配置表单中调用。当监视器执行数据采集时,HTTP 配置字段中指定的参数名称将被您定义的参数值成功替换。

本文档对您有帮助吗?

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


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


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

短链接已复制!