feat: add optimize docs

cSpell.json

@@ -100,7 +100,8 @@
     "Nikolas",
     "Supavisor",
     "inshellisense",
-    "janedoe"
+    "janedoe",
+    "unindexed"
   ],
   "patterns": [
     {

content/100-getting-started/index.mdx

@@ -13,6 +13,7 @@ import {
   Bolt,
   BorderBox,
   BoxTitle,
+  Inspect,
   Database,
   Grid,
   LinkCard,
@@ -38,6 +39,8 @@ Explore our products that make it easy to build and scale data-driven applicatio
 [**<SignalStream />Prisma Pulse**](/pulse) allows you to react to database changes with type-safe model streams in real-time.
 
 
+[**<Inspect />Prisma Optimize**](/optimize/what-is-optimize) helps you to analyze queries, generate insights and provides recommendations that can be used to make your database queries faster.
+
 </BorderBox>
 
 </TopBlock>
@@ -195,3 +198,22 @@ Build real-time applications by subscribing to data changes in your database usi
     link="https://github.com/prisma/prisma-examples?tab=readme-ov-file#prisma-pulse"
   />
 </Grid>
+
+## <Inspect color="#16A394" width="27" height="24" /> Prisma Optimize
+
+Make your database queries faster by using the insights and recommendations generated by Prisma Optimize.
+
+<Grid>
+  <LinkCard
+    icon="fa-solid fa-arrow-right"
+    title="Get started"
+    desc="Add Optimize to your app to generate useful insights and recommendations to improve query performance."
+    link="/optimize/getting-started"
+  />
+  <LinkCard
+    icon="fa-brands fa-github"
+    title="Examples"
+    desc="Explore our ready-to-run examples using Optimize."
+    link="https://github.com/prisma/prisma-examples?tab=readme-ov-file#prisma-optimize"
+  />
+</Grid>

content/200-orm/200-prisma-client/100-queries/100-query-optimization-performance.mdx

@@ -9,6 +9,12 @@ tocDepth: 3
 
 This guide describes ways to optimize query performance, debug performance issues, and how to tackle common performance issues such as the [n+1 problem](#solving-the-n1-problem).
 
+:::note
+
+You can also use [Prisma Optimize](/optimize) to debug slow queries and follow the [recommendations](/optimize/recommendations) provided to improve query performance in your app.
+
+:::
+
 </TopBlock>
 
 ## Debugging performance issues

content/700-optimize/100-what-is-optimize.mdx

@@ -0,0 +1,21 @@
+---
+title: 'What is Optimize'
+metaTitle: 'What is Optimize'
+metaDescription: 'Learn about Optimize, a tool that generates insights and recommendations to make your database queries faster.'
+tocDepth: 3
+toc: true
+---
+
+<TopBlock>
+
+[Optimize](https://www.prisma.io/data-platform/optimize) is a tool designed to generate insights, help you debug database queries, and provide recommendations to make your queries faster.
+
+Key features include:
+
+- Generating insights about your database queries
+- Identifying errors to help debug your database queries
+- Providing recommendations to improve query performance
+
+Optimize aims to help developers of all skill levels write efficient database queries, reducing database load and making applications more responsive.
+
+</TopBlock>

content/700-optimize/200-getting-started.mdx

@@ -0,0 +1,74 @@
+---
+title: 'Getting started'
+metaTitle: 'Getting started with Prisma Optimize'
+metaDescription: 'Learn how to get up and running with Prisma Optimize.'
+tocDepth: 3
+toc: true
+---
+
+## Prerequisites
+
+To get started with Optimize, you will need the following:
+
+- A [Prisma Data Platform workspace](https://console.prisma.io).
+- A project that uses [Prisma Client](/orm/prisma-client) `5.16.1` or higher (We always recommend using the latest version of Prisma).
+- A PostgreSQL, MySQL/MariaDB, PlanetScale, CockroachDB, or MongoDB database.
+
+## 1. Enable Optimize
+
+Login to your [Prisma Data Platform account](https://console.prisma.io) and then navigate to the [ Optimize dashboard](https://optimize.prisma.io).
+
+<Admonition>
+
+You should use Optimize in your development or staging environment.
+
+</Admonition>
+
+## 2. Add Optimize to your application
+
+### 2.1. Update your `schema.prisma` file
+
+In your Prisma schema's `generator` block add the `tracing` preview feature:
+```prisma
+generator client {
+  provider = "prisma-client-js"
+  previewFeatures = ["tracing"]
+}
+```
+
+Then generate a Prisma Client using:
+```terminal
+npx prisma generate
+```
+
+### 2.2. Install the Optimize Prisma Client extension
+
+Install the latest version of Prisma Client and Optimize Prisma Client extension:
+
+```terminal
+npm install @prisma/client@latest @prisma/extension-optimize
+```
+
+### 2.3. Extend your Prisma Client instance with the Optimize extension
+
+Add the following to extend your existing Prisma Client instance with the Optimize extension:
+
+```ts
+import { PrismaClient } from '@prisma/client'
+import { withOptimize } from '@prisma/extension-optimize'
+
+const prisma = new PrismaClient().$extends(withOptimize())
+```
+
+### 2.4. Use Prisma Optimize to generate insights
+
+Create a new recording in your Prisma Optimize dashboard to receive insights on your database queries. Follow these steps:
+1. Locate and click the **Start recording** button and then run your script. 
+2. Once you see query insights are generated for the desired queries or your script completes execution, locate and click the **Stop recording** button. You can then click on the individual queries to see more details.
+3. Navigate to the **Recommendations** tab to see if any improvements have been suggested by Optimize to improve query performance.
+
+You can also try out the [step-by-step example](https://github.com/prisma/prisma-examples/optimize/starter) to learn more. 
+
+## Need help?
+
+Reach out to us in the `#help-and-questions` channel on our [Discord](https://pris.ly/discord), or connect with our community to see how others are using Pulse.

content/700-optimize/300-recording.mdx

@@ -0,0 +1,49 @@
+---
+title: 'Recording'
+metaTitle: 'Optimize: Recording'
+metaDescription: "Learn about using Optimize's recording feature."
+tocDepth: 3
+toc: true
+---
+
+<TopBlock>
+
+The Recordings feature is designed to help developers debug and isolate different sets of queries into distinct sessions, known as recordings. This targeted approach enables precise performance analysis and optimization by preventing the mixing of queries from different applications or test rounds, leading to clearer insights and more effective debugging.
+
+</TopBlock>
+
+## Managing a recording session
+
+You can manually start and stop recording sessions via the [Optimize dashboard](https://optimize.prisma.io) by clicking the **Start Recording** and **Stop Recording** buttons.
+
+:::warning
+
+A recording will automatically stop if the 10k query limit is reached or if the Prisma schema of the app is changed.
+
+:::
+
+A recording session can be deleted when no longer needed.
+
+## Identifying a recording session
+
+You can rename and tag your recording sessions for easy identification and context. Click on the generated default name of the recording session and type the desired name.
+
+## Data captured in a recording session
+
+Each recording session captures insights about queries executed in your app, including:
+- All executed queries during the session.
+- **Raw Query**: The raw query generated and sent to the database by Prisma ORM.
+- **Count**: The number of times a query pattern was executed.
+- [Query performance metrics](/optimize/performance-metrics).
+- Errors encountered during query execution.
+
+Each recording can have a maximum of 10k queries. There are no limits on the storage retention period.
+
+## Recommendations from a recording session
+
+When a recording session ends, Optimize generates recommendations such as:
+- [Excessive number of rows returned](/optimize/recommendations#excessive-number-of-rows-returned)
+- [Full table scans caused by LIKE operations](/optimize/recommendations#full-table-scans-caused-by-like-operations)
+- [Queries on unindexed columns](/optimize/recommendations#queries-on-unindexed-columns)
+
+Learn more about the recommendations generated by Optimize [here](/optimize/recommendations).