Update docs to change to “observability” and “dashboards”

Author: samejr

docs/docs.json

@@ -180,8 +180,8 @@
             ]
           },
           {
-            "group": "Insights",
-            "pages": ["insights/query", "insights/metrics"]
+            "group": "Observability",
+            "pages": ["observability/query", "observability/dashboards"]
           },
           {
             "group": "Using the Dashboard",
@@ -239,11 +239,20 @@
           },
           {
             "group": "Tasks API",
-            "pages": ["management/tasks/trigger", "management/tasks/batch-trigger", "management/tasks/trigger-batch"]
+            "pages": [
+              "management/tasks/trigger",
+              "management/tasks/batch-trigger",
+              "management/tasks/trigger-batch"
+            ]
           },
           {
             "group": "Batches API",
-            "pages": ["management/batches/create", "management/batches/retrieve", "management/batches/retrieve-results", "management/batches/stream-items"]
+            "pages": [
+              "management/batches/create",
+              "management/batches/retrieve",
+              "management/batches/retrieve-results",
+              "management/batches/stream-items"
+            ]
           },
           {
             "group": "Runs API",
@@ -712,6 +721,14 @@
     {
       "source": "/upgrade-to-v4",
       "destination": "/migrating-from-v3"
+    },
+    {
+      "source": "/insights/query",
+      "destination": "/observability/query"
+    },
+    {
+      "source": "/insights/metrics",
+      "destination": "/observability/dashboards"
     }
   ]
 }

docs/logging.mdx

@@ -82,7 +82,7 @@ export const customTrace = task({
 
 Trigger.dev collects system and runtime metrics automatically for deployed tasks, and provides an API for recording custom metrics using OpenTelemetry.
 
-You can view metrics in the [Metrics dashboards](/insights/metrics), query them with [TRQL](/insights/query), and export them to external services via [telemetry exporters](/config/config-file#telemetry-exporters).
+You can view metrics in the [Dashboards](/observability/dashboards), query them with [TRQL](/observability/query), and export them to external services via [telemetry exporters](/config/config-file#telemetry-exporters).
 
 ### Custom metrics API
 
@@ -175,7 +175,7 @@ All metrics (both automatic and custom) are tagged with run context so you can f
 
 ### Querying metrics
 
-Use [TRQL](/insights/query) to query metrics data. For example, to see average CPU utilization over time:
+Use [TRQL](/observability/query) to query metrics data. For example, to see average CPU utilization over time:
 
 ```sql
 SELECT
@@ -188,7 +188,7 @@ ORDER BY timeBucket
 LIMIT 1000
 ```
 
-See the [Query page](/insights/query#metrics-table-columns) for the full `metrics` table schema.
+See the [Query page](/observability/query#metrics-table-columns) for the full `metrics` table schema.
 
 ### Exporting metrics
 

docs/management/query/execute.mdx

@@ -3,7 +3,7 @@ title: "Execute a query"
 openapi: "v3-openapi POST /api/v1/query"
 ---
 
-See the [Query documentation](/insights/query#example-queries) for comprehensive examples including:
+See the [Query documentation](/observability/query#example-queries) for comprehensive examples including:
 
 - Failed runs analysis
 - Task success rates over time

docs/insights/metrics.mdx docs/observability/dashboards.mdxdocs/insights/metrics.mdx renamed to docs/observability/dashboards.mdx

@@ -1,19 +1,19 @@
 ---
-title: "Metrics dashboards"
+title: "Dashboards"
 description: "Create custom dashboards with real-time metrics powered by TRQL queries."
 ---
 
 ## Overview
 
 In the Trigger.dev dashboard we have built-in dashboards and you can create your own.
 
-Metrics dashboards are powered by [TRQL queries](/insights/query) with widgets that can be displayed as charts, tables, or single values. They automatically refresh to show the latest data.
+Dashboards are powered by [TRQL queries](/observability/query) with widgets that can be displayed as charts, tables, or single values. They automatically refresh to show the latest data.
 
 ### Available metrics data
 
 Trigger.dev automatically collects process metrics (CPU, memory) and Node.js runtime metrics (event loop, heap) for all deployed tasks -- no configuration needed. Requires SDK version **4.4.1 or later**. You can also create custom metrics using the `otel.metrics` API from the SDK.
 
-All of this data is available in the `metrics` table for use in dashboard widgets. See [Logging, tracing & metrics](/logging#metrics) for the full list of automatic metrics and how to create custom ones, or the [Query page](/insights/query#metrics-table-columns) for the `metrics` table schema.
+All of this data is available in the `metrics` table for use in dashboard widgets. See [Logging, tracing & metrics](/logging#metrics) for the full list of automatic metrics and how to create custom ones, or the [Query page](/observability/query#metrics-table-columns) for the `metrics` table schema.
 
 ![The built-in Metrics dashboard](/images/metrics-built-in.png)
 
@@ -37,12 +37,12 @@ You can also filter the data by:
 - Tasks
 - Queues
 
-## Creating custom metrics dashboards
+## Creating custom dashboards
 
-1. In the sidebar click the + icon next to "Metrics".
+1. In the sidebar click the + icon next to "Dashboards".
 2. Name your custom dashboard.
 3. From the top-right you can "Add chart" or "Add title".
-4. For charts you write [TRQL queries](/insights/query) and choose a visualization type.
+4. For charts you write [TRQL queries](/observability/query) and choose a visualization type.
 5. You can resize and reposition widgets on your dashboards.
 
 ## Performance considerations
@@ -91,7 +91,7 @@ Export data from any metric widget:
 
 ## Limits
 
-Metrics is powered by Query so have [the same limits](/insights/query#limits) as Query.
+Dashboards are powered by Query so have [the same limits](/observability/query#limits) as Query.
 
 There is a separate concurrency limits for metric widgets.
 

docs/insights/query.mdx docs/observability/query.mdxdocs/insights/query.mdx renamed to docs/observability/query.mdx

@@ -25,7 +25,7 @@ description: "Query allows you to write custom queries against your data using T
 | `environment_type` | string | `PRODUCTION`, `STAGING`, `DEVELOPMENT`, `PREVIEW` |
 | `attributes` | json | Raw JSON attributes for custom data |
 
-See [Logging, tracing & metrics](/logging#automatic-system-and-runtime-metrics) for the full list of automatically collected metrics and how to create custom metrics.
+See [Logging, tracing & metrics](/logging#automatic-system-and-runtime-metrics) for the full list of automatically collected metrics and how to create custom metrics. You can visualize this data on [Dashboards](/observability/dashboards).
 
 ### `prettyFormat()`