Personalizando o Kibana 7.x
Um guia rápido mostrando como fazer pequenas personalizações no Kibana
O Kibana é uma ferramenta open source para visualização de dados na ELK Stack (Elasticsearch, Logstash, Kibana). Essa ferramenta permite que você gere diferentes tipos de visualizações (gráficos, mapas, etc), podendo ou não serem relacionadas entre si e vindo de diferentes fontes de dados (banco, API, servidor, etc).
Minha intenção nesse artigo é mostrar algumas pequenas personalizações que você pode fazer no Kibana, tanto para conhecer mais a ferramenta, como para deixar ele mais parecido com a sua “cara” ou a da sua empresa.
Irei mostrar como modificar:
- Title (título da página);
- Favicon;
- Logo do menu de navegação;
- Tela de carregamento.
Realizei as alterações nas versões 7.4 e 7.5, porém esse guia deve servir para todas as versão 7.x.
Personalizações
A primeira coisa que você deve fazer é descobrir onde o Kibana está na sua máquina. Como estou usando Ubuntu 18.04, o Kibana encontra-se em /usr/share/, sendo o caminho completo /usr/share/kibana/. Para não ficar muito extenso, usarei apenas kibana/ para indicar todo o caminho. Lembre-se que o Kibana, por padrão, estará no endereço http://localhost:5601/.
Title
Abra o arquivo kibana/src/legacy/ui/ui_render/views/chrome.pug, mais ou menos da linha 7 terá a definição do title da página, basta alterar e salvar.
Favicon
Basta acessar a pasta kibana/src/legacy/ui/public/assets/favicons/. Nessa pasta terá vários arquivos de imagens (.ico, .png e .svg), basta alterar todas essas imagens para a imagem desejada. As imagens novas devem ter o mesmo nome e dimensão da imagem que esta substituindo.
O site que usei para redimensionar a imagem foi o Online image Resizer.
Logo do menu de navegação
Essa modificação, na minha opinião, é a mais problemática. Teve duas formas que encontrei de realizar essa modificação, sendo que apenas uma funcionou comigo, porém mesmo assim irei citar as duas visto que qualquer uma delas pode funcionar para você.
A primeira forma consiste em modificar o arquivo kibana/built_assets/dlls/icon.logo_kibana-js.bundle.dll.js. Perceba que o arquivo esta minify, para unminify eu usei o site Unminify JS, o trecho de código que gera a logo do menu de navegação é:
Basta você alterar esse trecho de código e colocar em minify novamente, salvar o arquivo e pronto, modificação realizada.
Por algum motivo, seja intervenção divina ou ignorância minha, essa solução não funcionou comigo. Portanto agora irei mostrar a forma que fiz para alterar a logo do menu de navegação.
Vá até a pasta kibana/node_modules/@elastic/eui/dist, nela terá os arquivos dos temas do Kibana. Os arquivos de estilo de tema são eui_theme_dark.css e eui_theme_light.css, você irá realizar a mesma modificação em ambos os arquivos, porém caso sempre utilize apenas um único tema, basta alterar apenas seu respectivo arquivo.
Abrindo o arquivo do tema que deseja alterar, procure pela classe .euiHeaderLogo. Nessa classe, adicione os atributos background-image e background-size, para colocar a imagem que deseja e ajustar o seu tamanho, respectivamente. Para o background-image, eu utilizei uma imagem svg convertida para base64 usando o site Base64 Image Encoder. Para o background-size, você tem duas alternativas: cover e contain, clique aqui para entender melhor as diferenças entre eles. Depois procure por .euiHeaderLogo:focus e apague/comente o atributo background.
Agora precisamos ocultar a logo padrão do Kibana. Procure pela classe .euiHeaderLogo__icon e mude o atributo opacity para 0. Caso isso não funcione, você pode procurar pela classe .euiIcon e mudar o atributo display para none.
Tela de carregamento
Abra o arquivo kibana/src/legacy/ui/ui_render/views/chrome.pug, procure pela classe .kibanaWelcomeLogo, no atributo background-image coloque a sua imagem em base64.
Após isso vá no arquivo ui_app.pug na mesma pasta. Realize a mesma alteração anterior na classe .kibanaWelcomeLogo. Depois procure por kbn_loading_message, altere o valor em defaultMessage (encontra-se ao final da classe) para a mensagem que você bem queira que apareça na tela de carregamento.
