Kibana 汉化相关配置 i18n 及版本问题

桃扇骨 2023-07-20 13:45 27阅读 0赞

## 最终结论 ##

Kibana从`6.7.0`开始，可以通过修改`kibana.yml`中的配置项`i18n.locale: "zh-CN"`，然后重启Kibana完成汉化。  
NOTE: 是`zh-CN`而不是`zh_CN`。

因为从这个版本开始，Kibana使用的node模块中多了如下内容(所以最好确认一下有没有这个语言包)：  
`kibana-6.7.0-linux-x86_64/node_modules/x-pack/plugins/translations/translations/zh-CN.js`

而`i18n.locale`这个配置，是从`6.5.0`就有的。(6.5.0之前的版本中，一直是`i18n.defaultLocale`这个配置项)

以下是我测试的过程，其中有很错误的观点，可以略过不看。

## 两个不同的配置项和版本的对应问题测试 ##

*  Search  
    经查阅，网上有很多种说法，让我对**kibana究竟是从哪个版本开始可以汉化的/有`i18n.locale`这个配置项的**有了疑惑。  
    ![在这里插入图片描述][20200402075510672.png_pic_center]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center]我现在假定当kibana配置文件中的`i18n.defaultLocale`在某个版本更新为`i18n.locale`之后，就可以通过修改配置的方式汉化UI界面。  
    那么下一步就是验证。
 *  下载6.0.0~7.0.0版本的Kibana压缩包  
    命令行，断点续传下载　`wget -c https://artifacts.elastic.co/downloads/kibana/kibana-6.4.3-linux-x86_64.tar.gz` 其中`-c`为continue的意思，版本号`6.4.3`的值可以替换。  
    推荐`-c` \+ 睡觉的时候下载(ES官网下载文件很慢)。

wuyujin@ubuntu18:~/Downloads/kibana_tar$ # 查看下载好的kibana压缩包
    wuyujin@ubuntu18:~/Downloads/kibana_tar$ ll
    total 2.4G
    drwxr-xr-x 2 wuyujin wuyujin 4.0K 4月   2 07:16 ./
    drwxr-xr-x 4 wuyujin wuyujin 4.0K 4月   2 07:25 ../
    -rwxrwxrwx 1 wuyujin wuyujin  63M 3月  10 23:42 kibana-6.1.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin  62M 3月   6 07:43 kibana-6.1.1-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin  80M 5月  15  2018 kibana-6.2.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 196M 6月  13  2018 kibana-6.3.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 180M 8月  23  2018 kibana-6.4.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 180M 9月  18  2018 kibana-6.4.1-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 180M 10月  2  2018 kibana-6.4.2-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 225M 11月  6  2018 kibana-6.4.3-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 197M 11月 14  2018 kibana-6.5.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 173M 1月  29  2019 kibana-6.6.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 173M 2月  19  2019 kibana-6.6.1-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 173M 3月  12  2019 kibana-6.6.2-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 178M 3月  26  2019 kibana-6.7.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 178M 5月  20  2019 kibana-6.8.0-linux-x86_64.tar.gz*
    -rwxrwxrwx 1 wuyujin wuyujin 160M 4月  10  2019 kibana-7.0.0-linux-x86_64.tar.gz*

*  创建单独的文件夹，用于存放解压后的文件夹 `mkdir ../kibana_dir/`
 *  遍历所有kibana的压缩包，解压到准备好的文件夹内

for file in `ls`
    do
      tar -zxf $file -C ../kibana_dir/
    done

*  进入解压后的目录，遍历各个目录，使用grep查看各个版本的配置  
    `cd ../kibana_dir/`

for file in `ls`
    do
      echo -n "$file "
      grep "i18n" ./$file/config/kibana.yml
    done

执行流程：

wuyujin@ubuntu18:~/Downloads/kibana_tar$ cd ../kibana_dir/
    wuyujin@ubuntu18:~/Downloads/kibana_dir$ for file in `ls`
    > do
    >   echo -n "$file "
    >   grep "i18n" ./$file/config/kibana.yml
    > done
    kibana-6.1.0-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.1.1-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.2.0-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.3.0-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.4.0-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.4.1-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.4.2-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.4.3-linux-x86_64  #i18n.defaultLocale: "en"
    kibana-6.5.0-linux-x86_64  #i18n.locale: "en"
    kibana-6.6.0-linux-x86_64  #i18n.locale: "en"
    kibana-6.6.1-linux-x86_64  #i18n.locale: "en"
    kibana-6.6.2-linux-x86_64  #i18n.locale: "en"
    kibana-6.7.0-linux-x86_64  #i18n.locale: "en"
    kibana-6.8.0-linux-x86_64  #i18n.locale: "en"
    kibana-7.0.0-linux-x86_64  #i18n.locale: "en"
    wuyujin@ubuntu18:~/Downloads/kibana_dir$

可见：**kibana是从6.4.3之后，从6.5.0版本开始，更新了i18n的相关配置项**

*  Shell运行截图  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 1]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 2]可以看到，从`6.5.0`版本开始，kibana的i18n配置项有了更新。

## Others ##

*  EK版本匹配  
    要启动某个版本的Kibana，必须保证他能找到对应版本的ElasticSearch。否则Kibana报错。
 *  两种配置项的注释  
    我知道`i18n`的配置在配置文件末尾，所以直接`tail`。

wuyujin@ubuntu18:~/Downloads/kibana_dir$ tail kibana-6.1.0-linux-x86_64/config/kibana.yml 
    # and all requests.
    #logging.verbose: false
    
    # Set the interval in milliseconds to sample system and process performance
    # metrics. Minimum is 100ms. Defaults to 5000.
    #ops.interval: 5000
    
    # The default locale. This locale can be used in certain circumstances to substitute any missing
    # translations.
    #i18n.defaultLocale: "en"
    wuyujin@ubuntu18:~/Downloads/kibana_dir$ tail kibana-6.5.0-linux-x86_64/config/kibana.yml 
    # Set the value of this setting to true to log all events, including system usage information
    # and all requests.
    #logging.verbose: false
    
    # Set the interval in milliseconds to sample system and process performance
    # metrics. Minimum is 100ms. Defaults to 5000.
    #ops.interval: 5000
    
    # Specifies locale to be used for all localizable strings, dates and number formats.
    #i18n.locale: "en"
    wuyujin@ubuntu18:~/Downloads/kibana_dir$

*  Links

[https://www.elastic.co/guide/en/kibana/current/i18n-settings-kb.html][https_www.elastic.co_guide_en_kibana_current_i18n-settings-kb.html]  
[https://github.com/elastic/kibana/tree/master/packages/kbn-i18n\#localization-files][https_github.com_elastic_kibana_tree_master_packages_kbn-i18n_localization-files]

## Error ##

6.5.0待验证。验证后马上更新。

## Fix ##

5.7.0之后，Kibana自带汉化。

wuyujin@ubuntu18:~/Downloads/kibana_dir$ ll
    total 68K
    drwxr-xr-x 17 wuyujin wuyujin 4.0K 4月   2 07:30 ./
    drwxr-xr-x  5 wuyujin wuyujin 4.0K 4月   2 08:18 ../
    drwxr-xr-x 12 wuyujin wuyujin 4.0K 12月 12  2017 kibana-6.1.0-linux-x86_64/
    drwxr-xr-x 12 wuyujin wuyujin 4.0K 12月 18  2017 kibana-6.1.1-linux-x86_64/
    drwxr-xr-x 12 wuyujin wuyujin 4.0K 2月   2  2018 kibana-6.2.0-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 6月  12  2018 kibana-6.3.0-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 8月  18  2018 kibana-6.4.0-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 9月  14  2018 kibana-6.4.1-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 9月  26  2018 kibana-6.4.2-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 10月 31  2018 kibana-6.4.3-linux-x86_64/
    drwxr-xr-x 11 wuyujin wuyujin 4.0K 11月 10  2018 kibana-6.5.0-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:28 kibana-6.6.0-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:29 kibana-6.6.1-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:29 kibana-6.6.2-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:29 kibana-6.7.0-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:30 kibana-6.8.0-linux-x86_64/
    drwxr-xr-x 13 wuyujin wuyujin 4.0K 4月   2 07:30 kibana-7.0.0-linux-x86_64/
    wuyujin@ubuntu18:~/Downloads/kibana_dir$ tree kibana-6.7.0-linux-x86_64/node_modules/x-pack/plugins/translations/ -h
    kibana-6.7.0-linux-x86_64/node_modules/x-pack/plugins/translations/
    ├── [ 532]  index.js
    └── [4.0K]  translations
        └── [791K]  zh-CN.json
    
    1 directory, 2 files
    wuyujin@ubuntu18:~/Downloads/kibana_dir$ tree kibana-6.6.2-linux-x86_64/node_modules/x-pack/plugins/translations/ -h
    kibana-6.6.2-linux-x86_64/node_modules/x-pack/plugins/translations/ [error opening dir]
    
    0 directories, 0 files
    wuyujin@ubuntu18:~/Downloads/kibana_dir$ ll  kibana-6.6.2-linux-x86_64/node_modules/x-pack/plugins/translations/
    ls: cannot access 'kibana-6.6.2-linux-x86_64/node_modules/x-pack/plugins/translations/': No such file or directory
    wuyujin@ubuntu18:~/Downloads/kibana_dir$

[20200402075510672.png_pic_center]: /images/20230528/61f4357f962a496d925c79a4a726031a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center]: /images/20230528/812c2170123146d0add3493b9b491922.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20230528/8c44a294004a4aa490a01c6852927ec0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20230528/7edcf47199d74a5296e768cdc57da924.png
[https_www.elastic.co_guide_en_kibana_current_i18n-settings-kb.html]: https://www.elastic.co/guide/en/kibana/current/i18n-settings-kb.html
[https_github.com_elastic_kibana_tree_master_packages_kbn-i18n_localization-files]: https://github.com/elastic/kibana/tree/master/packages/kbn-i18n#localization-files