Updated on 2023-06-20 GMT+08:00

Flow Control

Flow control can be implemented via an independent API.

  1. Log in to the CSS management console.
  2. Choose Clusters in the navigation pane. On the Clusters page, locate the target cluster and click Access Kibana in the Operation column.
  3. In the navigation pane on the left, choose Dev Tools and run the commands to query traffic control information.
    • Check the traffic control status of all nodes.
      GET /_nodes/stats/filter
    • View the traffic control status of a specific node.
      GET /_nodes/{nodeId}/stats/filter

      {nodeId} indicates the ID of the node you want to check.

    Example response:

    {
      "_nodes" : {
        "total" : 1,
        "successful" : 1,
        "failed" : 0
      },
      "cluster_name" : "css-flowcontroller",
      "nodes" : {
        "ElBRNCMbTj6L1C-Wke-Dnw" : {
          "name" : "css-flowcontroller-ess-esn-1-1",
          "host" : "10.0.0.133",
          "timestamp" : 1613979513747,
          "flow_control" : {
            "transport" : {
              "concurrent_req" : 0,
              "rejected_concurrent" : 0,
              "rejected_new" : 0,
              "rejected_deny" : 0
            },
            "http" : {
              "concurrent_req" : 0,
              "rejected_concurrent" : 0,
              "rejected_new" : 0,
              "rejected_deny" : 0
            },
            "memory" : {
              "memory_allow" : 41,
              "memory_rejected" : 0
            },
            "cpu": {
              "rejected_cpu" : 0
            }
            "ip_address" : [
              {
                "ip" : "/10.0.0.198",
                "count" : 453
              },
              {
                "ip" : "/198.19.49.1",
                "count" : 42
              }
            ],
            "url_sample" : [
              {
                "url" : "/*/_search?pretty=true",
                "method" : "GET",
                "remote_address" : "/10.0.0.198:16763",
                "count" : 1
              }
            ]
          }
      }
    }

    In the response, the information of each node is separated. The http field records the numbers of concurrent connections and new connections. The memory records memory flow control statistics. The ip_address field records the recent client IP addresses that are accessed most recently. The url_sample field records the recent URLs that are requested most frequently. The cpu field records CPU flow control statistics.

    Table 1 Response parameters

    Parameter

    Description

    concurrent_req

    Number of TCP connections of a node, which is recorded no matter whether flow control is enabled. This value is similar to the value of current_open of the GET /_nodes/stats/http API but is smaller, because whitelisted IP addresses and internal node IP addresses are not counted.

    rejected_concurrent

    Number of concurrent connections rejected during HTTP flow control. This value is not cleared when HTTP flow control is disabled.

    rejected_new

    Number of new connections rejected during HTTP flow control. This value is not cleared when HTTP flow control is disabled.

    rejected_deny

    Number of requests rejected based on the blacklist during HTTP flow control. This value is not cleared when HTTP flow control is disabled.

    memory_allow

    Number of allowed requests during memory flow control. This parameter takes effect when memory flow control is enabled, and its value is not cleared after memory flow control is disabled. The requests from the paths in the allow_path whitelist are not recorded. If allow_path is set to **, no requests are recorded.

    memory_rejected

    Number of rejected requests during memory flow control. This parameter takes effect when memory flow control is enabled, and its value is not cleared after memory flow control is disabled. The requests from the paths in the allow_path whitelist are not recorded. If allow_path is set to **, no requests are recorded.

    rejected_cpu

    Number of requests rejected when the CPU flow control threshold is exceeded. This parameter takes effect when CPU flow control is enabled, and its value is not cleared after CPU flow control is disabled.

    ip_address

    IP addresses and the number of requests. For details, see Table 2.

    url_sample

    Request path sampling. The number of URLs of a request are collected based on the configured time and sampling interval. For details, see Table 3.

    Table 2 ip_address

    Parameter

    Description

    ip

    Source IP address for accessing the node.

    method

    Number of access requests from an IP address.

    Table 3 url_sample

    Parameter

    Description

    url

    Request URL

    method

    Method corresponding to the request path

    remote_address

    Source IP address and port number of the request

    count

    How many times a path is sampled