Serverless快速入门

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

前提条件

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

步骤一:开通服务

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

  1. 登录Elasticsearch Serverless服务控制台

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

    image.png

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

步骤二:创建应用

  1. 进入创建Serverless应用的页面。

    image

  2. 配置应用的基本信息。

    本文选择应用选型检索通用型,其他参数保持默认或自定义。

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

    • 本文选择网络访问方式公网访问,在公网访问白名单中添加本地设备的IP地址,以便使用本地设备访问Serverless应用的Kibana。

      说明

      配置应用公网访问或私网访问,请参见配置Serverless应用公网或私网访问

    • 输入用户密码,登录Kibana时需要。

  4. 单击立即创建

    您可以在应用管理页面查看已创建的应用列表。等待应用状态变为运行中,即可进行下一步操作。

说明

关于创建应用的更多信息,请参见创建日志分析型应用创建检索通用型应用

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

说明

本文以检索通用型应用为例。如果您需要在日志分析型应用中创建索引并读写数据,请参见创建索引

  1. 在目标应用的操作列上,单击访问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应用公网或私网访问

相关文档