updating guidance for serverless overview

serverless/index-serverless-elasticsearch.asciidoc

@@ -7,8 +7,6 @@
 
 include::./pages/what-is-elasticsearch-serverless.asciidoc[leveloffset=+2]
 
-include::./pages/pricing.asciidoc[leveloffset=+2]
-
 include::./pages/get-started.asciidoc[leveloffset=+2]
 
 include::./pages/clients.asciidoc[leveloffset=+2]
@@ -50,4 +48,5 @@ include::./pages/search-playground.asciidoc[leveloffset=+2]
 
 include::./pages/serverless-differences.asciidoc[leveloffset=+2]
 
+include::./pages/pricing.asciidoc[leveloffset=+2]
 include::./pages/technical-preview-limitations.asciidoc[leveloffset=+2]

serverless/index-serverless-general.asciidoc

@@ -3,9 +3,9 @@
 
 include::{docs-content-root}/serverless/pages/welcome-to-serverless.asciidoc[leveloffset=+2]
 
-include::./pages/what-is-serverless.asciidoc[leveloffset=+2]
-
 include::./pages/sign-up.asciidoc[leveloffset=+2]
+include::./pages/get-started-general.asciidoc[leveloffset=+2]
+
 
 include::./pages/manage-org.asciidoc[leveloffset=+2]
 include::./pages/manage-access-to-org.asciidoc[leveloffset=+3]

serverless/pages/get-started-general.asciidoc

@@ -0,0 +1,36 @@
+[[serverless-get-started]]
+= Get started
+
+There are two options to create serverless projects:
+
+* If you are an existing customer, https://cloud.elastic.co/login[log in to Elastic Cloud]. On the home page, you will see a new option to create serverless projects. Note that if you are already subscribed to Elastic Cloud, there is no specific trial for serverless projects.
+* If you are a new user, you can https://cloud.elastic.co/serverless-registration[sign up for a free 14-day trial], and you will be able to launch a serverless project. For more information about the trial see, <<general-sign-up-trial-what-is-included-in-my-trial,What is included in my trial?>>.
+
+Choose the type of project that matches your needs and we'll help you get started with our solution guides.
+
+[cols="1,1"]
+|===
+|
+|
+
+| image:https://www.elastic.co/docs/assets/images/elasticsearch.png[width=150]
+a| [.card-title]#Elasticsearch# +
+Build custom search applications with Elasticsearch.
+
+<<what-is-elasticsearch-serverless,*View guide →*>>
+
+| image:https://www.elastic.co/docs/assets/images/observability.png[width=150]
+a| [.card-title]#Observability# +
+Monitor applications and systems with Elastic Observability.
+
+<<what-is-observability-serverless,*View guide →*>>
+
+| image:https://www.elastic.co/docs/assets/images/security.png[width=150]
+a| [.card-title]#Security# +
+Detect, investigate, and respond to threats with Elastic Security.
+
+<<what-is-security-serverless,*View guide →*>>
+
+|
+|
+|===

serverless/pages/sign-up.asciidoc

@@ -1,13 +1,9 @@
 [[general-sign-up-trial]]
-= Get started with serverless
+= How do I sign up?
 
 // :description: Information about signing up for a serverless Elastic Cloud trial
 // :keywords: serverless, general, signup
-
-There are two options to create serverless projects:
-
-* If you are an existing customer, https://cloud.elastic.co/login[log in to Elastic Cloud]. On the home page, you will see a new option to create serverless projects. Note that if you are already subscribed to Elastic Cloud, there is no specific trial for serverless projects.
-* If you are a new user, you can https://cloud.elastic.co/serverless-registration[sign up for a free 14-day trial], and you will be able to launch a serverless project.
+The following page provides information on how to sign up for an Elastic Cloud Serverless account, for information on how to sign up for hosted deployments, see https://www.elastic.co/guide/en/cloud/current/ec-getting-started.html[Elasticsearch Service - How do i sign up?].
 
 [discrete]
 [[general-sign-up-trial-what-is-included-in-my-trial]]
@@ -20,6 +16,8 @@ Your free 14-day trial includes:
 A deployment lets you explore Elastic solutions for Search, Observability, and Security. Trial deployments run on the latest version of the Elastic Stack. They includes 8 GB of RAM spread out over two availability zones, and enough storage space to get you started. If you’re looking to evaluate a smaller workload, you can scale down your trial deployment.
 Each deployment includes Elastic features such as Maps, SIEM, machine learning, advanced security, and much more. You have some sample data sets to play with and tutorials that describe how to add your own data.
 
+To learn more about serverless Elastic Cloud Hosted, check our https://www.elastic.co/guide/en/cloud/current/ec-getting-started.html[Elasticsearch Service documentation].
+
 **One serverless project**
 
 Serverless projects package Elastic Stack features by type of solution:
@@ -48,6 +46,8 @@ During the free 14 day trial, Elastic provides access to one hosted deployment a
 * Machine learning nodes are available up to 4GB RAM
 * Custom Elasticsearch plugins are not enabled
 
+To learn more about serverless Elastic Cloud Hosted, check our https://www.elastic.co/guide/en/cloud/current/ec-getting-started.html[Elasticsearch Service documentation].
+
 **Serverless projects**
 
 * You can have one active serverless project at a time.
@@ -83,7 +83,7 @@ If you’re interested in learning more ways to subscribe to Elastic Cloud, don
 [[general-sign-up-trial-how-do-i-sign-up-through-a-marketplace]]
 == How do I sign up through a marketplace?
 
-If you’re interested in consolidated billing, subscribe from the AWS Marketplace, which allows you to skip the trial period and connect your AWS Marketplace email to your unique Elastic account.
+If you’re interested in consolidated billing, subscribe from the AWS Marketplace, which allows you to skip the trial period and connect your AWS Marketplace email to your unique Elastic account. For a list of regions supported, see <<regions,Regions>>.
 
 [NOTE]
 ====
@@ -95,3 +95,5 @@ Serverless projects are only available for AWS Marketplace. Support for GCP Mark
 == How do I get help?
 
 We’re here to help. If you have any questions, reach out to https://cloud.elastic.co/support[Support].
+
+

serverless/pages/welcome-to-serverless.asciidoc

@@ -13,63 +13,150 @@
 preview:[]
 
 Elastic serverless products allow you to deploy and use Elastic for your use cases without managing the underlying Elastic cluster,
-such as nodes, data tiers, and scaling. Serverless instances are fully-managed, autoscaled, and automatically upgraded by Elastic so you can
-focus more on gaining value and insight from your data.
+such as nodes, data tiers, and scaling. Serverless instances of the Elastic Stack that you create in {ecloud} are called **serverless projects**. These serverless projects are fully-managed, autoscaled, and automatically upgraded by Elastic so you can focus more on gaining value and insight from your data.
 
-Elastic provides three serverless solutions available on {ecloud}:
+Serverless instances of the Elastic Stack that you create in {ecloud} are called **serverless projects**.
 
-* **{es}**: Build powerful applications and search experiences using a rich ecosystem of vector search capabilities, APIs, and libraries.
-* **Elastic {observability}**: Monitor your own platforms and services using powerful machine learning and analytics tools with your logs, metrics, traces, and APM data.
-* **{elastic-sec}**: Detect, investigate, and respond to threats, with SIEM, endpoint protection, and AI-powered analytics capabilities.
+Serverless projects use the core components of the {stack}, such as {es} and {kib}, and are based on https://www.elastic.co/blog/elastic-serverless-architecture[an architecture that
+decouples compute and storage]. Search and indexing operations are separated, which offers high flexibility for scaling your workloads while ensuring
+a high level of performance.
 
-Serverless instances of the Elastic Stack that you create in {ecloud} are called **serverless projects**.
+Elastic provides three serverless solutions available on {ecloud}:
+
+* **https://www.elastic.co/guide/en/serverless/current/what-is-elasticsearch-serverless.html[{es}]**: Build powerful applications and search experiences using a rich ecosystem of vector search capabilities, APIs, and libraries.
+* **https://www.elastic.co/guide/en/serverless/current/what-is-observability-serverless.html[{observability}]**: Monitor your own platforms and services using powerful machine learning and analytics tools with your logs, metrics, traces, and APM data.
+* **https://www.elastic.co/guide/en/serverless/current/what-is-security-serverless.html[{elastic-sec}]**: Detect, investigate, and respond to threats with SIEM, endpoint protection, and AI-powered analytics capabilities.
 
 Elastic serverless products are currently in preview. https://www.elastic.co/blog/elastic-serverless-architecture[Learn more about serverless in our blog].
 
 [discrete]
-== Get started
+== Benfits of serverless projects
+
+**Management free.** Elastic manages the underlying Elastic cluster, so you can focus on your data. With serverless projects, Elastic is responsible for automatic upgrades, data backups,
+and business continuity.
+
+**Autoscaled.** To meet your performance requirements, the system automatically adjusts to your workloads. For example, when you have a short time spike on the
+data you ingest, more resources are allocated for that period of time. When the spike is over, the system uses less resources, without any action
+on your end.
+
+**Optimized data storage.** Your data is stored in cost-efficient, general storage. A cache layer is available on top of the general storage for recent and frequently queried data that provides faster search speed.
+The size of the cache layer and the volume of data it holds depend on <<elasticsearch-manage-project,settings>> that you can configure for each project.
+
+**Dedicated experiences.** All serverless solutions are built on the Elastic Search Platform and include the core capabilities of the Elastic Stack. They also each offer a distinct experience and specific capabilities that help you focus on your data, goals, and use cases.
+
+**Pay per usage.** Each serverless project type includes product-specific and usage-based pricing.
+
+**Data and performance control**. Control your project data and query performance against your project data.
+* Data. Choose the data you want to ingest and the method to ingest it. By default, data is stored indefinitely in your project,
+and you define the retention settings for your data streams.
+* Performance. For granular control over costs and query performance against your project data, serverless projects come with
+a set of predefined settings you can edit.
 
-Choose the type of project that matches your needs and we’ll help you get started with our solution guides.
+.Serverless billing starts June 1, 2024
+[IMPORTANT]
+====
+Until May 31, 2024, your serverless consumption will not incur any charges, but will be visible along with your total Elastic Cloud consumption on the https://cloud.elastic.co/billing/usage[Billing Usage page]. Unless you are in a trial period, usage on or after June 1, 2024 will be deducted from your existing Elastic Cloud credits or be billed to your active payment method.
+====
+
+[discrete]
+[[general-what-is-serverless-elastic-control-your-data-and-performance]]
+== Control your data and performance
+
+Control your project data and query performance against your project data.
+
+**Data.** Choose the data you want to ingest, and the method to ingest it. By default, data is stored indefinitely in your project,
+and you define the retention settings for your data streams.
+
+**Performance.** For granular control over costs and query performance against your project data, serverless projects come with a set of predefined <<elasticsearch-manage-project,settings>> that you can edit.
+
+[discrete]
+[[general-what-is-serverless-elastic-differences-between-serverless-projects-and-hosted-deployments-on-ecloud]]
+== Differences between serverless projects and hosted deployments on {ecloud}
+
+You can run https://www.elastic.co/guide/en/cloud/current/ec-getting-started.html[hosted deployments] of the {stack} on {ecloud}. These hosted deployments provide more provisioning and advanced configuration options.
 
-[cols="1,1"]
 |===
-|
-|
+| Option| Serverless| Hosted
+
+| **Cluster management**
+| Fully managed by Elastic.
+| You provision and manage your hosted clusters. Shared responsibility with Elastic.
+
+| **Scaling**
+| Autoscales out of the box.
+| Manual scaling or autoscaling available for you to enable.
 
-| image:https://www.elastic.co/docs/assets/images/elasticsearch.png[width=150]
-a| [.card-title]#Elasticsearch# +
-Build custom search applications with Elasticsearch.
+| **Upgrades**
+| Automatically performed by Elastic.
+| You choose when to upgrade.
 
-<<what-is-elasticsearch-serverless,*View guide →*>>
+| **Pricing**
+| Individual per project type and based on your usage.
+| Based on deployment size and subscription level.
 
-| image:https://www.elastic.co/docs/assets/images/observability.png[width=150]
-a| [.card-title]#Observability# +
-Monitor applications and systems with Elastic Observability.
+| **Performance**
+| Autoscales based on your usage.
+| Manual scaling.
 
-<<what-is-observability-serverless,*View guide →*>>
+| **Solutions**
+| Single solution per project.
+| Full Elastic Stack per deployment.
 
-| image:https://www.elastic.co/docs/assets/images/security.png[width=150]
-a| [.card-title]#Security# +
-Detect, investigate, and respond to threats with Elastic Security.
+| **User management**
+| Elastic Cloud-managed users.
+| Elastic Cloud-managed users and native Kibana users.
 
-<<what-is-security-serverless,*View guide →*>>
+| **API support**
+| Subset of https://www.elastic.co/docs/api[APIs].
+| All Elastic APIs.
 
-|
-|
+| **Backups**
+| Projects automatically backed up by Elastic.
+| Your responsibility with Snapshot & Restore.
+
+| **Data retention**
+| Editable on data streams.
+| Index Lifecycle Management.
 |===
 
 [discrete]
-== Featured topics
-
-* <<general-manage-access-to-organization,*Invite your team*>>:
-Invite new members to your organization.
-* <<general-assign-user-roles,*Assign user roles and privileges*>>:
-Assign user roles and privileges to members in your organization.
-* <<elasticsearch-manage-project,*Manage your projects*>>:
-Manage your project data, search power, and more.
-* <<general-check-subscription,*Check your subscription overview*>>:
-View the details about your subscription.
-* <<general-monitor-usage,*Monitor and analyze your account usage*>>:
-Check past and current usage for your projects.
-* <<project-settings,*Manage your project settings*>>:
-Manage your indices, data views, and more.
+[[general-what-is-serverless-elastic-answers-to-common-serverless-questions]]
+== Answers to common serverless questions
+
+**What Support is available for the serverless preview?**
+
+There is no official SLA for Support in Serverless until General Availability (GA). We’ll do our best to service customers and inquiries as we would any pre-GA product - at a Platinum/Enterprise Severity 3 (1 business day) SLA target.
+
+**Is there migration support between hosted deployments and serverless projects?**
+
+Migration paths between hosted deployments and serverless projects are currently unsupported.
+
+**How can I move data to or from serverless projects?**
+
+We are working on data migration tools! In the interim, you can <<elasticsearch-ingest-data-through-logstash,use Logstash>> with Elasticsearch input and output plugins to move data to and from serverless projects.
+
+**How does serverless ensure compatibility between software versions?**
+
+Connections and configurations are unaffected by upgrades. To ensure compatibility between software versions, quality testing and API versioning are used.
+
+**Can I convert a serverless project into a hosted deployment, or a hosted deployment into a serverless project?**
+
+Projects and deployments are based on different architectures, and you are unable to convert.
+
+**Can I convert a serverless project into a project of a different type?**
+
+You are unable to convert projects into different project types, but you can create as many projects as you’d like. You will be charged only for your usage.
+
+**How can I create serverless service accounts?**
+
+Create API keys for service accounts in your serverless projects. Options to automate the creation of API keys with tools such as Terraform will be available in the future.
+
+To raise a Support case with Elastic, raise a case for your subscription the same way you do today. In the body of the case, make sure to mention you are working in serverless to ensure we can provide the appropriate support.
+
+**Where can I learn about pricing for serverless?**
+
+See serverless pricing information for https://www.elastic.co/pricing/serverless-search[Search], https://www.elastic.co/pricing/serverless-observability[Observability], and https://www.elastic.co/pricing/serverless-security[Security].
+
+**Can I request backups or restores for my projects?**
+
+It is not currently possible to request backups or restores for projects, but we are working on data migration tools to better support this.