Perguntas e soluções comuns para o uso do console do Kibana com o Alibaba Cloud Elasticsearch.
Como faço login no console do Kibana? Quais são o nome de usuário e a senha?
Para que serve a senha da conta elastic no console do Kibana?
Posso acessar serviços na rede pública pelo console do Kibana?
O Kibana falha ao iniciar e reporta o erro "Kibana server is not ready yet". Como resolvo isso?
O Kibana reporta o erro "Maximum call stack size exceeded". Como resolvo isso?
O que fazer se eu não conseguir fazer login no Kibana, mas precisar limpar dados?
Não consigo acessar o Dev Tools no Kibana. Como resolvo isso?
Como visualizo informações de shards e índices no console do Kibana?
Posso configurar o tamanho dos dados ao exportar logs como arquivo CSV do Kibana?
O que fazer se eu receber um erro 500 ao acessar o Kibana após ativar o X-Pack?
O que fazer se curingas falharem ao corresponder a índices durante a criação de um index pattern?
Não consigo mais acessar o Kibana, mas o Elasticsearch ainda está acessível. Como resolvo isso?
O que fazer se eu não conseguir acessar o Kibana por meio de um proxy Nginx?
Por que não consigo acessar o Kibana usando um nome de domínio personalizado com registro CNAME?
Como excluo um ou vários endereços IP usando KQL na página de consulta de logs do Kibana?
Fazer login no console do Kibana
Faça login conforme descrito em Log on to the Kibana console, utilizando o nome de usuário padrão elastic e a senha definida durante a criação da instância do Elasticsearch. Para redefinir uma senha esquecida, consulte Reset the access password of an instance.
Finalidade da senha da conta elastic
A conta elastic é a conta de administrador do Elasticsearch e possui permissões completas de gerenciamento de cluster.
A senha da conta elastic é necessária para acessar uma instância do Elasticsearch por meio de:
Uma API ou SDK.
O console do Kibana.
Como modifico a lista de permissões de acesso do Kibana?
O Alibaba Cloud Elasticsearch permite modificar as listas de permissões de acesso à rede pública e interna do Kibana. Utilize o console ou uma operação de API:
Pelo console: Faça login no console do Alibaba Cloud Elasticsearch e acesse a página Configuration and Management > Data Visualization da instância de destino. Na seção Kibana, modifique a lista de permissões de acesso à rede pública ou interna. Para obter etapas detalhadas, consulte Connect to a cluster using Kibana.
Por chamada de API: Execute a operação UpdateKibanaWhiteIps para atualizar a lista de permissões de acesso à rede pública ou interna do Kibana da instância.
A lista de permissões aceita um único endereço IP ou um bloco CIDR (por exemplo, 192.168.0.1 ou 192.168.0.0/24). Separe vários endereços IP com vírgulas (,). Se o botão Modify Configuration no Kibana estiver desativado, geralmente significa que a instância do Elasticsearch não está em estado normal. Aguarde a normalização da instância e tente novamente.
Acessar serviços públicos pelo console do Kibana
Não. O console do Kibana acessa apenas serviços dentro de uma VPC, e não serviços de rede pública como Baidu Maps ou Amap. A lista de permissões de endereços IP públicos controla o acesso de entrada ao Kibana, e não o acesso de saída do Kibana para a rede pública.
Gerenciamento de permissões no console do Kibana
Crie usuários e funções dedicados em vez de usar a conta elastic para operações diárias. Use Elasticsearch X-Pack to manage roles and control user permissions.
Evite utilizar a conta elastic para serviços de busca. O vazamento da senha elastic expõe todo o cluster a riscos de segurança.
Altere a senha elastic com cautela. Caso os serviços utilizem essa conta, a redefinição da senha causará falhas de autenticação e interrupções no serviço.
Erro "Kibana server is not ready yet"
|
Causa possível |
Solução |
|
Existem múltiplos índices de sistema do Kibana ou a estrutura de dados foi alterada. |
Exclua os índices que começam com Aviso
A exclusão do índice |
|
O índice |
Execute |
|
O cluster do Elasticsearch está sobrecarregado. |
Verifique os dados de monitoramento do cluster. Causas e soluções possíveis:
|
|
O nó do Kibana está sobrecarregado. |
Se o erro persistir, o nó do Kibana pode estar sobrecarregado. Reinicie o nó do Kibana ou atualize suas especificações. Restart a cluster or node e Upgrade a cluster. Importante
Um nó do Kibana com 1 vCPU e 2 GiB de memória não é adequado para ambientes de produção. Atualize-o assim que possível. |
Erro "Maximum call stack size exceeded"
-
Causa
A instância apresenta estado anormal. O alto uso de memória heap causa tempos limite nas requisições.
-
Solução
Reduza o tamanho da requisição bulk ou upgrade the cluster.
Limpar dados sem acesso ao Kibana
Utilize uma API para acessar a instância e limpar os dados. Use a curl command to access and manage an Alibaba Cloud Elasticsearch cluster. Por exemplo, consulte todos os índices, identifique o índice alvo e exclua-o:
-
Consultar todos os índices no cluster
curl -u elastic:<yourEsPassword> -XGET 'http://es-cn-7pp2auqzk0023****.public.elasticsearch.aliyuncs.com:9200/_cat/indices?v' -
Excluir um índice
curl -u elastic:<yourEsPassword> -XDELETE 'http://es-cn-7pp2auqzk0023****.public.elasticsearch.aliyuncs.com:9200/<yourIndex>'
Impossível acessar o Dev Tools
Verifique se a especificação do nó do Kibana é de 1 vCPU e 2 GiB. Essa configuração pode apresentar instabilidade e serve apenas para testes. Upgrade the cluster assim que possível.
Visualizar informações de shards e índices
Execute o comando
GET _cat/indices?vpara visualizar informações de índice eGET _cat/shards?vpara visualizar informações de shard.Na página Monitoring, visualize o status de fragmentação dos índices em um nó específico, incluindo o uso de memória heap.
Erro "You do not have permission to manage users"
Este erro geralmente aparece como: "You do not have permission to manage users. Please contact your administrator."
Realize a solução de problemas conforme abaixo:
Execute
GET _licenseno console do Kibana para verificar se a licença expirou.Execute
GET /_cat/indices?vpara verificar a existência de múltiplos índices .security-*. Se houver vários (possivelmente devido a uma migração ou sincronização completa de índices), exclua os índices .security-* mais antigos e mantenha apenas o mais recente.
Suporte a plugins personalizados
Não. Versões do Kibana anteriores à 7.0 suportam apenas os plugins padrão do console. O Kibana 7.0 e versões posteriores não oferecem suporte a nenhum plugin.
Versões compatíveis para alteração de idioma
Somente o Kibana 6.7.0 e versões posteriores permitem a troca de idioma. O console suporta inglês e chinês. Modifique a configuração Language para alterar o idioma. Configure the language of the Kibana console.
O IP privado do Kibana está fora da VPC
O Kibana V7.16 e alguns clusters V7.10 incluem um serviço de agente de camada 7 que evita reinicializações durante a substituição de certificados HTTPS. O endpoint privado resolve para esse serviço de agente. Essa arquitetura passou por revisão de segurança do Alibaba Cloud e não afeta a funcionalidade do Kibana.
Configurar tamanho de dados para exportações CSV
O limite padrão de tamanho de exportação CSV é de 10.485.760 bytes (10 MB), controlado pelo parâmetro xpack.reporting.csv.maxSizeBytes. Dados que excedem esse limite são truncados. O parâmetro server.maxPayloadBytes também limita o tamanho máximo do payload para requisições ao servidor do Kibana. O Alibaba Cloud Elasticsearch não permite modificar os parâmetros xpack.reporting.csv.maxSizeBytes ou server.maxPayloadBytes; eles permanecem com os valores padrão para garantir a estabilidade do cluster.
Caso precise exportar dados que excedam o limite padrão, considere as seguintes alternativas:
Exporte os dados em lotes menores aplicando filtros mais específicos ou intervalos de tempo mais curtos no Kibana.
Utilize o Logstash para exportar grandes conjuntos de dados. O Logstash oferece tamanhos de lote e destinos de saída configuráveis, sendo ideal para cenários de exportação de dados em grande escala.
Instalar plugins do Kibana
O que fazer ao receber um erro 500 ao acessar o Kibana após ativar o X-Pack?
Ativar o X-Pack no seu cluster do Elasticsearch pode causar um erro 500 ao acessar o Kibana.
-
Causa
Após a ativação do X-Pack, o cluster precisa de tempo para distribuir a configuração para todos os nós. Durante esse período, o Kibana não consegue iniciar e retorna um erro 500. Reinicie o Kibana para que a configuração entre em vigor.
-
Solução
Aguarde o cluster concluir a distribuição da configuração do X-Pack. Esse processo geralmente leva alguns minutos.
Após a conclusão da distribuição da configuração, reinicie o nó do Kibana pelo console do Elasticsearch. Na página de gerenciamento do cluster, localize o nó do Kibana e reinicie-o.
O que fazer quando curingas falham ao corresponder a índices na criação de um index pattern?
Ao criar um index pattern no Kibana, o padrão com curinga pode falhar ao corresponder a qualquer índice.
-
Causa
O padrão com curinga não corresponde ao prefixo real dos nomes dos índices. Por exemplo, se o nome do índice for
owl_resell_20231001, o padrãoresell_*não corresponderá ao índice porque o prefixo não está alinhado. Useowl_resell*em vez disso. -
Solução
Verifique os nomes reais dos seus índices. Execute
GET _cat/indices?vno console Dev Tools do Kibana para listar todos os índices.Certifique-se de que o padrão com curinga corresponda ao prefixo real dos nomes dos índices. Por exemplo, use
owl_resell*para corresponder aos índices chamadosowl_resell_20231001eowl_resell_20231002. Não useresell_*, pois esse padrão não corresponde ao prefixo completo.Depois que o padrão corresponder com sucesso aos índices, selecione o campo de tempo correto para os índices na próxima etapa para concluir a criação do index pattern.
O que fazer se o Kibana estiver inacessível ou tornar-se inacessível após uma atualização de certificado?
Se você não conseguir acessar o Kibana, realize a solução de problemas com base nos seguintes cenários:
-
Problema de sincronização de tempo em rede privada
Se a hora do sistema do seu dispositivo cliente, como um desktop cloud, não estiver sincronizada com a hora do servidor, o Kibana poderá ficar inacessível pela rede privada. Verifique e corrija a hora do sistema do dispositivo cliente para garantir que esteja sincronizada com a hora do servidor.
-
Atualização de certificado
Após uma atualização de certificado HTTPS para o cluster do Elasticsearch, o Kibana pode ficar inacessível até que a nova configuração do certificado entre em vigor. Reinicie o nó do Kibana pelo console do Elasticsearch para aplicar o novo certificado.
-
Solução de problemas geral
Se o problema persistir, execute as seguintes verificações:
Verifique se a instância do Elasticsearch está em estado íntegro.
Confirme se a lista de permissões de endereços IP está configurada corretamente e inclui o endereço IP do seu cliente.
Limpe o cache do navegador e tente novamente.
Incompatibilidade de timestamp entre Discover e Elasticsearch
A interface do Kibana Discover exibe o campo @timestamp em UTC por padrão, enquanto os documentos do Elasticsearch armazenam timestamps na hora local. Resolva essa incompatibilidade da seguinte forma:
Para novos dados: Altere a configuração
dateFormat:tzna página Advanced Settings do Kibana.Para dados existentes: Utilize a Reindex API para atualizar os timestamps.
Kibana inacessível, mas Elasticsearch acessível
Reinicie o nó do Kibana. Na página Basic Information da sua instância do Elasticsearch, na seção Node Visualization, passe o mouse sobre a luz de status do Kibana Node e clique em Restart.
Impossível acessar o Kibana por meio de um proxy Nginx
Configurações inadequadas de rede ou de proxy podem impedir o acesso ao Kibana através de um proxy Nginx.
Se não for possível acessar o Kibana por meio de um proxy Nginx, siga estas etapas de solução de problemas:
-
Verifique a conectividade de rede.
Verifique a lista de permissões de endereços IP: Garanta que o endereço IP do proxy Nginx ou do ECS cliente esteja na lista de permissões de endereços IP do Kibana. Configure conforme seu ambiente de rede. Connect to a cluster through Kibana.
-
(Opcional) Verifique as regras do grupo de segurança: Realize esta etapa se sua instância do Alibaba Cloud Elasticsearch estiver implantada com a arquitetura Cloud-native Control Architecture (v3) e você estiver acessando-a por uma rede privada.
No grupo de segurança do Kibana: Para regras de entrada, garanta que o tráfego do endereço IP do servidor Nginx para a porta do Kibana (por exemplo, 5601) seja permitido. Nenhuma configuração específica é necessária para regras de saída.
No grupo de segurança do servidor Nginx: Para regras de saída, garanta que o tráfego para o endereço IP e a porta do serviço Kibana (por exemplo, 5601) seja permitido.
NotaConfigure as definições com base no seu ambiente de rede e nos números de porta reais.
-
Verifique a configuração de proxy.
Confirme se a diretiva proxy_pass no seu arquivo de configuração do Nginx aponta para o endereço correto do serviço Kibana, incluindo protocolo, nome de domínio e número da porta.
-
Verifique se o arquivo de configuração do Nginx reescreve o cabeçalho de requisição Host (por exemplo, proxy_set_header Host XXX). Se o cabeçalho
Hostfor modificado, o Kibana poderá falhar ao identificar corretamente a origem da requisição. Resolva esse problema de uma das seguintes maneiras:Método 1: Comente ou exclua a configuração proxy_set_header Host.
Método 2: Se desejar manter a configuração Host, defina o cabeçalho Host como o nome de domínio original do Kibana.
Exemplo: Nginx configuration file.
-
Ajuste o método de autenticação do Kibana.
Para instâncias com arquitetura cloud-native acessadas por rede privada através de um proxy, utilize apenas autenticação por nome de usuário e senha. Connect to a cluster through Kibana.
-
Reinicie o proxy Nginx.
-
Após modificar a configuração, execute o seguinte comando para verificar erros de sintaxe no arquivo de configuração do Nginx:
sudo nginx -t -
Execute o seguinte comando para aplicar as alterações reiniciando o serviço Nginx:
sudo nginx -s reload
-
Impossível acessar o Kibana usando um registro CNAME
Não é possível usar um nome de domínio personalizado com um registro CNAME para acessar o Kibana em uma instância do Elasticsearch com a arquitetura Cloud-native Control Architecture (v3). Para usar um nome de domínio personalizado, access Kibana through an Nginx proxy.
Visualize a página Basic Information da instância para verificar seu Control Architecture Type.
Como excluo um ou vários endereços IP usando KQL na página de consulta de logs do Kibana?
Na página Discover ou na página de consulta de logs do Kibana, utilize a palavra-chave NOT na KQL (Kibana Query Language) para excluir documentos que correspondam a um valor de campo especificado. Essa palavra-chave suporta exclusões de valor único e de múltiplos valores.
-
Para excluir um único endereço IP, use o formato
NOT <field>: "<IP>". Por exemplo:NOT remote: "10.1.146.35" -
Para excluir vários endereços IP, encadeie múltiplas condições
NOTcomAND. Por exemplo:NOT remote: "10.1.146.35" AND NOT remote: "10.1.150.19"
Não adicione números de porta aos endereços IP e conecte múltiplas condições de exclusão com AND.
A KQL não suporta sintaxes como no <field>:. O token no é tratado como um termo de busca comum e não exclui nenhum documento. Sempre utilize a palavra-chave NOT em maiúsculas.
Para mais informações sobre a sintaxe KQL, consulte Kibana Query Language na documentação oficial do Kibana.