如果您是初次接触或学习Elasticsearch Serverless(简称ES Serverless)服务,本文可以帮助您了解、熟悉Serverless使用的基本流程。本文介绍了如何快速创建一个阿里云ES Serverless应用,并通过Kibana完成索引创建、数据写入和数据查询。
前提条件
拥有ES Serverless服务的管理权限,具体操作请参见ES Serverless自定义权限策略。
步骤一:开通服务
第一次使用ES Serverless时需要开通服务。
- 登录阿里云Elasticsearch控制台。
在左侧导航栏,单击Elasticsearch Serverless版本。
说明如果您所在的地域没有Elasticsearch Serverless服务,请在顶部菜单栏切换地域。
在ES Serverless服务页面,单击立即开通。
在服务开通页面,选中服务协议,单击立即开通,根据页面提示开通ES Serverless服务。
第二步:创建应用
在Elasticsearch Serverless服务控制台的左侧导航栏,单击应用管理。
在顶部菜单栏选择要创建应用的地域。
说明目前仅支持华东1(杭州)、华北2(北京)、华东2(上海)和华南1(深圳)地域。
在应用管理页面,单击创建应用。
在创建应用面板,配置应用的基本信息,并单击下一步。
部分参数说明:
参数
说明
应用名称
应用的名称,创建应用后不允许修改。应用名称需要满足以下条件:
在阿里云同一地域内同用户下,应用名称唯一。
长度为3~32个字符。
必须以小写字母或数字开头和结尾。
仅支持小写字母、数字和短划线(-),且特殊字符不能连续出现。
所属地域
自动识别控制台选择的地域,不允许在创建应用页面修改。
应用版本
目前仅支持7.10版本。
应用类型
入门版:用于学习和探索ES,适用于个人建站、企业测试等对SLA有较低要求的应用场景。
企业版:用于搭建企业信息检索分析应用,适用于标准生产场景,提供业务运行保障。
使用场景
检索场景:为企业内部平台或面向互联网的应用程序,提供各类结构化或非结构化数据的精准、高效搜索体验。
时序日志场景:在IT运维、监控及大规模数据分析场景,提供各类非结构化数据的存储、检索及聚合分析能力。该场景下的索引特点,请参见时序日志场景下的索引特点。
说明入门版只提供检索场景。
计算资源配额
单个应用的弹性计算资源上限:
入门版:2 CU
企业版:6 CU、12 CU和24 CU
说明各应用类型的限制,请参见应用配额与服务限制。
允许在应用创建完成后,进行应用配额调整申请。
数据存储配额
由计算资源配额决定。
允许在应用创建完成后,进行存储配额调整申请。
配置应用的访问设置。
部分参数说明:
网络访问方式
选择网络访问方式:
公网访问:通过互联网直接访问Serverless应用,存在潜在的安全风险,适用于远程办公、跨地域协作或者对外提供服务的场景。
VPC访问(推荐):通过专有网络VPC访问Serverless应用,安全性更高。
公网访问白名单
如果通过公网访问,添加待访问设备的IP地址。
您还可以在页面右侧单击添加当前IP地址,将当前设备的IP地址自动添加到白名单中,使用该功能前需要先关闭本地代理。
公网白名单的更多信息,请参见获取公网白名单IP地址。
私网终端节点
私网访问白名单
如果通过VPC访问,配置终端节点和私网访问白名单,请参见配置私网访问应用。
用户名称
系统自动生成,格式为应用名+三位随机数字或字母组合。创建应用后可以在应用详情中查看应用名称。
用户密码
输入应用的用户密码。
您可以单击用户密码右侧的自动生成密码,自动填入密码。
单击密码框右侧的图标,密码明文显示时可以复制密码。
如果您忘记设置的初始化密码,创建应用后可以在应用详情的基本信息区域修改应用密码。
单击立即创建。
创建成功后,系统会提示应用创建成功。您可以在应用管理页面的应用列表中查看已成功创建的应用。
第三步:使用Kibana创建索引并读写数据
在目标应用的操作列上,单击访问Kibana。
说明如果您同时开启了公网访问Kibana开关和私网访问Kibana的开关,请选择并单击公网访问Kibana或私网访问Kibana。
在Kibana登录页面,输入用户名和密码,单击Log in。
用户名:在应用详情页的基本信息区域查看、复制。
用户密码:创建应用时输入的密码。如果您忘记了密码,可以在应用详情页的基本信息区域,单击用户密码后的修改,修改应用密码。
在Kibana控制台,选择
。在Console控制台,执行以下命令在应用中创建索引。
PUT /product_info { "mappings": { "properties": { "productName": { "type": "text", "analyzer": "ik_smart" }, "annual_rate":{ "type":"keyword" }, "describe": { "type": "text", "analyzer": "ik_smart" } } } }
以上示例代码创建了一个名称为
product_info
的索引,索引中包含productName、annual_rate和describe三个字段。创建成功后,返回结果如下。
{"acknowledged":true,"shards_acknowledged":true,"index":"product_info"}
执行以下命令,在索引中创建文档并插入数据。
POST /product_info/_doc/_bulk {"index":{}} {"productName":"理财产品A","annual_rate":"3.2200%","describe":"180天定期理财,最低20000起投,收益稳定,可以自助选择消息推送"} {"index":{}} {"productName":"理财产品B","annual_rate":"3.1100%","describe":"90天定投产品,最低10000起投,每天收益到账消息推送"} {"index":{}} {"productName":"理财产品C","annual_rate":"3.3500%","describe":"270天定投产品,最低40000起投,每天收益立即到账消息推送"} {"index":{}} {"productName":"理财产品D","annual_rate":"3.1200%","describe":"90天定投产品,最低12000起投,每天收益到账消息推送"} {"index":{}} {"productName":"理财产品E","annual_rate":"3.0100%","describe":"30天定投产品推荐,最低8000起投,每天收益会消息推送"} {"index":{}} {"productName":"理财产品F","annual_rate":"2.7500%","describe":"热门短期产品,3天短期,无须任何手续费用,最低500起投,通过短信提示获取收益消息"}
如果返回结果中包含
"errors" : false
,表明数据插入成功。执行以下命令,在索引中搜索数据。
全文搜索:搜索描述内容包含
每天收益到账消息推送
的所有产品。GET /product_info/_doc/_search { "query": { "match": { "describe": "每天收益到账消息推送" } } }
返回结果:
{ "took" : 9, "timed_out" : false, "_shards" : { "total" : 3, "successful" : 3, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 6, "relation" : "eq" }, "max_score" : 3.3588572, "hits" : [ { "_index" : "product_info", "_type" : "_doc", "_id" : "JzkKF4oBaH-7DHixgEF4", "_score" : 3.3588572, "_source" : { "productName" : "理财产品D", "annual_rate" : "3.1200%", "describe" : "90天定投产品,最低12000起投,每天收益到账消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "JTkKF4oBaH-7DHixgEF4", "_score" : 2.0750675, "_source" : { "productName" : "理财产品B", "annual_rate" : "3.1100%", "describe" : "90天定投产品,最低10000起投,每天收益到账消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "JjkKF4oBaH-7DHixgEF4", "_score" : 2.0124505, "_source" : { "productName" : "理财产品C", "annual_rate" : "3.3500%", "describe" : "270天定投产品,最低40000起投,每天收益立即到账消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "KDkKF4oBaH-7DHixgEF4", "_score" : 0.67798966, "_source" : { "productName" : "理财产品E", "annual_rate" : "3.0100%", "describe" : "30天定投产品推荐,最低8000起投,每天收益会消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "KTkKF4oBaH-7DHixgEF4", "_score" : 0.3420724, "_source" : { "productName" : "理财产品F", "annual_rate" : "2.7500%", "describe" : "热门短期产品,3天短期,无须任何手续费用,最低500起投,通过短信提示获取收益消息" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "JDkKF4oBaH-7DHixgEF3", "_score" : 0.31854028, "_source" : { "productName" : "理财产品A", "annual_rate" : "3.2200%", "describe" : "180天定期理财,最低20000起投,收益稳定,可以自助选择消息推送" } } ] } }
按查询条件搜索:搜索年化率在3.0000%到3.1300%之间的产品。
GET /product_info/_doc/_search { "query": { "range": { "annual_rate": { "gte": "3.0000%", "lte": "3.1300%" } } } }
返回结果:
{ "took" : 4, "timed_out" : false, "_shards" : { "total" : 3, "successful" : 3, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 3, "relation" : "eq" }, "max_score" : 1.0, "hits" : [ { "_index" : "product_info", "_type" : "_doc", "_id" : "JzkKF4oBaH-7DHixgEF4", "_score" : 1.0, "_source" : { "productName" : "理财产品D", "annual_rate" : "3.1200%", "describe" : "90天定投产品,最低12000起投,每天收益到账消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "JTkKF4oBaH-7DHixgEF4", "_score" : 1.0, "_source" : { "productName" : "理财产品B", "annual_rate" : "3.1100%", "describe" : "90天定投产品,最低10000起投,每天收益到账消息推送" } }, { "_index" : "product_info", "_type" : "_doc", "_id" : "KDkKF4oBaH-7DHixgEF4", "_score" : 1.0, "_source" : { "productName" : "理财产品E", "annual_rate" : "3.0100%", "describe" : "30天定投产品推荐,最低8000起投,每天收益会消息推送" } } ] } }
关于使用Kibana的更多信息,请参见通过Kibana使用Serverless应用。
(可选)第四步:查看应用监控数据
在应用管理页面,应用列表中单击目标应用名称。
在左侧导航栏单击监控中心,查看应用的监控指标。
将鼠标移动到指标名称后的图标上,可以查看指标的具体含义。
控制台展示的监控数据存在约5分钟的延迟。
日环比表示今日数据相较于昨日同一时间数据的变化比。
说明更多信息,请参见查看监控中心。
(可选)第五步:删除应用
应用删除后,数据无法恢复,请谨慎操作。
在应用管理页面,应用列表的操作列上选择
。在弹出的对话框中单击确认。
常见问题
Q:访问Kibana时提示当前IP不在Kibana访问白名单许可范围内,请先前往控制台修改Kibana访问配置。
A:出现上面提示的原因是访问设备的IP地址没有加入公网或私网访问Kibana的白名单中。添加访问白名单,请参见配置Serverless应用公网或私网访问。