Elasticsearch:Conectar a um cluster via Kibana

Conta e método de autenticação do Kibana

Fazer login no Kibana via rede pública (v2/v3)

1. Faça login no console do Alibaba Cloud Elasticsearch e acesse a página Basic Information da instância desejada.

2. No painel de navegação à esquerda, clique em Configuration and Management > > Data Visualization. Na seção Kibana, clique em Modify Configuration.

3. Na seção Network Access Configuration, configure a Public IP Address Whitelist e o Authentication Method for Public Network Access.

   • Configure a Public IP Address Whitelist: Por padrão, a lista de permissões de acesso público é definida como 127.0.0.1, o que nega acesso de todos os endereços IPv4. Para acessar o Kibana, adicione o endereço IP público do seu dispositivo à lista de permissões.

     • Obtenha o endereço IP necessário conforme o cenário.

       Cenário	Endereço IP necessário	Método
       Acessar o Kibana de um dispositivo local pela rede pública.	O endereço IP público do dispositivo local. Nota Se o dispositivo local estiver em uma rede doméstica ou LAN corporativa, adicione o endereço IP de saída público da LAN.	Execute o comando curl ipinfo.io/ip para consultar o endereço IP público do dispositivo local.
       Acessar o Kibana de uma instância ECS pela rede pública.	Se a instância ECS e o cluster ES estiverem em VPCs diferentes, acesse o Kibana usando o endereço IP público da instância ECS. Nesse caso, adicione o endereço IP público da instância ECS à lista de permissões pública do Kibana.	Faça login no console ECS e visualize o endereço IP público da instância na lista de instâncias.

     • Na seção Public IP Address Whitelist, clique em Edit.

     • Clique em Configure ao lado do grupo default e adicione a lista de permissões de IP na caixa de diálogo exibida.

       Você também pode clicar em Add a new IP whitelist group para criar um grupo com nome personalizado. Os grupos servem apenas para gerenciar endereços IP e não afetam as permissões de acesso.

       Tipo de configuração	Formato e valores de exemplo	Notas importantes
       Formato de endereço IPv4	IP único: 192.168.0.1 Bloco CIDR: 192.168.0.0/24. Recomendamos consolidar endereços IP individuais em um bloco CIDR. Um único cluster pode ter até 300 endereços IP ou blocos CIDR. Separe múltiplas entradas com vírgula (,) sem adicionar espaços antes ou depois dela.	0.0.0.0/0: Permite todo o acesso IPv4. Importante Recomendamos fortemente não configurar 0.0.0.0/0. Essa configuração representa alto risco de segurança. Alguns clusters e regiões não suportam 0.0.0.0/0. As informações exibidas na UI ou nas mensagens de erro prevalecem.
       Formato de endereço IPv6 (Suportado apenas para clusters de arquitetura v2 na região China (Hangzhou))	IP único: 2401:XXXX:1000:24::5 Bloco CIDR: 2401:XXXX:1000::/48 Um único cluster pode ter até 300 endereços IP ou blocos CIDR. Separe múltiplas entradas com vírgula (,) sem adicionar espaços antes ou depois dela.	::1: Bloqueia acesso de todos os endereços IPv6. ::/0: Permite todo o acesso IPv6 Importante Recomendamos fortemente não configurar ::/0, pois representa alto risco. Algumas versões de cluster não suportam ::/0. Consulte a UI do console ou as mensagens de erro para confirmação.

     • Após concluir a configuração, clique em OK.

   • Configure o Authentication Method for Public Network Access:

     Para clusters de arquitetura v3, o método padrão é a autenticação de dois fatores: primeiro faça login com sua conta Alibaba Cloud e depois autentique-se com a senha da instância ES.

     Para clusters de arquitetura v2, a autenticação usa a senha de acesso à instância ES por padrão. Não é possível alterar essa configuração.

4. Retorne à seção Kibana e clique em Access over Internet. Na página de login do Kibana, insira seu nome de usuário e senha. Após o login bem-sucedido, você será direcionado ao console do Kibana para explorar seus dados ES.

   Alternativamente, insira o endpoint diretamente no navegador. Certifique-se de que o endereço IP do seu dispositivo esteja na lista de permissões pública do Kibana.

   • v2: https://es-{region-abbreviation}-{instance-id}-kibana.elasticsearch.aliyuncs.com:{port}

   • v3: https://es-{region-abbreviation}-{instance-id}-kibana.{full-region-id}.elasticsearch.aliyuncs.com:{port}

Fazer login no Kibana via rede privada (v3)

Na arquitetura v3, o acesso à rede privada ao Kibana vem desativado por padrão. Para ativá-lo, use o Alibaba Cloud PrivateLink e crie um endpoint dentro da sua VPC. O endpoint está incluído no service ES sem custo adicional.

resource "alicloud_elasticsearch_instance" "example" {
  enable_kibana_private_network     = true
  kibana_private_security_group_id  = "sg-xxx"
}

Exemplos de conexão

• O exemplo a seguir mostra como usar VNC para conectar remotamente a uma instância ECS (executando Windows) e depois acessar o Kibana usando o endpoint privado.

  Insira o endereço de rede privada do Kibana na barra de endereços do navegador, como https://es-<instance-id>-kibana.internal.elasticsearch.aliyuncs.com:5601.

  Insira seu nome de usuário e senha e clique em Log In. Recomendamos usar os recursos do Elasticsearch X-Pack no Kibana para criar funções e gerenciar permissões refinadas.

• O exemplo a seguir mostra como usar o Workbench para conectar remotamente a uma instância ECS e executar o seguinte comando para conectar ao Kibana usando o endpoint privado:

  curl.exe -u elastic:password! -k -I "https://es-cn-xxxxxxxxxxxxxxxxx-kibana.internal.elasticsearch.aliyuncs.com:5601/"

  Uma conexão bem-sucedida retorna as seguintes informações:

  PS C:\Windows\system32> curl.exe -u elastic:Dxxx! -k -I "https://es-cn-xxx.aliyuncs.com:5601/"
  HTTP/1.1 302 Found
  location: /spaces/enter
  kbn-name: es-cn-xxx58897574f-s8x5s
  kbn-license-sig: cxxx11d398939051305557700a08e
  cache-control: private, no-cache, no-store, must-revalidate
  content-length: 0
  Date: Tue, 16 Sep 2025 06:08:58 GMT
  Connection: keep-alive

Fazer login no Kibana via rede privada (v2)

Na arquitetura v2, o acesso à rede privada requer nós do Kibana com CPUs de pelo menos 2 núcleos e 4 GB de memória. Ative-o no console e adicione o endereço IP do seu dispositivo à lista de permissões privada antes de fazer login.

1. No painel de navegação à esquerda, clique em Data Visualization. Na área Kibana, clique em Modify Configuration.

2. Na seção Network Access Configuration, ative a chave Private Network Access e configure a lista de permissões de acesso.

   1. Para acessar o Kibana de uma instância ECS via rede privada, tanto a instância ECS quanto o cluster ES devem estar na mesma VPC. Faça login no console ECS e visualize o endereço IP privado da instância na lista de instâncias.

   2. Na seção Private IP Address Whitelist, clique em Edit. Adicione o endereço IP privado da instância ECS ao grupo padrão ou crie um novo grupo clicando em Add a new IP whitelist group.

      Importante

      Recomendamos fortemente não configurar 0.0.0.0/0, pois representa alto risco de segurança, e alguns clusters e regiões não suportam 0.0.0.0/0. Consulte a UI ou as mensagens de erro para confirmação.

3. O exemplo a seguir mostra como usar o Workbench para conectar remotamente a uma instância ECS e executar um comando para conectar ao Kibana usando seu endpoint privado:

   curl.exe -u elastic:password! -k -I "https://es-xx-xxxxxxxxxxxxxxxxx-kibana.internal.elasticsearch.aliyuncs.com:5601/"

   Uma conexão bem-sucedida retorna as seguintes informações:

   PS C:\Windows\system32> curl.exe -u elastic:xxx -k -I "https://es-xx-xxx...uncs.com:5601/"
   HTTP/1.1 302 Found
   location: /spaces/enter
   kbn-name: es-xx-rxxxaliyuncs.com
   kbn-license-sig: b8xxx9b417d0dd6db5ef538095d27
   cache-control: private, no-cache, no-store, must-revalidate
   content-length: 0
   Date: Tue, 16 Sep 2025 06:53:19 GMT
   Connection: keep-alive

Acessar o Kibana via proxy Nginx (exemplo v3)

Configurar o Kibana

Modifique configurações básicas do Kibana, como idioma de exibição e chaves de criptografia, na página de configuração do Kibana. Configurar chaves de criptografia habilita recursos empresariais como Alertas e AI Assistant.

1. Faça login no console do Alibaba Cloud Elasticsearch e acesse a página Basic Information da instância desejada.

2. No painel de navegação à esquerda, clique em Data Visualization. Na seção Kibana, clique em Modify Configuration.

3. Na seção Basic Configuration, clique em Modify Configuration.

4. No painel Modify Basic Configuration, modifique as seguintes configurações conforme necessário:

   Language: Altera o idioma de exibição do Kibana. O Kibana suporta chinês e inglês (padrão).xpack.security.encryptionKey: Criptografa informações de sessão do Kibana. Deve ser uma string de pelo menos 32 caracteres.xpack.encryptedSavedObjects.encryptionKey: Criptografa objetos salvos e habilita recursos como Alertas e Ações. Deve ser uma string de pelo menos 32 caracteres.xpack.reporting.encryptionKey: Criptografa dados sensíveis em relatórios do Kibana. Deve ser uma string de pelo menos 32 caracteres.Other Configuration: Adicione outras configurações do Kibana no formato YAML.

   Nota

   Se não tiver configurado essas chaves, clique em One-Click Generate para criá-las automaticamente.

5. Clique em OK.

FAQ

• P: Como distinguir entre as arquiteturas de implantação V2 e V3?

  R: Os clusters possuem dois modos de implantação de controle: cloud-native (v3) e básico (v2).

  Na página de detalhes da instância Elasticsearch, clique em Basic Information no painel de navegação à esquerda e visualize o campo Deployment Architecture no lado direito para verificar a versão da arquitetura de implantação da instância atual.

• P: Ativar o acesso público ou privado ao Kibana afeta o cluster ES?

  R: Não. Ativar o acesso público ou privado ao Kibana afeta apenas o Server Load Balancer (SLB) conectado ao Kibana.

  Nota

  Ativar o acesso privado ao Kibana pela primeira vez aciona uma reinicialização do nó do Kibana, mas não gera alterações no cluster ES.

• P: Adicionei um endereço IP à lista de permissões, mas ainda não consigo acessar o Kibana. O que devo fazer?

  R: Verifique os itens a seguir para solucionar o problema:

  • A instância ES deve estar em estado íntegro.

  • A configuração do endereço IP pode estar incorreta: Se acessar o service Kibana de um dispositivo local, visite www.cip.cc no navegador para verificar se o endereço IP obtido está na lista de permissões de acesso público do Kibana. Para permitir acesso à rede pública de todos os endereços IPv4, insira 0.0.0.0/0, incluindo a máscara de sub-rede /0. Inserir 0.0.0.0 sem a máscara de sub-rede deixa o endpoint inacessível e a conexão expira.

  • Se configurou uma lista de permissões de acesso para a instância ES, configure também uma lista de permissões de acesso público ou interno para fazer login no Kibana. Modifique a configuração da lista de permissões do Kibana na seção Configuration and Management > Data Visualization da instância ES.

  • Limpe o cache do navegador e tente novamente.

  • Verifique a vinculação do alias .kibana. Esta verificação aplica-se a clusters ES executando versão 6.x ou posterior. Se a página do Kibana retornar um erro 404 (internal/spaces/_active_space) ou 500 (api/spaces/space), ou redirecionar para um seletor de espaço vazio, o alias .kibana está ausente. No Kibana Dev Tools ou por meio da API ES, execute GET _alias/.kibana. Uma resposta 404 significa que o alias .kibana não existe e deve ser recriado.

    Em seguida, execute GET _cat/indices/.kibana para verificar se existe um índice .kibana com o mesmo nome. Somente se esse índice existir e o ES o tiver criado automaticamente, execute DELETE /.kibana para removê-lo. Este comando exclui o índice e os dados nele contidos. Recrie o alias executando POST _aliases com o corpo da requisição {"actions":[{"add":{"index":".kibana_1","alias":".kibana"}}]}, que vincula o alias .kibana ao .kibana_1.

    Executar PUT /.kibana_N/_alias/.kibana diretamente pode retornar invalid_alias_name_exception, pois a criação automática no ES pode ter produzido um índice .kibana com o mesmo nome. Sempre verifique primeiro e exclua o índice de mesmo nome apenas quando ele existir.

  • Verifique o número da porta na URL de acesso. A porta HTTPS padrão 443 pode ser omitida. Especifique um número de porta não padrão, como 5601.

  • Reinicie o nó do Kibana e tente novamente.

• P: Por que não consigo modificar regras de grupo de segurança no console ES?

  R: Ajustar regras de grupo de segurança afeta todos os cenários que as utilizam para controle de acesso. Portanto, não é possível modificar regras de grupo de segurança no console ES. Para modificar regras de grupo de segurança, acesse o console de Grupos de Segurança ECS.

• Can I access services on the internet (such as Baidu Maps or AMAP) from the Kibana console?

• Why is the IP address resolved from the private domain name of a Kibana V7.16 instance not within my VPC network?

• What do I do if I cannot access Kibana through an Nginx proxy?

• What do I do if I cannot access Kibana using a custom domain name with a CNAME record?

Referências

• Documentação da API:

  • Para ativar ou desativar o acesso público ou privado ao Kibana, consulte a operação de API TriggerNetwork.

  • Para atualizar a lista de permissões de acesso público ou privado do Kibana, consulte a operação de API ModifyWhiteIps.

• Se encontrar problemas ao fazer login ou usar o Kibana, consulte Kibana FAQ.