Docs: Add traces and generations

contents/docs/ai-engineering/dashboard.md

@@ -21,6 +21,8 @@ The [LLM observability dashboard](https://us.posthog.com/llm-observability) prov
     classes="rounded"
 />
 
+It can be filtered like any dashboard in PostHog, including by event, person, and group properties. Our observability SDKs autocapture especially useful properties like provider, tokens, cost, model, and more.
+
 This dashboard is a great starting point for understanding your LLM usage and performance. You can use it to answer questions like:
 
 - Are users using our LLM-powered features?
@@ -29,4 +31,4 @@ This dashboard is a great starting point for understanding your LLM usage and pe
 - How many of my users are interacting with my LLM features?
 - Are there generation latency spikes?
 
-To dive into specific generation events, click on the [generations tab](https://us.posthog.com/llm-observability/generations) to get a list of all the recent generation events captured by PostHog.
+To dive into specific generation events, click on the [generations](https://us.posthog.com/llm-observability/generations) or [traces](https://us.posthog.com/llm-observability/traces) tabs to get a list of each captured by PostHog.

contents/docs/ai-engineering/llm-insights.md

@@ -1,5 +1,5 @@
 ---
-title: LLM insights (beta)
+title: LLM observability integrations (beta)
 availability:
     free: full
     selfServe: full

contents/docs/ai-engineering/traces-generations.md

@@ -0,0 +1,35 @@
+---
+title: LLM traces and generations (beta)
+availability:
+  free: full
+  selfServe: full
+  enterprise: full
+---
+
+Once you install PostHog's LLM observabilty SDK, it autocaptures LLM generations and traces. You can then view these in PostHog.
+
+## Generations
+
+Generations are an event that capture an LLM request. The [generations tab](https://us.posthog.com/llm-observability/generations) lists them along with the properties autocaptured by the PostHog like the person, model, total cost, token usage, and more.
+
+When you expand a generation, it includes the properties and metadata that every event has along with a conversation history with the role (system, user, assistant) as well as input and output content.
+
+<ProductScreenshot
+  imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2025_01_23_at_14_47_43_2x_9223a3b730.png"
+  imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2025_01_23_at_14_47_17_2x_0cc9075dd5.png"
+  alt="LLM generations"
+  classes="rounded"
+/>
+
+## Traces
+
+Traces are a collection of generations that capture a full interaction between a user and an LLM. The [traces tab](https://us.posthog.com/llm-observability/traces) lists them along with the properties autocaptured by the PostHog like the person, total cost, total latency, and more.
+
+Clicking on a trace opens a timeline of the interaction with all the generation events enabling you to see the entire conversation, details about the trace, and the individual generation events.
+
+<ProductScreenshot
+  imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2025_01_23_at_14_56_05_2x_5704304722.png"
+  imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/Clean_Shot_2025_01_23_at_14_56_22_2x_705d03500f.png"
+  alt="LLM generations"
+  classes="rounded"
+/>

src/navs/index.js

@@ -2262,16 +2262,6 @@ export const docsMenu = {
                 {
                     name: 'Tools',
                 },
-                {
-                    name: 'LLM insights',
-                    url: '/docs/ai-engineering/llms',
-                    icon: 'IconAIText',
-                    color: 'yellow',
-                    badge: {
-                        title: 'Beta',
-                        className: 'uppercase !bg-blue/10 !text-blue !dark:text-white !dark:bg-blue/50',
-                    },
-                },
                 {
                     name: 'Autocapture',
                     url: '/docs/product-analytics/autocapture',
@@ -3232,46 +3222,42 @@ export const docsMenu = {
                     icon: 'IconDashboard',
                     color: 'red',
                 },
+                {
+                    name: 'Traces and generations',
+                    url: '/docs/ai-engineering/traces-generations',
+                    icon: 'yellow',
+                    color: 'orange',
+                },
                 {
                     name: 'Tutorials and guides',
                     url: '/docs/ai-engineering/tutorials',
                     icon: 'IconGraduationCap',
-                    color: 'yellow',
+                    color: 'seagreen',
                     featured: true,
                 },
                 {
-                    name: 'Integrations',
-                },
-                {
-                    name: 'LLM insights',
+                    name: 'Observability integrations',
                     url: '/docs/ai-engineering/llm-insights',
                     icon: 'IconAIText',
                     color: 'blue',
-                    featured: true,
-                },
-                {
-                    name: 'Helicone',
-                    url: '/docs/ai-engineering/helicone-posthog',
-                    icon: 'IconWrench',
-                    color: 'green',
-                },
-                {
-                    name: 'Keywords AI',
-                    url: '/docs/ai-engineering/keywords-ai-posthog',
-                    icon: 'IconWrench',
-                    color: 'blue',
-                },
-                {
-                    name: 'Langfuse',
-                    url: '/docs/ai-engineering/langfuse-posthog',
-                    icon: 'IconWrench',
-                    color: 'red',
-                },
-                {
-                    name: 'Traceloop',
-                    url: '/docs/ai-engineering/traceloop-posthog',
-                    icon: 'IconWrench',
-                    color: 'purple',
+                    children: [
+                        {
+                            name: 'Helicone',
+                            url: '/docs/ai-engineering/helicone-posthog',
+                        },
+                        {
+                            name: 'Langfuse',
+                            url: '/docs/ai-engineering/langfuse-posthog',
+                        },
+                        {
+                            name: 'Traceloop',
+                            url: '/docs/ai-engineering/traceloop-posthog',
+                        },
+                        {
+                            name: 'Keywords AI',
+                            url: '/docs/ai-engineering/keywords-ai-posthog',
+                        },
+                    ],
                 },
             ],
         },