elasticsearch API官檔 cat API 通用參數(shù)熄驼,v,help ,sort,headers,format

因個人愛好像寒,計劃對elasticsearch官方文檔部分章節(jié)做翻譯,統(tǒng)一發(fā)布至簡書博客瓜贾。特在此聲明:

  • 所有翻譯內容禁止商業(yè)網(wǎng)站轉載(禁止使用此內容牟利)
  • 歡迎elasticsearch使用者和愛好者轉載诺祸,但請注明出處。
  • 希望讀者可以通過打賞或者評論的方式支持我阐虚。

涉及到的章節(jié)如下
Document APIs - 文檔相關的 API
Search APIs - 查詢相關的API
Aggregations - 聚合
cat APIs - 查看相關的 API
Cluster APIs - 集群相關的APIS
Query DSL 結構化查詢語句
Mapping 映射
Analysis 分詞
Index Modules - 索引模塊

翻譯宗旨是序臂,使涉及到的Elasticsearch文檔內容 中英文無差別使用蚌卤∈凳可能不逐句翻譯,可能會加入自己的理解逊彭,可能會打亂順序咸灿,可能會合并多篇章節(jié)。

QQ群:163861494 侮叮。這是我維護的一個QQ群避矢,用以做搜索技術交流。你可以加入囊榜,獲取最即時的信息审胸。

————————— Wonderful Content Start ————————

elasticsearch cat API

介紹

所有的cat 命令接受一個查詢字符串參數(shù)help,來查看請求頭和他提供的信息卸勺。/_cat 命令會列出所有可用的命令

curl 10.248.200.95:9200/_cat
=^.^=
/_cat/allocation
/_cat/shards
/_cat/shards/{index}
/_cat/master
/_cat/nodes
/_cat/indices
/_cat/indices/{index}
/_cat/segments
/_cat/segments/{index}
/_cat/count
/_cat/count/{index}
/_cat/recovery
/_cat/recovery/{index}
/_cat/health
/_cat/pending_tasks
/_cat/aliases
/_cat/aliases/{alias}
/_cat/thread_pool
/_cat/plugins
/_cat/fielddata
/_cat/fielddata/{fields}
/_cat/nodeattrs
/_cat/repositories
/_cat/snapshots/{repository}

通用參數(shù)

Verbose
每一個命令都接受查詢字符串v來返回詳細的輸出

[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master
-XYVZvY8RBSgT_UTKnm4YA 10.248.200.95 10.248.200.95 95_new 
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master?v
id                     host          ip            node   
-XYVZvY8RBSgT_UTKnm4YA 10.248.200.95 10.248.200.95 95_new 

Help
help 將輸出相關的列砂沛,

[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master?help
id   |   | node id    
host | h | host name  
ip   |   | ip address 
node | n | node name  

headers
每一個命令接受一個查詢字符串h,指定返回哪些列

[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/nodes?h=ip,port,heapPercent,name
10.248.200.95 9300 46 95_new 

可以使用通配符返回相關的多個列

[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/thread_pool?h=ip,bulk.*
10.248.200.95 fixed 0 4 0 50 0 4 1845717 4 4 

格式化為數(shù)字

使用一些命令可以將一些類型格式化為數(shù)字來輸出曙求,比如byte,size,time 碍庵。這些類型默認的顯示格式對人類友好的映企。比如3.5mb 而不是3763212,這樣會影響排序静浴,當你需要排序的時候堰氓,可以修改。

舉個例子苹享,如果你想找到你集群中最大的索引(占用的磁盤最大)双絮,你可以使用/_cat/indices API來處理。你只需要做2件事

  • 1得问,關閉human 模式
  • 2掷邦,使用shell的sort命令
[etest@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/indices?bytes=b | sort -rnk8
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
105   948  105   948    0     0  86646      0 --:--:-- --:--:-- --:--:-- 94800
green open ware_index_20170306     1 0 13464943  408183 5262102838 5262102838 
green open ware_index_20170508     1 0  3856275  561897 2507469280 2507469280 
green open ware_index_20161124     1 0  4109687 1512573 2329827190 2329827190 
green open .marvel-es-1-2017.06.15 1 0   154923     120   51517665   51517665 
green open .marvel-es-1-2017.06.13 1 0   154924      96   51063984   51063984 
green open .marvel-es-1-2017.06.14 1 0   154923      72   50911784   50911784 
green open .marvel-es-1-2017.06.12 1 0   154923      37   50815402   50815402 
green open .marvel-es-1-2017.06.10 1 0   154923     120   50641339   50641339 
green open .marvel-es-1-2017.06.11 1 0   154887      48   49570329   49570329 
green open .marvel-es-1-2017.06.16 1 0    56158      36   18935038   18935038 
green open .kibana                 1 0        2       0      19918      19918 
green open .marvel-es-data-1       1 0        4       2      18084      18084 

指定響應類型為text、json椭赋、smile抚岗、yaml或者cbor

[etest@ip-10-248-200-95 ~]$ curl "10.248.200.95:9200/_cat/indices?format=json&pretty"
[ {
  "health" : "green",
  "status" : "open",
  "index" : ".marvel-es-1-2017.06.15",
  "pri" : "1",
  "rep" : "0",
  "docs.count" : "154923",
  "docs.deleted" : "120",
  "store.size" : "49.1mb",
  "pri.store.size" : "49.1mb"
}, {
  "health" : "green",
  "status" : "open",
  "index" : ".marvel-es-1-2017.06.14",
  "pri" : "1",
  "rep" : "0",
  "docs.count" : "154923",
  "docs.deleted" : "72",
  "store.size" : "48.5mb",
  "pri.store.size" : "48.5mb"
} ]

當前支持的格式有:text,json,smile,yaml,cbor
有些格式,也可以通過http請求頭Accept來指定哪怔。

% curl '192.168.56.10:9200/_cat/indices?pretty' -H "Accept: application/json"
[
  {
    "pri.store.size": "650b",
    "health": "yellow",
    "status": "open",
    "index": "twitter",
    "pri": "5",
    "rep": "1",
    "docs.count": "0",
    "docs.deleted": "0",
    "store.size": "650b"
  }
]

Sort

查詢字符串接收一個s參數(shù)宣蔚,可以指定排序方式,例如:desc,:asc认境,其中asc是默認的排序方式胚委。
例如s=column1,column2:desc,column3

GET _cat/templates?v&s=order:desc,template
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市叉信,隨后出現(xiàn)的幾起案子亩冬,更是在濱河造成了極大的恐慌,老刑警劉巖硼身,帶你破解...
    沈念sama閱讀 210,978評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件硅急,死亡現(xiàn)場離奇詭異,居然都是意外死亡佳遂,警方通過查閱死者的電腦和手機营袜,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,954評論 2 384
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來丑罪,“玉大人荚板,你說我怎么就攤上這事》砸伲” “怎么了跪另?”我有些...
    開封第一講書人閱讀 156,623評論 0 345
  • 文/不壞的土叔 我叫張陵,是天一觀的道長煤搜。 經(jīng)常有香客問我免绿,道長,這世上最難降的妖魔是什么宅楞? 我笑而不...
    開封第一講書人閱讀 56,324評論 1 282
  • 正文 為了忘掉前任针姿,我火速辦了婚禮袱吆,結果婚禮上,老公的妹妹穿的比我還像新娘距淫。我一直安慰自己绞绒,他們只是感情好,可當我...
    茶點故事閱讀 65,390評論 5 384
  • 文/花漫 我一把揭開白布榕暇。 她就那樣靜靜地躺著蓬衡,像睡著了一般。 火紅的嫁衣襯著肌膚如雪彤枢。 梳的紋絲不亂的頭發(fā)上狰晚,一...
    開封第一講書人閱讀 49,741評論 1 289
  • 那天,我揣著相機與錄音缴啡,去河邊找鬼壁晒。 笑死,一個胖子當著我的面吹牛业栅,可吹牛的內容都是我干的秒咐。 我是一名探鬼主播,決...
    沈念sama閱讀 38,892評論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼碘裕,長吁一口氣:“原來是場噩夢啊……” “哼携取!你這毒婦竟也來了?” 一聲冷哼從身側響起帮孔,我...
    開封第一講書人閱讀 37,655評論 0 266
  • 序言:老撾萬榮一對情侶失蹤雷滋,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后文兢,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體晤斩,經(jīng)...
    沈念sama閱讀 44,104評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,451評論 2 325
  • 正文 我和宋清朗相戀三年禽作,在試婚紗的時候發(fā)現(xiàn)自己被綠了尸昧。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片揩页。...
    茶點故事閱讀 38,569評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡旷偿,死狀恐怖,靈堂內的尸體忽然破棺而出爆侣,到底是詐尸還是另有隱情萍程,我是刑警寧澤,帶...
    沈念sama閱讀 34,254評論 4 328
  • 正文 年R本政府宣布兔仰,位于F島的核電站茫负,受9級特大地震影響,放射性物質發(fā)生泄漏乎赴。R本人自食惡果不足惜忍法,卻給世界環(huán)境...
    茶點故事閱讀 39,834評論 3 312
  • 文/蒙蒙 一潮尝、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧饿序,春花似錦勉失、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,725評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至咽弦,卻和暖如春徒蟆,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背型型。 一陣腳步聲響...
    開封第一講書人閱讀 31,950評論 1 264
  • 我被黑心中介騙來泰國打工段审, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人闹蒜。 一個月前我還...
    沈念sama閱讀 46,260評論 2 360
  • 正文 我出身青樓戚哎,卻偏偏與公主長得像,于是被迫代替她去往敵國和親嫂用。 傳聞我的和親對象是個殘疾皇子型凳,可洞房花燭夜當晚...
    茶點故事閱讀 43,446評論 2 348

推薦閱讀更多精彩內容