快速入门

更新时间: 2023-10-24 09:58:17

本文介绍如何快速创建一个阿里云Elasticsearch Serverless应用,通过Kibana完成索引创建、数据写入和数据查询。

前提条件

拥有Elasticsearch Serverless服务的管理权限,具体操作请参见Elasticsearch Serverless自定义权限策略

步骤一:开通服务

第一次使用Elasticsearch Serverless时需要开通服务。

  1. 登录阿里云Elasticsearch控制台
  2. 在左侧导航栏,单击Elasticsearch Serverless服务

    说明

    如果您所在的地域没有Elasticsearch Serverless服务,请在顶部菜单栏切换地域。

  3. 在Elasticsearch Serverless服务页面,单击立即开通

    image.png
  4. 在服务开通页面,选中服务协议,单击立即开通,根据页面提示开通Elasticsearch Serverless服务。

第二步:创建应用

  1. Elasticsearch Serverless服务控制台的左侧导航栏,单击应用管理

  2. 在顶部菜单栏选择要创建应用的地域。

    目前仅支持在华东1(杭州)和华东2(北京)地域创建Serverless应用。

  3. 应用管理页面,单击创建应用

  4. 创建应用面板,输入应用的相关信息。

    部分参数说明:

    参数

    说明

    应用名称

    应用的名称,创建应用后不允许修改。应用名称需要满足以下条件:

    • 在阿里云同一地域内同用户下,应用名称唯一。

    • 长度为3~32个字符。

    • 必须以小写字母或数字开头和结尾。

    • 仅支持小写字母、数字和短划线(-),且特殊字符不能连续出现。

    所属地域

    自动识别控制台选择的地域,不允许在创建应用页面修改。

    应用版本

    目前仅支持7.10版本。

    应用类型

    • 入门版:用于学习和探索Elasticsearch,适用于个人建站、企业测试等对SLA有较低要求的应用场景。单个应用的弹性计算资源上限为2 CU。

    • 企业版:用于搭建企业信息检索分析应用,适用于标准生产场景,提供业务运行保障。单个应用的弹性计算资源上限为6 CU。

    更多信息,请参见资源配额和服务限制

    网络访问方式

    目前仅支持公网访问。

    公网访问白名单

    添加待访问设备的IP地址。获取IP地址的方法,请参见获取IP地址

    您还可以在页面右侧单击添加当前IP地址,将当前设备的IP地址自动添加到白名单中。使用该功能前需要先关闭本地代理。

    说明
    • 目前不支持IPv6地址。

    • 如果白名单为IP网段,您需要填写掩码计算后子网网段的第一个IP地址。

    • 每组白名单下的IP地址或者IP网段数量最多支持1000个。

    • 创建应用时添加的IP地址会同时添加到公网访问应用和公网访问Kibana的白名单中

    用户名称

    系统自动生成,格式为应用名+三位随机数字或字母组合。创建应用后可以在应用详情中查看应用名称。

    用户密码

    输入应用的用户密码。

    • 您可以单击用户密码右侧的自动生成密码,自动填入密码。

    • 单击密码框右侧的image.png图标,密码明文显示时可以复制密码。

    • 如果您忘记设置的初始化密码,创建应用后可以在应用详情的基本信息区域修改应用密码。

  5. 单击立即创建。

    创建成功后,系统会提示应用创建成功。您可以在应用管理页面的应用列表中查看已成功创建的应用。

第三步:使用Kibana创建索引并读写数据

  1. 应用管理页面,应用列表的操作列上单击访问Kibana

    您也可以在应用详情页的右上角,单击访问Kibana

  2. 在Kibana登录页面,输入用户名和密码,单击Log in

    1. 用户名:在应用详情页的基本信息中查看。

    2. 用户密码:创建应用时输入的密码,您也可以在应用详情页修改用户密码。

      1. 在应用详情页的基本信息区域,单击用户密码后的修改

      2. 修改密码对话框中,输入新密码,并单击确认

  3. 在Kibana控制台,选择菜单.png > Management > Dev Tools

  4. 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"}
  5. 执行以下命令,在索引中创建文档并插入数据。

    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,表明数据插入成功。

  6. 执行以下命令,在索引中搜索数据。

    1. 全文搜索:搜索描述内容包含每天收益到账消息推送的所有产品。

      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起投,收益稳定,可以自助选择消息推送"
              }
            }
          ]
        }
      }

    2. 按查询条件搜索:搜索年化率在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

(可选)第四步:查看应用监控数据

  1. 应用管理页面,应用列表中单击目标应用名称。

  2. 在左侧导航栏单击监控中心,查看应用的监控指标。

    • 将鼠标移动到指标名称后的image.png图标上,可以查看指标的具体含义。

    • 控制台展示的监控数据存在约5分钟的延迟。

    • 日环比表示今日数据相较于昨日同一时间数据的变化比。

    说明

    更多信息,请参见查看监控中心

(可选)第五步:删除应用

重要

应用删除后,数据无法恢复,请谨慎操作。

  1. 应用管理页面,应用列表的操作列上选择image.png > 删除

  2. 在弹出的对话框中单击确认

常见问题

Q:访问Kibana时提示当前IP不在Kibana访问白名单许可范围内,请先前往控制台修改Kibana访问配置。

A:出现上面提示的原因是访问设备的IP地址没有加入应用公网访问Kibana的白名单中。添加公网访问白名单,请参见配置公网访问白名单

阿里云首页 检索分析服务Elasticsearch版 相关技术圈