文档

Serverless快速入门

更新时间:

如果您是初次接触或学习Elasticsearch Serverless(简称ES Serverless)服务,本文可以帮助您了解、熟悉Serverless使用的基本流程。本文介绍了如何快速创建一个阿里云ES Serverless应用,并通过Kibana完成索引创建、数据写入和数据查询。

前提条件

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

步骤一:开通服务

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

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

    说明

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

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

    image.png

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

第二步:创建应用

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

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

    说明

    目前仅支持华东1(杭州)、华北2(北京)、华东2(上海)和华南1(深圳)地域。

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

  4. 创建应用面板,配置应用的基本信息,并单击下一步

    部分参数说明:

    参数

    说明

    应用名称

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

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

    • 长度为3~32个字符。

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

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

    所属地域

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

    应用版本

    目前仅支持7.10版本。

    应用类型

    • 入门版:用于学习和探索ES,适用于个人建站、企业测试等对SLA有较低要求的应用场景。

    • 企业版:用于搭建企业信息检索分析应用,适用于标准生产场景,提供业务运行保障。

    使用场景

    • 检索场景:为企业内部平台或面向互联网的应用程序,提供各类结构化或非结构化数据的精准、高效搜索体验。

    • 时序日志场景:在IT运维、监控及大规模数据分析场景,提供各类非结构化数据的存储、检索及聚合分析能力。该场景下的索引特点,请参见时序日志场景下的索引特点

    说明

    入门版只提供检索场景。

    计算资源配额

    单个应用的弹性计算资源上限:

    • 入门版:2 CU

    • 企业版:6 CU、12 CU和24 CU

    说明

    数据存储配额

    由计算资源配额决定。

    允许在应用创建完成后,进行存储配额调整申请。

  5. 配置应用的访问设置。

    部分参数说明:

    网络访问方式

    选择网络访问方式:

    公网访问:通过互联网直接访问Serverless应用,存在潜在的安全风险,适用于远程办公、跨地域协作或者对外提供服务的场景。

    VPC访问(推荐):通过专有网络VPC访问Serverless应用,安全性更高。

    公网访问白名单

    如果通过公网访问,添加待访问设备的IP地址。

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

    • 公网白名单的更多信息,请参见获取公网白名单IP地址

    私网终端节点

    私网访问白名单

    如果通过VPC访问,配置终端节点和私网访问白名单,请参见配置私网访问应用

    用户名称

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

    用户密码

    输入应用的用户密码。

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

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

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

  6. 单击立即创建

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

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

  1. 在目标应用的操作列上,单击访问Kibana

    说明

    如果您同时开启了公网访问Kibana开关和私网访问Kibana的开关,请选择并单击公网访问Kibana私网访问Kibana

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

    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使用Serverless应用

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

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

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

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

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

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

    说明

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

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

重要

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

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

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

常见问题

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

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

相关文档