检索分析服务Elasticsearch版：通过Kibana连接集群

Kibana连接账号与鉴权方式

通过公网地址登录Kibana（v2/v3部署架构）

1. 登录阿里云Elasticsearch控制台，进入目标实例基本信息页面。

2. 在左侧导航栏单击 配置与管理 > 可视化控制，在Kibana区域单击修改配置。

   

3. 在访问配置模块，配置Kibana公网访问白名单、Kibana公网访问鉴权方式。

   

   • 配置Kibana公网访问白名单：Kibana公网访问白名单默认为127.0.0.1，表示禁止所有IPv4地址访问，需要将您的实际设备IP添加到公网白名单才能访问Kibana。

     • 参照以下场景，获取待访问设备的IP地址。

       场景	需获取的IP地址	获取方式
       在本地设备中通过公网地址访问Kibana。	本地设备公网IP。 说明 如果您的本地设备处在家庭网络或公司局域网中，需要添加局域网的公网出口IP地址。	通过curl ipinfo.io/ip查询本地设备公网IP。
       在ECS实例中通过公网地址访问Kibana。	当ECS与ES在不同专有网络中时，可通过ECS公网地址访问Kibana，此时需获取ECS的公网IP并添加到Kibana公网白名单。	登录ECS控制台，在实例列表查看实例的公网IP地址。

     • 在Kibana公网访问白名单区域单击修改。

       

     • 单击default分组右侧的配置，在弹出的对话框中添加IP白名单。

       也可单击新增IP白名单分组，自定义分组名称。分组仅用于IP地址管理，不会影响实际访问权限。

       

       配置类别	格式和示例值	重要注意事项
       IPv4地址格式	单个IP：192.168.0.1 网段：192.168.0.0/24，建议将零散的IP合并为IP段 单个集群最多可配置300个IP或者IP网段，多个IP或者IP网段之间用英文逗号隔开，且逗号前后不能有空格。	0.0.0.0/0：允许所有IPv4访问。 重要 强烈建议不要配置 0.0.0.0/0，存在高危风险。 部分集群和地域不支持 0.0.0.0/0，请以界面或者报错提示为准。
       IPv6地址格式 (仅v2架构下杭州地域的集群支持)	单个IP：2401:XXXX:1000:24::5 网段：2401:XXXX:1000::/48 单个集群最多可配置300个IP或者IP网段，多个IP或者IP网段之间用英文逗号隔开，且逗号前后不能有空格。	::1：禁止所有IPv6地址访问 ::/0：允许所有IPv6访问 重要 强烈建议不要配置 ::/0，存在高危风险。 部分集群版本不支持 ::/0，请以控制台界面或者报错提示为准。

     • 配置完成后，单击确认。

   • 配置Kibana公网访问鉴权方式：

     v3架构下的集群默认通过阿里云账号和ES实例访问密码双重鉴权方式，即先登录阿里云账号，再使用ES实例访问信息进行登录鉴权。

     

     v2架构下的集群默认通过ES实例访问密码鉴权，不支持修改。

4. 返回Kibana区域，单击公网入口，在Kibana登录页面，输入用户名和密码，成功登录即可进入Kibana控制台进行ES数据探索。

   

   您也可以直接在设备的浏览器中输入连接信息（确认设备IP已添加到Kibana公网白名单）：

   • v2：https://es-{地域缩写}-{实例ID}-kibana.elasticsearch.aliyuncs.com:端口号

   • v3：https://es-{地域缩写}-{实例ID}-kibana.{完整地域}.elasticsearch.aliyuncs.com:端口号

通过私网地址登录Kibana（v3部署架构）

在V3部署架构中，Kibana私网访问功能默认处于关闭状态。您需要通过阿里云PrivateLink服务在专有网络VPC中为Kibana创建终端节点，该终端节点的使用费用已包含在ES服务中，无需额外支付。

连接示例

• 以下示例使用VNC远程连接ECS（操作系统为Windows），通过私网地址连接Kibana。

  

  输入用户名和密码，单击登录。建议通过Kibana中的插件Elasticsearch X-Pack创建角色实现用户权限精细化管理。

  

• 以下示例为使用Workbench远程连接ECS，然后执行以下命令通过Kibana私网地址连接Kibana：

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

  连接成功返回以下信息：

  

通过私网地址登录Kibana（V2部署架构）

在V2架构中，需先在控制台开启私网访问功能（Kibana节点需2核4G及以上配置），然后将待访问设备IP添加到私网白名单，该设备才能通过Kibana私网地址登录Kibana。

1. 在左侧导航栏单击可视化控制，在Kibana区域进入修改配置。

2. 在访问配置模块，打开Kibana私网访问开关并配置访问白名单。

   1. 以ECS实例中通过私网地址访问Kibana为例（要求ECS与ES处于同一VPC中），登录ECS控制台，在实例列表查看实例的私网IP地址。

   2. 在Kibana私网访问白名单区域单击修改，新增IP白名单分组或者在default分组中添加ECS实例私网地址。

      重要

      强烈建议不要配置 0.0.0.0/0，存在高危风险，部分集群和地域不支持 0.0.0.0/0，请以界面或者报错提示为准。

3. 以下示例为使用Workbench远程连接ECS，执行以下命令通过Kibana私网地址连接Kibana：

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

   连接成功返回以下信息：

   

通过Nginx代理访问Kibana（以v3部署架构为例）

通过Nginx代理访问Kibana时，提前配置或获取以下信息：

• Kibana连接地址：

  • 私网访问地址以及鉴权方式：请参照通过私网地址登录Kibana（v3部署架构）配置私网访问地址，通过Nginx代理访问Kibana时仅支持使用ES实例访问密码作为访问鉴权方式。

  • 公网访问地址、白名单以及鉴权方式：如何获取和配置白名单，请参见通过公网地址登录Kibana（v2/v3部署架构），仅支持使用ES实例访问密码作为访问鉴权方式。

• 安全组配置：如果您是从本地浏览器通过Nginx（如服务器为ECS）代理访问Kibana，需要将本地设备IP以及端口号80添加到ECS实例所属安全组中。

• 修改Nginx配置信息，关键参数说明：

  • server_name：服务器域名，可替换为实际使用的服务器域名。

  • proxy_pass：将请求代理到后端Kibana服务，需替换为Kibana私网或者公网连接信息（连接地址和端口号）。

    server
     {
        listen 80;
         # 您可以将server_name替换为实际服务器域名
        server_name _ ;
        # 安全设置
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; add_header X-Frame-Options DENY; add_header X-Content-Type-Options nosniff;
    
        location / {
            # 将请求代理到后端Kibana服务
            proxy_pass https://es-xx-xxxxxxxxxxxxxxxxx-kibana.internal.elasticsearch.aliyuncs.com:5601;
    
            # 证书验证（生产环境应使用有效证书）
            proxy_ssl_verify off; proxy_ssl_server_name on;
    
            # 头部设置
            proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header
            X-Forwarded-Proto $scheme;
    
            # WebSocket 支持
            proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_cache_bypass $http_upgrade;
    
            # 超时设置
            proxy_connect_timeout 60s; proxy_send_timeout 60s; proxy_read_timeout 60s;
        }
    }

切换Kibana语言

Kibana支持中文和英文（默认）两种语言，ES版本为6.7.0及以上时，支持切换Kibana语言。

1. 登录阿里云Elasticsearch控制台，进入目标实例基本信息页面。

2. 在左侧导航栏单击可视化控制，在Kibana区域进入修改配置。

   

3. 单击修改配置切换Kibana语言。

   

常见问题

• Q：如何区分部署架构是V2还是V3？

  A：集群有两种管控部署模式，分别为云原生新管控（v3）、基础管控（v2）。

  

• Q：开启Kibana私网或公网访问功能，会影响ES集群吗？

  A：不会。开启Kibana私网或公网访问功能，仅会触发与Kibana对接的负载均衡SLB端的变更。

  说明

  首次开启Kibana私网访问会触发Kibana节点重启，但不会触发ES集群变更。

• Q：添加了白名单，但Kibana还是无法访问，该如何处理？

  A：您可以根据以下内容依次进行排查：

  • ES实例需要处于健康状态。

  • IP地址配置可能不正确：如果您通过本地设备访问Kibana服务，在浏览器中访问www.cip.cc，检查获取的IP地址是否在Kibana公网访问白名单中。

  • 您添加的可能是ES实例的访问白名单：登录kibana需要配置kibana公网访问白名单或kibana私网访问白名单，在ES实例的 配置与管理 > 可视化控制中修改Kibana白名单配置。

  • 清理浏览器缓存后重试。

  • 重启Kibana节点后重试。

• Q：为什么不支持在ES控制台修改安全组规则？

  A：安全组规则调整将影响所有通过该安全组规则进行访问控制的场景，故不支持在ES控制台修改安全组规则。修改安全组规则，请前往ECS安全组控制台。

• 我可以在Kibana控制台中，访问公网中的服务吗（例如百度地图、高德地图等）？

• 为什么7.16版本的Kibana私网域名解析出的IP地址不在我的VPC网络下？

• 通过Nginx代理访问Kibana不通如何解决？

• 自有域名通过CNAME无法访问Kibana如何解决？

相关文档

• API文档：

  • 开启或关闭Kibana公网或私网访问的API文档：TriggerNetwork

  • 更新Kibana公网或私网访问白名单的API文档：ModifyWhiteIps

• 在登录或使用Kibana过程中遇到问题，请参见Kibana FAQ。