CLI使用案例8：使用CLI了解基础资源使用状况

背景

我们知道，日志服务的每个Project有一定的资源限制，你是否时常需要知道一些重要资源的使用状况？例如：

1. 一个Project的总shard数量是否已经超过了200个限制？
2. Logtail配置、机器组、报表数等是否快要满了？

现在使用CLI一行命令即可获得相关信息，以便及时提工单申请更大限额。

介绍

获取资源使用状况(get_resource_usage)检查传入的Project的所有基础资源，并以Json的形式列出，覆盖如下基础资源：

前提

这里假设已经完成了CLI的安装和配置.

获取基础资源使用状况

一行命令即可获取：

例如：

aliyunlog log get_resource_usage  --project="my project name"  --format-output=json

返回的格式是一个json，例如：

{
  "consumer_group": {
    "count": {
      "status": 8
    },
    "logstores": {
      "access-log": {
        "limitation": 10,
        "status": 7,
        "usage": "70.0%"
      },
      "billdata": {
        "limitation": 10,
        "status": 1,
        "usage": "10.0%"
      }
    }
  },
  "dashboard": {
    "count": {
      "limitation": 50,
      "status": 28,
      "usage": "56.0%"
    }
  },
  "logstore": {
    "count": {
      "limitation": 200,
      "status": 16,
      "usage": "8.0%"
    }
  },
  "logtail": {
    "count": {
      "limitation": 100,
      "status": 2,
      "usage": "2.0%"
    }
  },
  "machine_group": {
    "count": {
      "limitation": 100,
      "status": 1,
      "usage": "1.0%"
    }
  },
  "saved_search": {
    "count": {
      "limitation": 100,
      "status": 11,
      "usage": "11.0%"
    }
  },
  "shard": {
    "count": {
      "limitation": 200,
      "status": 30,
      "usage": "15%"
    },
    "logstores": {
      "access-log": {
        "status": 2
      },
      "billdata": {
        "status": 10
      },
      "test": {
        "status": 2
      },
      "testmax": {
        "status": 2
      },
      "tripdata": {
        "status": 10
      },
      "vedio1": {
        "status": 2
      },
      "web-1": {
        "status": 2
      }
    }
  }
}

注意：

1. 返回结构包含字段limitation与usage来表示限制与使用占比，但是这里的是默认的限制，如果通过工单增加过额度，这里并不会更新。
2. 这里传入了参数format-output来格式化json，如果已经配置过整个CLI，可以省略。

单看shard消耗

有时候我们主要关心一个两个核心指标，并可能仅仅想要一个数字，可以通过jmes-filter参数来进行处理，例如这里仅仅查看总的Shard使用情况，可以如下过滤：

aliyunlog log get_resource_usage  --project="my project name" --jmes-filter="shard.count.status"
> 30

这里通过--jmes-filter="shard.count.status直接获取输出结果中的shard的目前总数。

更多关于JMES过滤的信息，请参考这里。

进一步参考

• 扫码加入官方钉钉群 (11775223):