From a390bdcd079a49ed5d9c2334aea0ea34e1e1478a Mon Sep 17 00:00:00 2001 From: kosabogi Date: Tue, 12 Nov 2024 13:51:44 +0100 Subject: [PATCH] Updates Get started to align with the new user flow --- .../images/get-started-create-an-index.png | Bin 0 -> 88289 bytes .../index-serverless-elasticsearch.asciidoc | 2 + serverless/pages/create-new-api-key.asciidoc | 19 ++ serverless/pages/get-started.asciidoc | 237 ++++++++---------- ...t-data-through-integrations-beats.asciidoc | 2 +- 5 files changed, 122 insertions(+), 138 deletions(-) create mode 100644 serverless/images/get-started-create-an-index.png create mode 100644 serverless/pages/create-new-api-key.asciidoc diff --git a/serverless/images/get-started-create-an-index.png b/serverless/images/get-started-create-an-index.png new file mode 100644 index 0000000000000000000000000000000000000000..fa46a1dde1d4706690ecf223eb6de4ea1f89a30a GIT binary patch literal 88289 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 ^TW2rOM}EWrF^op=FD_{Mw8>W5Bf0CxtYK? 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%0DZRL0N^E7|;g`^4kUz=K$z8|X{w-RS2a-Qy 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 PbR7qEZY7M{M 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 b)YRF9W(dRO!K`j;BH*Q}tf_=hunhY@-b%E? literal 0 HcmV?d00001 diff --git a/serverless/index-serverless-elasticsearch.asciidoc b/serverless/index-serverless-elasticsearch.asciidoc index 17c141ec..b9d1274d 100644 --- a/serverless/index-serverless-elasticsearch.asciidoc +++ b/serverless/index-serverless-elasticsearch.asciidoc @@ -16,6 +16,8 @@ include::./pages/pricing.asciidoc[leveloffset=+2] include::./pages/get-started.asciidoc[leveloffset=+2] +include::./pages/create-new-api-key.asciidoc[leveloffset=+2] + include::./pages/clients.asciidoc[leveloffset=+2] include::./pages/clients-go-getting-started.asciidoc[leveloffset=+3] include::./pages/clients-java-getting-started.asciidoc[leveloffset=+3] diff --git a/serverless/pages/create-new-api-key.asciidoc b/serverless/pages/create-new-api-key.asciidoc new file mode 100644 index 00000000..3c50cf8b --- /dev/null +++ b/serverless/pages/create-new-api-key.asciidoc @@ -0,0 +1,19 @@ +[[elasticsearch-create-new-api-key]] += Create a new API key + +Create an API key, which will enable you to access the {es} API to ingest and search data. + +. On the **Getting Started** page, scroll to **Add an API Key** and select **New**. +. In **Create API Key**, enter a name for your key and (optionally) set an expiration date. +. (Optional) Under **Control Security privileges**, you can set specific access permissions for this API key. By default, it has full access to all APIs. +. (Optional) The **Add metadata** section allows you to add custom key-value pairs to help identify and organize your API keys. +. Select **Create API Key** to finish. + +After creation, you'll see your API key displayed as an encoded string. +Store this encoded API key securely. It is displayed only once and cannot be retrieved later. +You will use this encoded API key when sending API requests. + +[NOTE] +==== +You can't recover or retrieve a lost API key. Instead, you must delete the key and create a new one. +==== \ No newline at end of file diff --git a/serverless/pages/get-started.asciidoc b/serverless/pages/get-started.asciidoc index 2f7357b1..e48837f2 100644 --- a/serverless/pages/get-started.asciidoc +++ b/serverless/pages/get-started.asciidoc @@ -26,136 +26,68 @@ Use your {ecloud} account to create a fully-managed {es} project: Select **Create project** to continue. . Once the project is ready, select **Continue**. -You should now see the **Home page**. To proceed with the next steps, navigate to the *Getting Started* page. - include::../partials/minimum-vcus-detail.asciidoc[] [discrete] -[[elasticsearch-get-started-create-api-key]] -== Create API key +[[elasticsearch-get-started-create-index]] +== Create an index -Create an API key, which will enable you to access the {es} API to ingest and search data. +Once your project is set up, you'll be directed to a page where you can create your first index. +An index is where documents are stored and organized, making it possible to search and retrieve data. -. On the **Getting Started** page, scroll to **Add an API Key** and select **New**. -. In **Create API Key**, enter a name for your key and (optionally) set an expiration date. -. (Optional) Under **Control Security privileges**, you can set specific access permissions for this API key. By default, it has full access to all APIs. -. (Optional) The **Add metadata** section allows you to add custom key-value pairs to help identify and organize your API keys. -. Select **Create API Key** to finish. +. Enter a name for your index. +. Click *Create my index*. You can also create the index by clicking on *Code* to view and run code examples through the command line. ++ +image::images/get-started-create-an-index.png[Create an index.] -After creation, you'll see your API key displayed as an encoded string. -Store this encoded API key securely. It is displayed only once and cannot be retrieved later. -You will use this encoded API key when sending API requests. +. You’ll be directed to the *Index Management* page. Here, copy and save the following: +- Elasticsearch URL +- API key [NOTE] ==== -You can't recover or retrieve a lost API key. Instead, you must delete the key and create a new one. +You won’t be able to view this API key again. If needed, refer to <> to generate a new one. ==== [discrete] -[[elasticsearch-get-started-copy-url]] -== Copy URL - -Next, copy the URL of your API endpoint. -You'll send all {es} API requests to this URL. - -. On the **Getting Started** page, scroll to **Copy your connection details** section, and find the **Elasticsearch endpoint** field. -. Copy the URL for the Elasticsearch endpoint. - -Store this value along with your `encoded` API key. -You'll use both values in the next step. - -[discrete] -[[elasticsearch-get-started-test-connection]] -== Test connection - -We'll use the `curl` command to test your connection and make additional API requests. -(See https://everything.curl.dev/get[Install curl] if you need to install this program.) - -`curl` will need access to your Elasticsearch Endpoint and `encoded` API key. -Within your terminal, assign these values to the `ES_URL` and `API_KEY` environment variables. - -For example: - -[source,bash] ----- -export ES_URL="https://dda7de7f1d264286a8fc9741c7741690.es.us-east-1.aws.elastic.cloud:443" -export API_KEY="ZFZRbF9Jb0JDMEoxaVhoR2pSa3Q6dExwdmJSaldRTHFXWEp4TFFlR19Hdw==" ----- - -Then run the following command to test your connection: +[[elasticsearch-get-started-ingest-data]] +== Ingest data -[source,bash] ----- -curl "${ES_URL}" \ - -H "Authorization: ApiKey ${API_KEY}" \ - -H "Content-Type: application/json" ----- +You can now ingest data in several ways: using Python, cURL, JavaScript, or Run in Console directly in Elasticsearch. +If you'd prefer to upload a file using the UI, refer to <>. -You should receive a response similar to the following: +In this section, we walk you through the ingest process using the Console. +. Click *Run in Console*. +. Run the first API call to create the index mapping. ++ [source,json] ---- +PUT /search-test/_mapping { - "name" : "serverless", - "cluster_name" : "dda7de7f1d264286a8fc9741c7741690", - "cluster_uuid" : "ws0IbTBUQfigmYAVMztkZQ", - "version" : { ... }, - "tagline" : "You Know, for Search" + "properties": { + "vector": { + "type": "dense_vector", + "dims": 3 + }, + "text": { + "type": "text" + } + } } ---- -Now you're ready to ingest and search some sample documents. - -[discrete] -[[elasticsearch-get-started-ingest-data]] -== Ingest data - -[NOTE] -==== -This example uses {es} APIs to ingest data. If you'd prefer to upload a file using the UI, refer to <>. -==== - -To ingest data, you must create an index and store some documents. -This process is also called "indexing". - -You can index multiple documents using a single `POST` request to the `_bulk` API endpoint. -The request body specifies the documents to store and the indices in which to store them. - -{es} will automatically create the index and map each document value to one of its data types. -Include the `?pretty` option to receive a human-readable response. - -Run the following command to index some sample documents into the `books` index: - -[source,bash] ----- -curl -X POST "${ES_URL}/_bulk?pretty" \ - -H "Authorization: ApiKey ${API_KEY}" \ - -H "Content-Type: application/json" \ - -d ' -{ "index" : { "_index" : "books" } } -{"name": "Snow Crash", "author": "Neal Stephenson", "release_date": "1992-06-01", "page_count": 470} -{ "index" : { "_index" : "books" } } -{"name": "Revelation Space", "author": "Alastair Reynolds", "release_date": "2000-03-15", "page_count": 585} -{ "index" : { "_index" : "books" } } -{"name": "1984", "author": "George Orwell", "release_date": "1985-06-01", "page_count": 328} -{ "index" : { "_index" : "books" } } -{"name": "Fahrenheit 451", "author": "Ray Bradbury", "release_date": "1953-10-15", "page_count": 227} -{ "index" : { "_index" : "books" } } -{"name": "Brave New World", "author": "Aldous Huxley", "release_date": "1932-06-01", "page_count": 268} -{ "index" : { "_index" : "books" } } -{"name": "The Handmaids Tale", "author": "Margaret Atwood", "release_date": "1985-06-01", "page_count": 311} -' ----- - -You should receive a response indicating there were no errors: +. Run the second API call to ingest documents. [source,json] ---- -{ - "errors" : false, - "took" : 1260, - "items" : [ ... ] -} +POST /_bulk?pretty +{ "index": { "_index": "search-test" } } +{"vector":[2.542,5.807,9.735],"text":"Example text 1"} +{ "index": { "_index": "search-test" } } +{"vector":[5.879,8.179,9.932],"text":"Example text 2"} +{ "index": { "_index": "search-test" } } +{"vector":[6.534,7.155,3.236],"text":"Example text 3"} ---- [discrete] @@ -163,55 +95,81 @@ You should receive a response indicating there were no errors: == Search data To search, send a `POST` request to the `_search` endpoint, specifying the index to search. -Use the {es} query DSL to construct your request body. -Run the following command to search the `books` index for documents containing `snow`: +Run the following command to search the `search-test` index for documents containing `Example` in the text field: [source,bash] ---- -curl -X POST "${ES_URL}/books/_search?pretty" \ - -H "Authorization: ApiKey ${API_KEY}" \ - -H "Content-Type: application/json" \ - -d ' +POST /search-test/_search?pretty { "query": { - "query_string": { - "query": "snow" + "match": { + "text": "Example" } } } -' ---- -You should receive a response with the results: +This query will use the match query, which is designed to search for full-text fields. + +You should receive a response that includes the documents matching your search term. +Here’s an example of what the response might look like: [source,json] ---- { - "took" : 24, - "timed_out" : false, - "_shards" : { - "total" : 1, - "successful" : 1, - "skipped" : 0, - "failed" : 0 + "took": 6, + "timed_out": false, + "_shards": { + "total": 3, + "successful": 3, + "skipped": 0, + "failed": 0 }, - "hits" : { - "total" : { - "value" : 1, - "relation" : "eq" + "hits": { + "total": { + "value": 3, + "relation": "eq" }, - "max_score" : 1.5904956, - "hits" : [ + "max_score": 0.2876821, + "hits": [ { - "_index" : "books", - "_id" : "Z3hf_IoBONQ5TXnpLdlY", - "_score" : 1.5904956, - "_source" : { - "name" : "Snow Crash", - "author" : "Neal Stephenson", - "release_date" : "1992-06-01", - "page_count" : 470 + "_index": "search-test", + "_id": "NJZmIJMBSZbIKcD1sOUO", + "_score": 0.2876821, + "_source": { + "vector": [ + 2.352, + 4.133, + 1.718 + ], + "text": "Example text 2" + } + }, + { + "_index": "search-test", + "_id": "M5ZmIJMBSZbIKcD1sOUO", + "_score": 0.18232156, + "_source": { + "vector": [ + 6.407, + 1.821, + 0.404 + ], + "text": "Example text 1" + } + }, + { + "_index": "search-test", + "_id": "NZZmIJMBSZbIKcD1sOUO", + "_score": 0.18232156, + "_source": { + "vector": [ + 4.959, + 5.986, + 3.873 + ], + "text": "Example text 3" } } ] @@ -219,6 +177,11 @@ You should receive a response with the results: } ---- +In this response: + +- `hits`: This section contains the matching documents. Each document includes the `_source` field with the original vector and text fields. +- `_score`: This field indicates the relevance score of each document to the search query. A higher score means a closer match. + [discrete] [[elasticsearch-get-started-continue-on-your-own]] == Continue on your own diff --git a/serverless/pages/ingest-your-data-ingest-data-through-integrations-beats.asciidoc b/serverless/pages/ingest-your-data-ingest-data-through-integrations-beats.asciidoc index d9af7cc1..c2a1003b 100644 --- a/serverless/pages/ingest-your-data-ingest-data-through-integrations-beats.asciidoc +++ b/serverless/pages/ingest-your-data-ingest-data-through-integrations-beats.asciidoc @@ -42,7 +42,7 @@ can further process and enhance the data before visualizing it in {kib}. [NOTE] ==== When you use {beats} to export data to an {es} project, the {beats} require an API key to authenticate with {es}. -Refer to <> for the steps to set up your API key, +Refer to <> for the steps to set up your API key, and to https://www.elastic.co/guide/en/beats/filebeat/current/beats-api-keys.html[Grant access using API keys] in the Filebeat documentation for an example of how to configure your {beats} to use the key. ====