docs: More tracing (#5545)

docs: add more about tracing

docs/docs/concepts/tracing.md

@@ -0,0 +1,17 @@
+# Tracing
+
+Traces are a series of steps that your application takes to go from input to output. Each of these individual steps is represented by a run. You can use [LangSmith](https://smith.langchain.com/) to visualize these execution steps. To use it, [enable tracing for your application](../how-tos/enable-tracing.md). This enables you to do the following:
+
+- [Debug a locally running application](../cloud/how-tos/clone_traces_studio.md).
+- [Evaluate the application performance](../agents/evals.md).
+- [Monitor the application](https://docs.smith.langchain.com/observability/how_to_guides/dashboards).
+
+To get started, sign up for a free account at [LangSmith](https://smith.langchain.com/).
+
+## Learn more
+
+- [Graph runs in LangSmith](../how-tos/run-id-langsmith.md)
+- [LangSmith Observability quickstart](https://docs.smith.langchain.com/observability)
+- [Trace with LangGraph](https://docs.smith.langchain.com/observability/how_to_guides/trace_with_langgraph)
+- [Tracing conceptual guide](https://docs.smith.langchain.com/observability/concepts#traces)
+

docs/docs/how-tos/enable-tracing.md

@@ -0,0 +1,16 @@
+# Enable tracing for your application
+
+To enable [tracing](../concepts/tracing.md) for your application, set the following environment variables:
+
+```python
+export LANGSMITH_TRACING=true
+export LANGSMITH_API_KEY=<your-api-key>
+```
+
+For more information, see [Trace with LangGraph](https://docs.smith.langchain.com/observability/how_to_guides/trace_with_langgraph).
+
+## Learn more
+
+- [Graph runs in LangSmith](../how-tos/run-id-langsmith.md)
+- [LangSmith Observability quickstart](https://docs.smith.langchain.com/observability)
+- [Tracing conceptual guide](https://docs.smith.langchain.com/observability/concepts#traces)

docs/docs/how-tos/observability.md

@@ -1,21 +0,0 @@
-# Observability
-
-Use [LangSmith](https://smith.langchain.com/) to visualize the execution of a LangGraph application and do the following:
-
-- [Enable tracing for your application](#enable-tracing-for-your-application).
-- [Debug a locally running application](../cloud/how-tos/clone_traces_studio.md).
-- [Evaluate the application performance](../agents/evals.md).
-- [Monitor the application](https://docs.smith.langchain.com/observability/how_to_guides/dashboards).
-
-To get started, sign up for a free account at [LangSmith](https://smith.langchain.com/).
-
-## Enable tracing for your application
-
-To use LangSmith with your LangGraph application, enable tracing:
-
-```python
-export LANGSMITH_TRACING=true
-export LANGSMITH_API_KEY=<your-api-key>
-```
-
-For more information, see [Trace with LangGraph](https://docs.smith.langchain.com/observability/how_to_guides/trace_with_langgraph).

docs/mkdocs.yml

@@ -157,8 +157,9 @@ nav:
           - Overview: concepts/mcp.md
           - Use MCP: agents/mcp.md
           - Server API: concepts/server-mcp.md
-      - Observability:
-          - Overview: how-tos/observability.md
+      - Tracing:
+          - Overview: concepts/tracing.md
+          - Enable tracing: how-tos/enable-tracing.md
           - Evaluate performance: agents/evals.md
     - Platform-only capabilities:
       - LangGraph Platform: