采集ping和tcping数据

本文介绍通过Logtail采集ping和tcping数据到日志服务Metricstore的操作步骤。

前提条件

已创建Project和MetricStore。具体操作,请参见创建Project创建MetricStore

使用限制

只有Linux Logtail 1.0.31及以上版本的Logtail支持采集ping和tcping数据。如果您已在服务器上安装旧版本的Logtail,需先升级。具体操作,请参见安装Logtail(Linux系统)

操作步骤

  1. 登录日志服务控制台

  2. 在Project列表区域,单击目标Project。

  3. 时序存储 > 时序库页签中,在目标MetricStore下面选择数据接入 > logtail配置,然后在右侧页面单击添加Logtail配置

  4. 快速数据接入对话框中,单击Ping监控

  5. 创建机器组。

    • 如果您已有可用的机器组,请单击使用现有机器组
    • 如果您还没有可用的机器组,请执行以下操作(以ECS为例)。

      1. ECS机器页签中,通过手动选择实例方式选择目标ECS实例,单击创建

        具体操作,请参见安装Logtail(ECS实例)

        重要

        如果您的服务器是与日志服务属于不同账号的ECS、其他云厂商的服务器和自建IDC时,您需要手动安装Logtail。具体操作,请参见安装Logtail(Linux系统)。手动安装Logtail后,您必须在该服务器上手动配置用户标识。具体操作,请参见配置用户标识

      2. 安装完成后,单击确认安装完毕
      3. 创建机器组页面,输入名称,单击下一步

        日志服务支持创建IP地址机器组和用户自定义标识机器组,详细参数说明请参见创建IP地址机器组创建用户自定义标识机器组

  6. 确认目标机器组已在应用机器组区域,单击下一步

    重要

    创建机器组后立刻应用,可能因为连接未生效,导致心跳为FAIL,您可单击自动重试。如果还未解决,请参见Logtail机器组无心跳进行排查。

  7. 数据源设置页签中,设置配置名称插件配置,然后单击下一步

    inputs为数据源配置,必选项。

    重要

    一个inputs中只允许配置一个类型的数据源。

    {
        "inputs": [
            {
                "detail": {
                    "tcp": [
                        {
                            "port": 80,
                            "src": "192.XX.XX.103",
                            "count": 3,
                            "target": "www.aliyun.com"
                        }
                    ],
                    "interval_seconds": 60,
                    "icmp": [
                        {
                            "src": "192.XX.XX.103",
                            "count": 3,
                            "target": "www.aliyun.com"
                        }
                    ],
                    "http": [
         				{
             				"src": "192.XX.XX.103",
             				"expect_code": 200,
            				"target": "www.aliyun.com"
          				}
              		]
                },
                "type": "metric_input_netping"
            }
        ]
    }

    参数

    类型

    是否必选

    参数说明

    tcp

    array

    采集TCP ping数据。详细参数说明如下,参数值需根据实际值替换。

    • port:端口号。

    • src:执行ping命令的服务器的IP地址。即由src字段决定在机器组的哪台机器中执行ping命令。

    • count:限制执行一次ping命令发送的数据包数量。建议使用默认值3,取值范围为(0,10)。

    • target:目标主机名或IP地址。即由target字段决定ping的目标主机名或IP地址。

    • name:名称,默认为{src}->{target}。

    • labels:标签,支持增加指标标签。

    支持添加多个IP地址,示例如下:

    "tcp": [
        {
             "port": 80,
             "src": "192.XX.XX.103",
             "count": 3,
             "target": "www.aliyun.com"
         },
         {
              "port": 80,
              "src": "192.XX.XX.104",
              "count": 3,
              "target": "www.aliyun.com"
          }
            ]

    icmp

    array

    采集ICMP ping数据。详细参数说明如下,参数值需根据实际值替换。

    • src:执行ping命令的服务器的IP地址。即由src字段决定在机器组的哪台机器中执行ping命令。

    • count:限制执行一次ping命令发送的数据包数量。建议使用默认值3,取值范围为(0,10)。

    • target:目标的主机名或IP地址。即由target字段决定ping的目标主机名或IP地址。

    • name:名称,默认为{src}->{target}。

    • labels:标签,支持增加指标标签。

    支持添加多个IP地址,示例如下:

    "icmp": [
         {
             "src": "192.XX.XX.103",
             "count": 3,
             "target": "www.aliyun.com"
          },
          {
               "src": "192.XX.XX.104",
               "count": 3,
               "target": "www.aliyun.com"
           }
              ]

    http

    array

    采集HTTP ping数据。详细参数说明如下,参数值需根据实际值替换。

    • src:执行ping命令的服务器的IP地址。即由src字段决定在机器组的哪台机器中执行ping命令。

    • method:执行请求的http method,默认get。

    • expect_response_contains: 预期结果包含内容。

    • expect_code:预期状态码。

    • target:目的地址,支持https。

    • name:名称,默认为{src}->{target}。

    • labels:标签,支持增加指标标签。

    "http": [
         {
             "src": "192.XX.XX.103",
             "expect_code": 200,
             "target": "www.aliyun.com"
          }
              ]

    interval_seconds

    int

    执行ping命令的时间间隔,单位:秒。

    • 默认值:60。

    • 取值范围:[10, 86400)

    type

    string

    数据源类型,固定为metric_input_netping。

后续步骤

采集ping数据后,您可以在Metricstore中进行查询分析。具体操作,请参见查询和分析时序数据查询ping数据

相关指标说明如下表所示。

分类

指标名

说明

ICMP ping

ping_failed

单次执行icmp ping命令,发送失败的数据包数量。

ping_rtt_avg_ms

单次执行icmp ping命令的平均响应时间,单位:毫秒。

ping_rtt_max_ms

单次执行icmp ping命令的最大响应时间,单位:毫秒。

ping_rtt_min_ms

单次执行icmp ping命令的最小响应时间,单位:毫秒。

ping_rtt_stddev_ms

单次执行icmp ping命令的标准差时间,单位:毫秒。

ping_rtt_total_ms

单次执行icmp ping命令的总响应时间,单位:毫秒。

ping_succcess

单次执行icmp ping命令,发送成功的数据包数量。

ping_total

单次执行icmp ping命令,发送的数据包总数。

TCP ping

tcping_failed

单次执行tcp ping命令,发送失败的数据包数量。

tcping_rtt_avg_ms

单次执行tcp ping命令的平均响应时间,单位:毫秒。

tcping_rtt_max_ms

单次执行tcp ping命令的最大响应时间,单位:毫秒。

tcping_rtt_min_ms

单次执行tcp ping命令的最小响应时间,单位:毫秒。

tcpping_rtt_stddev_ms

单次执行tcp ping命令的标准差时间,单位:毫秒。

tcping_rtt_total_ms

单次执行tcp ping命令的总响应时间,单位:毫秒。

tcping_succcess

单次执行tcp ping命令,发送成功的数据包数量。

tcping_total

单次执行tcp ping命令,发送的数据包总数。

HTTP ping

httping_failed

单次执行http ping命令,发送失败的数量。

httping_succcess

单次执行http ping命令,发送成功的数量。

httping_total

单次执行http ping命令,发送的总数。

httping_rt_ms

单次执行http ping命令延迟,单位:毫秒。

httping_response_bytes

单次执行http ping命令响应值大小,单位:Byte。

httping_cert_ttl_days

单次执行http ping命令证书过期时间,单位:Day。