Nginx虚拟主机流量状态模块（nginx-module-vts）使用说明文档（二）

前面的博文 Nginx安装，开箱即用？讲了NG的安装，装完NG，为了拿到各种状态指标，就要对NG做监控。
Github 2.3k的开源项目nginx-module-vts没准真是你需求的。
链接数，qps，1xx、2xx,、3xx、4xx、5xx的响应数，响应耗时，响应时间分布，访问用户国家分布；甚至是基于各种状态的流量控制统统能满足你的需求。
nginx-module-vts具体怎么用？我们还是从官方文档开始撸吧，还是英文的，那就翻译一下吧。
内容有点长，你看到的文档会四篇文档的方式分别出现。这里是第二篇，第一篇你可以点这里查看。

Nginx虚拟主机流量状态模块

目录

9、管控指令（Control）

control指令能够通过查询字符串重置或删除流量区域。
该请求以JSON文档响应。

  • URI 语法
    • /{status_uri}/control?cmd={command}&group={group}&zone={name} 
http {

    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    ...

    server {

        server_name example.org;

        ...

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}

如果设置如上，则control的uri类似于example.org/status/control。

可用的请求参数如下：

  • cmd=<status|reset|delete>
    • status
      • 它将流量区域（zones）的状态返回为json格式，如status/format/json。
    • reset
      • 重置流量区域（zones）而不删除共享中的节点（nodes）。
    • delete
      • 删除共享内存中的流量区域（zones）。当重新请求时重新创建时。
  • group=<server|filter|upstream@alone|upstream@group|cache|*>
    • server
    • filter
    • upstream@alone
    • upstream@group
    • cache
    • *
  • zone=name
    • server
      • name
    • filter
      • filter_group@name
    • upstream@group
      • upstream_group@name
    • upstream@alone
      • @name
    • cache
      • name

动态获取流量区域（zones）状态

与status/format/json相似，只是它可以获得每个区域。

获取全部区域

  • 与status/format/json完全相同。
    • /status/control?cmd=status&group=*

获取组区域

  • mainZones
    • /status/control?cmd=status&group=server&zone=::main
  • serverZones
    • /status/control?cmd=status&group=server&zone=*
  • filterZones
    • /status/control?cmd=status&group=filter&zone=*
  • upstreamZones
    • /status/control?cmd=status&group=upstream@group&zone=*
  • upstreamZones::nogroups
    • /status/control?cmd=status&group=upstream@alone&zone=*
  • cacheZones
    • /status/control?cmd=status&group=cache&zone=*

mainZones中的状态值，包括hostName、nginxVersion、loadMsec、nowMsec、connections。

获取每个区域

  • single zone in serverZones
    • /status/control?cmd=status&group=server&zone=name
  • single zone in filterZones
    • /status/control?cmd=status&group=filter&zone=filter_group@name
  • single zone in upstreamZones
    • /status/control?cmd=status&group=upstream@group&zone=upstream_group@name
  • single zone in upstreamZones::nogroups
    • /status/control?cmd=status&group=upstream@alone&zone=name
  • single zone in cacheZones
    • /status/control?cmd=status&group=cache&zone=name

动态重置流量区域

将指定区域的值重置为0。

重置全部分区

  • /status/control?cmd=reset&group=*

重置组区域

  • serverZones
    • /status/control?cmd=reset&group=server&zone=*
  • filterZones
    • /status/control?cmd=reset&group=filter&zone=*
  • upstreamZones
    • /status/control?cmd=reset&group=upstream@group&zone=*
  • upstreamZones::nogroups
    • /status/control?cmd=reset&group=upstream@alone&zone=*
  • cacheZones
    • /status/control?cmd=reset&group=cache&zone=*

重置每个分区

  • single zone in serverZones
    • /status/control?cmd=reset&group=server&zone=name
  • single zone in filterZones
    • /status/control?cmd=reset&group=filter&zone=filter_group@name
  • single zone in upstreamZones
    • /status/control?cmd=reset&group=upstream@group&zone=upstream_group@name
  • single zone in upstreamZones::nogroups
    • /status/control?cmd=reset&group=upstream@alone&zone=name
  • single zone in cacheZones
    • /status/control?cmd=reset&group=cache&zone=name

动态删除流量区域

删除共享内存中指定的区域。

删除全部分区

  • /status/control?cmd=delete&group=*

删除组分区

  • serverZones
    • /status/control?cmd=delete&group=server&zone=*
  • filterZones
    • /status/control?cmd=delete&group=filter&zone=*
  • upstreamZones
    • /status/control?cmd=delete&group=upstream@group&zone=*
  • upstreamZones::nogroups
    • /status/control?cmd=delete&group=upstream@alone&zone=*
  • cacheZones
    • /status/control?cmd=delete&group=cache&zone=*

删除每个分区

  • single zone in serverZones
    • /status/control?cmd=delete&group=server&zone=name
  • single zone in filterZones
    • /status/control?cmd=delete&group=filter&zone=filter_group@name
  • single zone in upstreamZones
    • /status/control?cmd=delete&group=upstream@group&zone=upstream_group@name
  • single zone in upstreamZones::nogroups
    • /status/control?cmd=delete&group=upstream@alone&zone=name
  • single zone in cacheZones
    • /status/control?cmd=delete&group=cache&zone=name

10、设置指令（Set）

可以使用vhost_traffic_status_set_by_filter指令分别获取nginx配置中的状态值。
可以获取几乎所有状态值，并将获得的值存储在用户定义的变量（第一个参数）中。

  • 指令语法
    • vhost_traffic_status_set_by_filter $variable group/zone/name 
http {

    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    ...
    upstream backend {
        10.10.10.11:80;
        10.10.10.12:80;
    }

    server {

        server_name example.org;

        ...

        vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;

        vhost_traffic_status_set_by_filter $requestCounter server/example.org/requestCounter;
        vhost_traffic_status_set_by_filter $requestCounterKR filter/country::example.org@KR/requestCounter;

        location /backend {
            vhost_traffic_status_set_by_filter $requestCounterB1 upstream@group/backend@10.10.10.11:80/requestCounter;
            proxy_pass http://backend;
        }
    }
}

以上设置如下：

  • $requestCounter
    • serverZones -> example.org -> requestCounter
  • $requestCounterKR
    • filterZones -> country::example.org -> KR -> requestCounter
  • $requestCounterB1
    • upstreamZones -> backend -> 10.0.10.11:80 -> requestCounter

请参见vhost_traffic_status_set_by_filter指令以了解详细用法。

11、JSON字段说明

以下状态信息以JSON格式提供：

状态中使用的Json

/{status_uri}/format/json

/{status_uri}/control?cmd=status&...

  • hostName
    • 主机名。
  • nginxVersion
    • nginx的版本。
  • loadMsec
    • 以毫秒为单位的处理时间。
  • nowMsec
    • 以毫秒为单位的当前时间
  • connections
    • active
      • 当前活动的客户端连接数。
    • reading
      • 读取客户端连接的总数。
    • writing
      • 写入客户端连接的总数。
    • waiting
      • 正在等待的客户端连接总数。
    • accepted
      • 接受的客户端连接总数。
    • handled
      • 已处理的客户端连接总数
    • requests
      • 请求请求的客户端连接总数。
  • sharedZones
    • name
      • 配置中指定的共享内存的名称。(默认值为：vhost_traffic_status)
    • maxSize
      • 配置中指定的共享内存的最大大小的限制。
    • usedSize
      • 共享内存的当前大小。
    • usedNode
      • 共享内存中当前使用的节点数。可以通过以下公式获得一个节点的近似大小：（usedSize / usedNode）
  • serverZones
    • requestCounter
      • 从客户端接收的客户端请求总数。
    • inBytes
      • 从客户端接收的总字节数。
    • outBytes
      • 发送到客户端的总字节数。
    • responses
      • 1xx, 2xx, 3xx, 4xx, 5xx
        • 状态代码为1xx、2xx、3xx、4xx和5xx的响应数。
      • miss
        • 未命中的缓存数。
      • bypass
        • 绕过缓存旁路数。
      • expired
        • 过期的缓存数。
      • stale
        • 失效缓存的数量。
      • updating
        • 缓存更新的次数。
      • revalidated
        • 重新验证的缓存数。
      • hit
        • 缓存命中数。
      • scarce
        • 未达缓存要求的请求次数。
    • requestMsecCounter
      • 累积的请求处理时间（毫秒）。
    • requestMsec
      • 请求处理时间的平均值（毫秒）。
    • requestMsecs
      • times
        • 请求处理时间的时间（毫秒）。
      • msecs
        • 请求处理时间的时间（毫秒）。
    • requestBuckets
      • msecs
        • 由vhost_traffic_status_histogram_buckets指令设置的柱状图的桶的值.
      • counters
        • 每个存储桶段值大于或等于对应请求处理时间的累积值。
  • filterZones
    • 它提供了与serverZones相同的字段，只是包含了组名。
  • upstreamZones
    • server
      • server地址。
    • requestCounter
      • 转发到此服务器的客户端连接总数。
    • inBytes
      • 从该服务器接收的总字节数。
    • outBytes
      • 发送到此服务器的总字节数。
    • responses
      • 1xx, 2xx, 3xx, 4xx, 5xx
        • 状态代码为1xx、2xx、3xx、4xx和5xx的响应数。
    • requestMsecCounter
      • 包括upstream在内的累计请求处理时间数（毫秒）。
    • requestMsec
      • 包括upstream在内请求处理时间的平均毫秒数。
    • requestMsecs
      • times
        • 请求处理时间的时间（毫秒）。
      • msecs
        • 包括upstream在内请求处理时间的时间（毫秒）。
    • requestBuckets
      • msecs
        • 由vhost_traffic_status_histogram_buckets指令设置的直方图的bucket值。
      • counters
        • 每个存储桶段值大于或等于对应请求处理时间（包括上游）的累积值。
    • responseMsecCounter
      • 仅upstream响应处理时间累加值（毫秒）。
    • responseMsec
      • 仅upstream响应处理时间平均值（毫秒）。
    • responseMsecs
      • times
        • 请求处理时间（毫秒）。
      • msecs
        • 仅upstream响应处理时间平均值（毫秒）。
    • responseBuckets
      • msecs
        • 由vhost_traffic_status_histogram_buckets指令设置的柱状图的存储桶值。
      • counters
        • 仅upstream响应处理时间大于或等于每个存储桶值的累计次数
    • weight
      • server的当前的weight设置。
    • maxFails
      • server的当前的max_fails设置。
    • failTimeout
      • server的当前的fail_timeout设置。
    • backup
      • server的当前的backup设置。
    • down
      • 服务器的当前down设置。
        基本上，这只是ngx_http_upstream_module的server关闭的标记（例如server backend3.example.com down），不是实际的upstream状态。
        如果启用了上游区域指令，它将变为实际状态。
  • cacheZones
    • maxSize
      • 配置中指定的最大缓存大小限制。
    • usedSize
      • 当前缓存的大小。
    • inBytes
      • 从缓存接收的字节总数。
    • outBytes
      • 从缓存发送的字节总数。
    • responses
      • miss
        • 未命中的缓存数。
      • bypass
        • 绕过缓存旁路数。
      • expired
        • 过期的缓存数。
      • stale
        • 失效缓存的数量。
      • updating
        • 缓存更新的次数。
      • revalidated
        • 重新验证的缓存数。
      • hit
        • 缓存命中数。
      • scarce
        • 未达缓存要求的请求次数。

Control中使用的Json

/{status_uri}/control?cmd=reset&...

/{status_uri}/control?cmd=delete&...

  • processingReturn
    • The result of true or false.
  • processingCommandString
    • The requested command string.
  • processingGroupString
    • The requested group string.
  • processingZoneString
    • The requested zone string.
  • processingCounts
    • The actual processing number.

凋谢的不是花，萎蔫的是时间；星辰大海，点滴为途。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 205,132评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,802评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,566评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,858评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,867评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,695评论 1赞 282
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,064评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,705评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,915评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,432评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,041评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2赞 343