mirror of
https://github.com/langflow-ai/langflow.git
synced 2026-07-24 02:05:11 +08:00
174 lines
58 KiB
HTML
174 lines
58 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-Develop/logging" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v3.9.2">
|
||
<title data-rh="true">Logs | Langflow Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.langflow.org/next/logging"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Logs | Langflow Documentation"><meta data-rh="true" name="description" content="Langflow produces logs for individual flows and the Langflow application itself using the structlog library for logging."><meta data-rh="true" property="og:description" content="Langflow produces logs for individual flows and the Langflow application itself using the structlog library for logging."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.langflow.org/next/logging"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/next/logging" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/next/logging" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://UZK6BDPCVY-dsn.algolia.net" crossorigin="anonymous"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Logs","item":"https://docs.langflow.org/next/logging"}]}</script><link rel="preconnect" href="https://www.google-analytics.com">
|
||
<link rel="preconnect" href="https://www.googletagmanager.com">
|
||
<script async src="https://www.googletagmanager.com/gtag/js?id=G-SLQFLQ3KPT"></script>
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-SLQFLQ3KPT",{})</script>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml" title="Langflow Documentation" href="/opensearch.xml">
|
||
|
||
|
||
|
||
|
||
<script>window._ibmAnalytics={settings:{name:"DataStax",tealiumProfileName:"ibm-subsidiary"},trustarc:{privacyPolicyLink:"https://ibm.com/privacy"},"digitalData.page.services.google.enabled":!0},window.digitalData={page:{pageInfo:{ibm:{siteId:"IBM_"+_ibmAnalytics.settings.name},segment:{enabled:!0,env:"prod",key:"B04fNhD06DqDPuaRfQl5lZ2iQICdxxuh",coremetrics:!1,carbonComponentEvents:!1}},category:{primaryCategory:"PC230"}},commonProperties:{productTitle:"IBM Elite Support for Langflow",productCode:"5900BUB",productCodeType:"WWPC",UT30:"30AS5",instanceId:"docs-site",subscriptionId:"public-access",productPlanName:"Public",productPlanType:"freemium",userId:"IBMid-ANONYMOUS"}}</script>
|
||
<script src="//1.www.s81c.com/common/stats/ibm-common.js" async="true"></script>
|
||
|
||
|
||
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&family=Geist+Mono:wght@400;500&family=Sora:wght@550;600&display=swap">
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("consent","default",{ad_storage:"denied",ad_user_data:"denied",ad_personalization:"denied",analytics_storage:"denied"})</script>
|
||
<script>!function(){function e(){if(void 0!==window.truste&&window.truste.cma){var e=window.truste.cma.callApi("getConsent",window.location.href)||{},n=1===e[2],t=1===e[3];gtag("consent","update",{ad_storage:n?"granted":"denied",ad_user_data:n?"granted":"denied",ad_personalization:n?"granted":"denied",analytics_storage:t?"granted":"denied"})}}window.addEventListener&&(window.addEventListener("cm_data_subject_consent_changed",e),window.addEventListener("cm_consent_preferences_set",e)),"complete"===document.readyState?e():window.addEventListener("load",e)}()</script><link rel="stylesheet" href="/assets/css/styles.0d9d771d.css">
|
||
<script src="/assets/js/runtime~main.c313665b.js" defer="defer"></script>
|
||
<script src="/assets/js/main.12b252df.js" defer="defer"></script>
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<svg style="display: none;"><defs>
|
||
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
|
||
</defs></svg>
|
||
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/lf-docs-light.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/next/logging">1.11.x (Next)</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/next/logging">1.11.x (Next)</a></li><li><a class="dropdown__link" href="/logging">1.10.x</a></li><li><a class="dropdown__link" href="/1.9.0/logging">1.9.x</a></li><li><a class="dropdown__link" href="/1.8.0/logging">1.8.x</a></li></ul></div></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/langflow-ai/langflow" target="_blank" class="navbar__item navbar__link header-github-link" aria-label="GitHub" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-github" data-namespace="header" data-platform-title="Langflow"></a><a href="https://twitter.com/langflow_ai" target="_blank" class="navbar__item navbar__link header-twitter-link" aria-label="Twitter" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-twitter" data-namespace="header" data-platform-title="Langflow"></a><a href="https://discord.gg/EqksyE2EX9" target="_blank" class="navbar__item navbar__link header-discord-link" aria-label="Discord" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-discord" data-namespace="header" data-platform-title="Langflow"></a><div class="toggle_MW0i colorModeToggle_DEke"><button class="clean-btn toggleButton_yw5v toggleButtonDisabled_BJd7" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL lightToggleIcon_SFTY"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL darkToggleIcon_ekgs"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL systemToggleIcon_yi_a"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search (Meta+k)" aria-keyshortcuts="Meta+k"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="11" cy="11" r="8" stroke="currentColor" fill="none" stroke-width="1.4"></circle><path d="m21 21-4.3-4.3" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside aria-label="Documentation sidebar" class="theme-doc-sidebar-container docSidebarContainer_RSuS"><div class="sidebarViewport_pYEE"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Build</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-rocket"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next"><span title="Get started" class="categoryLinkLabel_W154">Get started</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-workflow"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/concepts-overview"><span title="Flows" class="categoryLinkLabel_W154">Flows</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-bot"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/agents"><span title="Agents" class="categoryLinkLabel_W154">Agents</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-plug"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/mcp-client"><span title="Model Context Protocol (MCP)" class="categoryLinkLabel_W154">Model Context Protocol (MCP)</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Develop & Deploy</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item sidebar-category-with-icon sidebar-icon-code"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" href="/next/api-keys-and-authentication"><span title="Develop" class="categoryLinkLabel_W154">Develop</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/api-keys-and-authentication"><span title="API keys and authentication" class="linkLabel_WmDU">API keys and authentication</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/jwt-authentication"><span title="JWT authentication" class="linkLabel_WmDU">JWT authentication</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/install-custom-dependencies"><span title="Install custom dependencies" class="linkLabel_WmDU">Install custom dependencies</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/configuration-global-variables"><span title="Global variables" class="linkLabel_WmDU">Global variables</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/environment-variables"><span title="Environment variables" class="linkLabel_WmDU">Environment variables</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" tabindex="0" href="/next/concepts-file-management"><span title="Storage and memory" class="categoryLinkLabel_W154">Storage and memory</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" tabindex="0" href="/next/logging"><span title="Observability" class="categoryLinkLabel_W154">Observability</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/next/logging"><span title="Logs" class="linkLabel_WmDU">Logs</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/next/observability-grafana-loki"><span title="Grafana and Loki" class="linkLabel_WmDU">Grafana and Loki</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/next/traces"><span title="Traces" class="linkLabel_WmDU">Traces</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-3 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" tabindex="0" href="/next/integrations-arize"><span title="Monitoring" class="categoryLinkLabel_W154">Monitoring</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/next/contributing-telemetry"><span title="Telemetry" class="linkLabel_WmDU">Telemetry</span></a></li></ul></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/data-types"><span title="Use Langflow data types" class="linkLabel_WmDU">Use Langflow data types</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/concepts-voice-mode"><span title="Use voice mode" class="linkLabel_WmDU">Use voice mode</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/next/configuration-cli"><span title="Use the Langflow CLI" class="linkLabel_WmDU">Use the Langflow CLI</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" tabindex="0" href="/next/extensions-overview"><span title="Bundle extensions" class="categoryLinkLabel_W154">Bundle extensions</span></a></div></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-cloud"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/deployment-overview"><span title="Deploy" class="categoryLinkLabel_W154">Deploy</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Reference</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-blocks"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/concepts-components"><span title="Components reference" class="categoryLinkLabel_W154">Components reference</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-fileCode"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/api-reference-api-examples"><span title="API reference" class="categoryLinkLabel_W154">API reference</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Community</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-gitPR"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/contributing-community"><span title="Contribute" class="categoryLinkLabel_W154">Contribute</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-helpCircle"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/next/troubleshoot"><span title="Support" class="categoryLinkLabel_W154">Support</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-ad">
|
||
<a href="https://www.langflow.org/desktop" target="_blank" rel="noopener noreferrer" class="menu__link">
|
||
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
|
||
<g clip-path="url(#clip0_1645_37)">
|
||
<path d="M12 17H20C21.1046 17 22 16.1046 22 15V13M12 17H4C2.89543 17 2 16.1046 2 15V5C2 3.89543 2.89543 3 4 3H10M12 17V21M8 21H12M12 21H16M11.75 10.2917H13.2083L16.125 7.375H17.5833L20.5 4.45833H21.9583M16.125 11.75H17.5833L20.5 8.83333H21.9583M11.75 5.91667H13.2083L16.125 3H17.5833" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||
</g>
|
||
<defs>
|
||
<clipPath id="clip0_1645_37">
|
||
<rect width="24" height="24" fill="white"/>
|
||
</clipPath>
|
||
</defs>
|
||
</svg>
|
||
<div class="sidebar-ad-text-container">
|
||
<span class="sidebar-ad-text">Get started in minutes</span>
|
||
<span class="sidebar-ad-text sidebar-ad-text-gradient">Download Langflow Desktop</span>
|
||
</div>
|
||
</a>
|
||
</li></ul></nav></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_z5aJ"><div class="theme-doc-version-banner alert alert--warning margin-bottom--md" role="alert"><div>This is unreleased documentation for <!-- -->Langflow Documentation<!-- --> <b>1.11.x (Next)</b> version.</div><div class="margin-top--md">For up-to-date documentation, see the <b><a href="/logging">latest version</a></b> (<!-- -->1.10.x<!-- -->).</div></div><div class="docItemContainer_c0TR"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" role="presentation" class="breadcrumbHomeIcon_xK9p"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Develop</span></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Observability</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Logs</span></li></ul></nav><div class="docMetaRow_c2hx"><div class="root_Eutc"><button type="button" class="button_gpNY"><span aria-hidden="true" class="icon_Bm9L"><svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></span><span class="label_LzDG">Copy page</span></button></div><span class="theme-doc-version-badge badge badge--secondary">Version: 1.11.x (Next)</span></div><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Logs</h1></header><style>[data-ch-theme="github-dark"] { --ch-t-colorScheme: dark;--ch-t-foreground: #c9d1d9;--ch-t-background: #0d1117;--ch-t-lighter-inlineBackground: #0d1117e6;--ch-t-editor-background: #0d1117;--ch-t-editor-foreground: #c9d1d9;--ch-t-editor-lineHighlightBackground: #6e76811a;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #264F78;--ch-t-focusBorder: #1f6feb;--ch-t-tab-activeBackground: #0d1117;--ch-t-tab-activeForeground: #c9d1d9;--ch-t-tab-inactiveBackground: #010409;--ch-t-tab-inactiveForeground: #8b949e;--ch-t-tab-border: #30363d;--ch-t-tab-activeBorder: #0d1117;--ch-t-editorGroup-border: #30363d;--ch-t-editorGroupHeader-tabsBackground: #010409;--ch-t-editorLineNumber-foreground: #6e7681;--ch-t-input-background: #0d1117;--ch-t-input-foreground: #c9d1d9;--ch-t-input-border: #30363d;--ch-t-icon-foreground: #8b949e;--ch-t-sideBar-background: #010409;--ch-t-sideBar-foreground: #c9d1d9;--ch-t-sideBar-border: #30363d;--ch-t-list-activeSelectionBackground: #6e768166;--ch-t-list-activeSelectionForeground: #c9d1d9;--ch-t-list-hoverBackground: #6e76811a;--ch-t-list-hoverForeground: #c9d1d9; }</style>
|
||
<!-- -->
|
||
<p>Langflow produces logs for individual flows and the Langflow application itself using the <a href="https://www.structlog.org" target="_blank" rel="noopener noreferrer" class="">structlog</a> library for logging.</p>
|
||
<p>By default, OSS Langflow writes logs to stdout. To write logs to a file, set <code>LANGFLOW_LOG_FILE</code> to the desired path.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="log-storage">Log storage<a href="#log-storage" class="hash-link" aria-label="Direct link to Log storage" title="Direct link to Log storage" translate="no"></a></h2>
|
||
<p>The <code>LANGFLOW_CONFIG_DIR</code> environment variable controls where Langflow stores its configuration and data files. The default location depends on your operating system:</p>
|
||
<ul>
|
||
<li class="">
|
||
<p><strong>Langflow Desktop</strong>:</p>
|
||
<ul>
|
||
<li class=""><strong>macOS</strong>: <code>/Users/<username>/Library/Logs/com.LangflowDesktop</code></li>
|
||
<li class=""><strong>Windows</strong>: <code>C:\Users\<username>\AppData\Local\com.LangflowDesktop\logs</code></li>
|
||
</ul>
|
||
</li>
|
||
<li class="">
|
||
<p><strong>OSS Langflow</strong> (all installation methods, including <code>uv pip install</code> and <code>git clone</code>):</p>
|
||
<ul>
|
||
<li class=""><strong>macOS</strong>: <code>/Users/<username>/Library/Caches/langflow</code></li>
|
||
<li class=""><strong>Linux</strong>: <code>/home/<username>/.cache/langflow</code></li>
|
||
<li class=""><strong>Windows/WSL</strong>: <code>C:\Users\<username>\AppData\Local\langflow\langflow\Cache</code></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
<p>To customize log storage locations and behaviors, set the following <a class="" href="/environment-variables">Langflow environment variables</a> in your Langflow <code>.env</code> file, and then start Langflow with <code>uv run langflow run --env-file .env</code>:</p>
|
||
<table><thead><tr><th>Variable</th><th class="col-center">Format</th><th class="col-center">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>LANGFLOW_CONFIG_DIR</code></td><td class="col-center">String</td><td class="col-center">Varies</td><td>Set the Langflow configuration directory where files and logs are stored. Default path depends on your installation, as described in the preceding list.</td></tr><tr><td><code>LANGFLOW_ENABLE_LOG_RETRIEVAL</code></td><td class="col-center">Boolean</td><td class="col-center"><code>False</code></td><td>Enables retrieval of logs from your Langflow instance with <a class="" href="/api-logs">Logs endpoints</a>.</td></tr><tr><td><code>LANGFLOW_ENVIRONMENT</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Adds an <code>environment</code> field to every JSON log record when set (<code>staging</code>, <code>production</code>, etc.). Omitted otherwise.</td></tr><tr><td><code>LANGFLOW_LOG_ENV</code></td><td class="col-center">String</td><td class="col-center"><code>default</code></td><td>Primary log format controller. <code>container</code> or <code>container_json</code>: JSON format via <a href="https://www.structlog.org/en/stable/api.html#structlog.processors.JSONRenderer" target="_blank" rel="noopener noreferrer" class=""><code>JSONRenderer</code></a>. <code>container_csv</code>: Key-value format. <code>default</code> or unset: uses <code>LANGFLOW_PRETTY_LOGS</code> to determine format. See <a href="#json-log-format" class="">JSON log format</a>.</td></tr><tr><td><code>LANGFLOW_LOG_FILE</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Sets the log file storage location. For example, <code>LANGFLOW_LOG_FILE=path/to/logfile.log</code>. If not set, logs are written to stdout.</td></tr><tr><td><code>LANGFLOW_LOG_FORMAT</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Set to <code>key_value</code> for key-value format or <code>console</code> for <a href="https://www.structlog.org/en/stable/console-output.html" target="_blank" rel="noopener noreferrer" class=""><code>ConsoleRenderer</code></a>. Only applies when <code>LANGFLOW_LOG_ENV=default</code> and <code>LANGFLOW_PRETTY_LOGS=true</code>.</td></tr><tr><td><code>LANGFLOW_LOG_LEVEL</code></td><td class="col-center">String</td><td class="col-center"><code>ERROR</code></td><td>Global log level. One of <code>DEBUG</code>, <code>INFO</code>, <code>WARNING</code>, <code>ERROR</code>, or <code>CRITICAL</code>.</td></tr><tr><td><code>LANGFLOW_LOG_LEVELS</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Per-logger level overrides as <code>name=LEVEL,name=LEVEL</code>. Overrides <code>LANGFLOW_LOG_LEVEL</code> for specific loggers without changing the global default. Malformed entries raise a <code>UserWarning</code> at startup. Example: <code>sqlalchemy.engine=WARNING,httpx=INFO</code>.</td></tr><tr><td><code>LANGFLOW_LOG_REDACT_KEYS</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Comma-separated extra keys to scrub from JSON log records, on top of the defaults (<code>password</code>, <code>api_key</code>, <code>token</code>, <code>authorization</code>, <code>cookie</code>, etc.).</td></tr><tr><td><code>LANGFLOW_LOG_RETRIEVER_BUFFER_SIZE</code></td><td class="col-center">Integer</td><td class="col-center"><code>10000</code></td><td>Buffer size for log retrieval when <code>LANGFLOW_ENABLE_LOG_RETRIEVAL=True</code>. Must be greater than <code>0</code>.</td></tr><tr><td><code>LANGFLOW_LOG_ROTATION</code></td><td class="col-center">String</td><td class="col-center"><code>1 day</code></td><td>Controls log file rotation by time (<code>1 day</code>, <code>12 hours</code>, <code>1 week</code>) or size (<code>10 MB</code>, <code>1 GB</code>). Set to <code>None</code> to disable rotation.</td></tr><tr><td><code>LANGFLOW_LOG_TRACE_LOCALS</code></td><td class="col-center">Boolean</td><td class="col-center"><code>false</code></td><td>Include frame locals in structured tracebacks. Off by default because locals can leak secrets; enable only for local debugging.</td></tr><tr><td><code>LANGFLOW_NATIVE_TRACING</code></td><td class="col-center">Boolean</td><td class="col-center"><code>true</code></td><td>Enables the tracer to record execution traces in the Langflow database for use in Trace View. Set to <code>false</code> to disable.</td></tr><tr><td><code>LANGFLOW_PRETTY_LOGS</code></td><td class="col-center">Boolean</td><td class="col-center"><code>True</code></td><td>Controls output format when <code>LANGFLOW_LOG_ENV=default</code> or unset. <code>true</code>: <a href="https://www.structlog.org/en/stable/console-output.html" target="_blank" rel="noopener noreferrer" class=""><code>ConsoleRenderer</code></a> (human-readable). <code>false</code>: JSON format.</td></tr><tr><td><code>LANGFLOW_SERVICE_NAME</code></td><td class="col-center">String</td><td class="col-center"><code>langflow</code></td><td>Value of the <code>service</code> field on every JSON log record. Used as a label by log aggregators. See <a class="" href="/next/observability-grafana-loki">Grafana and Loki</a>.</td></tr><tr><td><code>LANGFLOW_VERSION</code></td><td class="col-center">String</td><td class="col-center">Not set</td><td>Adds a <code>version</code> field to every JSON log record when set. Omitted otherwise.</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="view-logs-in-real-time">View logs in real-time<a href="#view-logs-in-real-time" class="hash-link" aria-label="Direct link to View logs in real-time" title="Direct link to View logs in real-time" translate="no"></a></h2>
|
||
<p>By default, OSS Langflow writes logs to stdout. To write logs to a file that you can tail, do the following:</p>
|
||
<ol>
|
||
<li class="">
|
||
<p>Set <code>LANGFLOW_LOG_FILE</code> to a file path in your <code>.env</code> file:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_FILE=/path/to/langflow.log</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Start Langflow with your <code>.env</code> file:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>uv run langflow run --env-file .env</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Change to the directory where you set <code>LANGFLOW_LOG_FILE</code>:</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>cd /Users/**USERNAME**/Library/Caches/langflow</span></div></div><br></code></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>cd C:\Users\**USERNAME**\AppData\Local\com.LangflowDesktop\logs</span></div></div><br></code></div></div></div></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Tail the log file:</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>tail -f langflow.log</span></div></div><br></code></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>Get-Content -Wait -Path langflow.log</span></div></div><br></code></div></div></div></div></div>
|
||
<p>If you don't see new log entries, check that Langflow is running, and perform some actions to generate logs events. You can also check the terminal where you started Langflow to see if logs are being printed there.</p>
|
||
</li>
|
||
</ol>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="flow-and-component-logs">Flow and component logs<a href="#flow-and-component-logs" class="hash-link" aria-label="Direct link to Flow and component logs" title="Direct link to Flow and component logs" translate="no"></a></h2>
|
||
<p>After you run a flow, you can inspect the logs for each component and flow run.
|
||
For example, you can inspect <code>Message</code> objects ingested and generated by <a class="" href="/chat-input-and-output">Input and Output components</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="view-flow-logs">View flow logs<a href="#view-flow-logs" class="hash-link" aria-label="Direct link to View flow logs" title="Direct link to View flow logs" translate="no"></a></h3>
|
||
<p>In the visual editor, click <strong>Logs</strong> to view logs for the entire flow:</p>
|
||
<p><img decoding="async" loading="lazy" alt="Logs pane" src="/assets/images/logs-cc30f076e63a5e443cf04855559703a3.png" width="4000" height="2180" class="img_ev3q"></p>
|
||
<p>Then, click the cells in the <strong>inputs</strong> and <strong>outputs</strong> columns to inspect the <code>Message</code> objects.
|
||
For example, the following <code>Message</code> data could be the output from a <strong>Chat Input</strong> component:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "messages": [</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "message": "What's the recommended way to install Docker on Mac M1?",</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "sender": "User",</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "sender_name": "User",</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "session_id": "Session Apr 21, 17:37:04",</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "stream_url": null,</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "component_id": "ChatInput-4WKag",</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "files": [],</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> "type": "text"</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->12</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><br></code></div></div>
|
||
<p>In the case of Input/Output components, the original input might not be structured as a <code>Message</code> object.
|
||
For example, a language model component can pass a raw text response to a <strong>Chat Output</strong> component that is then transformed into a <code>Message</code> object.</p>
|
||
<p>You can find <code>.log</code> files for flows at your Langflow installation's log storage location.
|
||
For filepaths, see <a href="#log-storage" class="">Log storage</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="view-chat-logs">View chat logs<a href="#view-chat-logs" class="hash-link" aria-label="Direct link to View chat logs" title="Direct link to View chat logs" translate="no"></a></h3>
|
||
<p>In the <strong>Playground</strong>, you can inspect the chat history for each chat session.
|
||
For more information, see <a class="" href="/concepts-playground#view-chat-history">View chat history</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="view-output-from-a-single-component">View output from a single component<a href="#view-output-from-a-single-component" class="hash-link" aria-label="Direct link to View output from a single component" title="Direct link to View output from a single component" translate="no"></a></h3>
|
||
<p>When debugging issues with the format or content of a flow's output, it can help to inspect each component's output to determine where data is being lost or malformed.</p>
|
||
<p>To view the output produced by a single component during the most recent run, click <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-text-search lf-inline-icon" aria-hidden="true" focusable="false" role="presentation"><path d="M21 6H3"></path><path d="M10 12H3"></path><path d="M10 18H3"></path><circle cx="17" cy="15" r="3"></circle><path d="m21 19-1.9-1.9"></path></svg> <strong>Inspect output</strong> on the component in the visual editor.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="desktop-logs">Access Langflow Desktop logs<a href="#desktop-logs" class="hash-link" aria-label="Direct link to Access Langflow Desktop logs" title="Direct link to Access Langflow Desktop logs" translate="no"></a></h2>
|
||
<p>If you encounter issues with Langflow Desktop, you might need to access startup logs for debugging.
|
||
Follow the steps for your operating system.</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><ol>
|
||
<li class="">
|
||
<p>Open Terminal and run:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>cd ~/Library/Logs/com.LangflowDesktop</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>To open the folder and view the log files, run the command:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>open .</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Locate the <code>langflow.log</code> file.</p>
|
||
</li>
|
||
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
|
||
<li class="">
|
||
<p>Open the Command Prompt (CMD), and then run the following command:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>cd %LOCALAPPDATA%\com.LangflowDesktop\cache</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Open the folder and view the log files:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>start .</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Locate the <code>langflow.log</code> file.</p>
|
||
</li>
|
||
</ol></div></div></div>
|
||
<p>You can use the log file to investigate the issue on your own, add context to a <a class="" href="/contributing-github-issues">GitHub Issue</a>, or send it to <a class="" href="/luna-for-langflow">support</a> for debugging assistance.</p>
|
||
<p>The log file is only created when Langflow Desktop runs. If you don't see a log file, try starting Langflow Desktop first, then check for the log file.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="log-format">Log format<a href="#log-format" class="hash-link" aria-label="Direct link to Log format" title="Direct link to Log format" translate="no"></a></h2>
|
||
<p>By default, structlog uses <a href="https://www.structlog.org/en/stable/api.html#structlog.dev.ConsoleRenderer" target="_blank" rel="noopener noreferrer" class=""><code>ConsoleRenderer</code></a> to produce human-readable output with the following structure:</p>
|
||
<p>For example:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>2026-05-17T18:18:29Z [info ] incoming request logger=langflow.api.run flow_id=flow-718 user_id=user-4823</span></div></div><br></code></div></div>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="json-log-format">JSON log format<a href="#json-log-format" class="hash-link" aria-label="Direct link to JSON log format" title="Direct link to JSON log format" translate="no"></a></h3>
|
||
<p>Set <code>LANGFLOW_LOG_ENV=container</code> to switch structlog's terminal processor to <a href="https://www.structlog.org/en/stable/api.html#structlog.processors.JSONRenderer" target="_blank" rel="noopener noreferrer" class=""><code>JSONRenderer</code></a>, so every line written to stdout is a JSON object containing the event message, level, timestamp, logger name, exception structure, and service metadata.</p>
|
||
<p>A typical record in JSON mode looks like the following:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span>{</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "event": "incoming request",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "level": "info",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "logger": "langflow.api.run",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "timestamp": "2026-05-17T18:18:29.100798Z",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "service": "langflow",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "version": "1.10.0",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "environment": "production",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "user_id": "user-4823",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "flow_id": "flow-718",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "authorization": "***",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "cookie": "***",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "request_body": {</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "input": "Tell me a joke",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "api_key": "***",</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> "session_id": "Session Apr 21, 17:37:04"</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->18</span><div style="display:inline-block;margin-left:16px"><span>}</span></div></div><br></code></div></div>
|
||
<p>When a log record includes an exception, the <code>exception</code> field contains a structured traceback instead of a plain string:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span>{</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "event": "flow run failed",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "level": "error",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "logger": "langflow.api.run",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "timestamp": "2026-05-17T18:18:32.412Z",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "service": "langflow",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "exception": [</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "exc_type": "ConnectionError",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "exc_value": "upstream returned 503",</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> "frames": [</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> {"filename": "/app/.../runner.py", "lineno": 142, "name": "run_flow"}</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_<!-- -->16</span><div style="display:inline-block;margin-left:16px"><span>}</span></div></div><br></code></div></div>
|
||
<p>Frame locals, which are local variables at each stack frame, are intentionally excluded by default because they can contain API keys, request bodies, and environment values. Set <code>LANGFLOW_LOG_TRACE_LOCALS=true</code> to include them for local debugging.</p>
|
||
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="stdlib-loggers">Stdlib loggers<a href="#stdlib-loggers" class="hash-link" aria-label="Direct link to Stdlib loggers" title="Direct link to Stdlib loggers" translate="no"></a></h4>
|
||
<p>Third-party libraries that use Python's standard logging module (<code>uvicorn</code>, <code>sqlalchemy</code>, <code>httpx</code>, <code>langchain</code>, <code>asyncio</code>) are routed through the same JSON stream in container mode. Their original logger name is preserved on the <code>logger</code> field, so log queries that work for application loggers also work for library output.</p>
|
||
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="opentelemetry-trace-correlation">OpenTelemetry trace correlation<a href="#opentelemetry-trace-correlation" class="hash-link" aria-label="Direct link to OpenTelemetry trace correlation" title="Direct link to OpenTelemetry trace correlation" translate="no"></a></h4>
|
||
<p>If <code>opentelemetry-api</code> is installed and an active span is present, every log record automatically picks up <code>trace_id</code> and <code>span_id</code>. OpenTelemetry is not a hard dependency; if it is not installed, the processor is a no-op and nothing else changes.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="see-also">See also<a href="#see-also" class="hash-link" aria-label="Direct link to See also" title="Direct link to See also" translate="no"></a></h2>
|
||
<ul>
|
||
<li class=""><a class="" href="/next/observability-grafana-loki">Grafana and Loki</a></li>
|
||
<li class=""><a class="" href="/api-logs">Logs endpoints</a></li>
|
||
<li class=""><a class="" href="/memory">Memory management options</a></li>
|
||
<li class=""><a class="" href="/configuration-custom-database">Configure an external PostgreSQL database</a></li>
|
||
<li class=""><a class="" href="/next/observability-grafana-loki">Grafana and Loki</a></li>
|
||
</ul></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/next/memory-bases"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Manage memory bases</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/next/observability-grafana-loki"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Grafana and Loki</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#log-storage" class="table-of-contents__link toc-highlight">Log storage</a></li><li><a href="#view-logs-in-real-time" class="table-of-contents__link toc-highlight">View logs in real-time</a></li><li><a href="#flow-and-component-logs" class="table-of-contents__link toc-highlight">Flow and component logs</a><ul><li><a href="#view-flow-logs" class="table-of-contents__link toc-highlight">View flow logs</a></li><li><a href="#view-chat-logs" class="table-of-contents__link toc-highlight">View chat logs</a></li><li><a href="#view-output-from-a-single-component" class="table-of-contents__link toc-highlight">View output from a single component</a></li></ul></li><li><a href="#desktop-logs" class="table-of-contents__link toc-highlight">Access Langflow Desktop logs</a></li><li><a href="#log-format" class="table-of-contents__link toc-highlight">Log format</a><ul><li><a href="#json-log-format" class="table-of-contents__link toc-highlight">JSON log format</a></li></ul></li><li><a href="#see-also" class="table-of-contents__link toc-highlight">See also</a></li></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title"></div><ul class="footer__items clean-list"><li class="footer__item"><div class="footer-links">
|
||
<span>© 2026 Langflow</span>
|
||
<span id="preferenceCenterContainer"> · <a href="#" onclick='return"undefined"!=typeof window&&window.truste&&window.truste.eu&&window.truste.eu.clickListener&&window.truste.eu.clickListener(),!1' style="cursor: pointer;">Manage Privacy Choices</a></span>
|
||
</div></li></ul></div></div></div></footer><div style="position:fixed;right:21px;bottom:21px;z-index:100;display:flex;align-items:center;gap:10px;cursor:pointer"><div style="background-color:#f6f6f6;border-radius:50%;width:48px;height:48px;display:flex;align-items:center;justify-content:center;box-shadow:0 2px 4px rgba(0,0,0,0.1)"><img src="/img/langflow-icon-black-transparent.svg" style="width:40px" alt="Search"></div></div></div>
|
||
</body>
|
||
</html> |