diff --git a/docs/docs/concepts/tracing.md b/docs/docs/concepts/tracing.md new file mode 100644 index 000000000..a9aa954c3 --- /dev/null +++ b/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) + diff --git a/docs/docs/how-tos/enable-tracing.md b/docs/docs/how-tos/enable-tracing.md new file mode 100644 index 000000000..d1273b6d3 --- /dev/null +++ b/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= +``` + +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) \ No newline at end of file diff --git a/docs/docs/how-tos/observability.md b/docs/docs/how-tos/observability.md deleted file mode 100644 index d21656eeb..000000000 --- a/docs/docs/how-tos/observability.md +++ /dev/null @@ -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= -``` - -For more information, see [Trace with LangGraph](https://docs.smith.langchain.com/observability/how_to_guides/trace_with_langgraph). \ No newline at end of file diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index a3f6961d1..3dda84548 100644 --- a/docs/mkdocs.yml +++ b/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: