Serverless快速入门

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

前提条件

拥有ES Serverless服务的管理权限

步骤一:创建应用

说明

当您首次创建ES Serverless任意应用时,系统会自动为您开通该服务,服务开通即代表您已悉知并同意相关服务协议。应用创建成功后,将按照相应计费标准进行收费,若未创建成功,则不会产生任何费用。

  1. 创建应用。

    1. 进入Serverless应用创建页面,选择创建实例的地域。

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

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

    输入应用名称并选择应用类型,其他参数保持默认或自定义。应用类型支持选择检索增强型应用(8.17版)日志分析型应用检索通用型应用,本文示例选择检索增强型应用

  3. 配置应用的访问信息。

    • 本文示例网络访问方式配置为公网访问,在公网访问白名单中添加本地设备的IP地址,以便使用本地设备访问Serverless应用的Kibana。配置应用的网络访问,请参见配置Serverless应用公网或私网访问

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

  4. 单击立即创建

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

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

说明

本文以检索增强型应用示例。如需在日志分析型应用中创建索引并读写数据,请参见创建索引

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

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

    • 用户名:在应用管理页面单击应用名称,在应用详情页的基本信息区域,可查看或复制用户名,用户名由应用名称 + 三位数字/字母随机数组成。image

    • 用户密码:创建应用时输入的密码。若您忘记了密码,可在应用详情页的基本信息区域,单击用户密码后的修改,修改应用密码。

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

  4. Console控制台,执行以下命令创建索引。

    示例创建一个名称为product_info的索引,索引中包含productNameannual_ratedescribe三个字段。

    PUT /product_info
    {
      "mappings": {
          "properties": {
            "productName": {
              "type": "text",
              "analyzer": "ik_smart"
            },
            "annual_rate":{
              "type":"keyword"
            },
            "describe": {
              "type": "text",
              "analyzer": "ik_smart"
            }
        }
      }
    }

    创建成功后,返回如下结果。image

  5. 执行以下命令,在索引中创建文档并插入数据。

    POST /product_info/_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/_search
      {
        "query": {
          "match": {
            "describe": "每天收益到账消息推送"
          }
        }
      }

      返回结果:

      {
        "took": 4,
        "timed_out": false,
        "_shards": {
          "total": 1,
          "successful": 1,
          "skipped": 0,
          "failed": 0
        },
        "hits": {
          "total": {
            "value": 6,
            "relation": "eq"
          },
          "max_score": 2.2842526,
          "hits": [
            {
              "_index": "product_info",
              "_id": "ei9VKJkBN4sqtrqx6JH9",
              "_score": 2.2842526,
              "_source": {
                "productName": "理财产品B",
                "annual_rate": "3.1100%",
                "describe": "90天定投产品,最低10000起投,每天收益到账消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "fC9VKJkBN4sqtrqx6JH9",
              "_score": 2.2842526,
              "_source": {
                "productName": "理财产品D",
                "annual_rate": "3.1200%",
                "describe": "90天定投产品,最低12000起投,每天收益到账消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "ey9VKJkBN4sqtrqx6JH9",
              "_score": 2.217505,
              "_source": {
                "productName": "理财产品C",
                "annual_rate": "3.3500%",
                "describe": "270天定投产品,最低40000起投,每天收益立即到账消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "fS9VKJkBN4sqtrqx6JH9",
              "_score": 0.8562305,
              "_source": {
                "productName": "理财产品E",
                "annual_rate": "3.0100%",
                "describe": "30天定投产品推荐,最低8000起投,每天收益会消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "eS9VKJkBN4sqtrqx6JH9",
              "_score": 0.40109843,
              "_source": {
                "productName": "理财产品A",
                "annual_rate": "3.2200%",
                "describe": "180天定期理财,最低20000起投,收益稳定,可以自助选择消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "fi9VKJkBN4sqtrqx6JH9",
              "_score": 0.13270499,
              "_source": {
                "productName": "理财产品F",
                "annual_rate": "2.7500%",
                "describe": "热门短期产品,3天短期,无须任何手续费用,最低500起投,通过短信提示获取收益消息"
              }
            }
          ]
        }
      }

    2. 按查询条件搜索:搜索年化率在3.0000%到3.1300%之间的产品。

      GET /product_info/_search
      {
        "query": {
          "range": {
            "annual_rate": {
              "gte": "3.0000%",
              "lte": "3.1300%"
            }
          }
        }
      }

      返回结果:

      {
        "took": 3,
        "timed_out": false,
        "_shards": {
          "total": 1,
          "successful": 1,
          "skipped": 0,
          "failed": 0
        },
        "hits": {
          "total": {
            "value": 3,
            "relation": "eq"
          },
          "max_score": 1,
          "hits": [
            {
              "_index": "product_info",
              "_id": "ei9VKJkBN4sqtrqx6JH9",
              "_score": 1,
              "_source": {
                "productName": "理财产品B",
                "annual_rate": "3.1100%",
                "describe": "90天定投产品,最低10000起投,每天收益到账消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "fC9VKJkBN4sqtrqx6JH9",
              "_score": 1,
              "_source": {
                "productName": "理财产品D",
                "annual_rate": "3.1200%",
                "describe": "90天定投产品,最低12000起投,每天收益到账消息推送"
              }
            },
            {
              "_index": "product_info",
              "_id": "fS9VKJkBN4sqtrqx6JH9",
              "_score": 1,
              "_source": {
                "productName": "理财产品E",
                "annual_rate": "3.0100%",
                "describe": "30天定投产品推荐,最低8000起投,每天收益会消息推送"
              }
            }
          ]
        }
      }
说明

更多关于使用Kibana信息,请参见通过Kibana使用Serverless应用

步骤三:(可选)查看应用监控数据

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

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

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

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

    说明

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

步骤四:(可选)删除应用

重要

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

  1. 应用管理页面,单击应用列表中操作列的image.png > 删除

  2. 按照界面指引删除应用。

常见问题

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

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

相关文档