Skip to content

Add per-workflow LangSmith tracing configuration docs#4570

Open
mjain wants to merge 2 commits into
n8n-io:mainfrom
mjain:feature/workflow-level-langsmith-overridde
Open

Add per-workflow LangSmith tracing configuration docs#4570
mjain wants to merge 2 commits into
n8n-io:mainfrom
mjain:feature/workflow-level-langsmith-overridde

Conversation

@mjain
Copy link
Copy Markdown
Contributor

@mjain mjain commented May 5, 2026

Summary

  • Add documentation for the new per-workflow LangSmith tracing settings in workflow settings(Code Change PR:feat(ai): Add workflow-level LangSmith tracing override n8n#29783)
  • Documents the LangSmith Credential and LangSmith Project options that allow users to configure LangSmith tracing on individual workflows, overriding instance-level environment variables

Summary by cubic

Documented per-workflow LangSmith tracing so you can route AI node traces from specific workflows to different projects or accounts without changing global settings. Added step-by-step setup for a LangSmith API credential (stored with n8n credential encryption) and updated Workflow Settings with a LangSmith section to select a credential and project (defaults to "default"); workflow-level settings override instance env vars like LANGCHAIN_PROJECT.

Written for commit ec5e259. Summary will update on new commits.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 5, 2026

Deploy Preview for n8n-docs failed.

Name Link
🔨 Latest commit ec5e259
🔍 Latest deploy log https://app.netlify.com/projects/n8n-docs/deploys/6a014f08fc6ca300083f0272

@mjain mjain force-pushed the feature/workflow-level-langsmith-overridde branch from 9dc1072 to a5a33c4 Compare May 5, 2026 12:22
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 5, 2026

CLA assistant check
All committers have signed the CLA.

@mjain mjain force-pushed the feature/workflow-level-langsmith-overridde branch from a5a33c4 to 890747d Compare May 5, 2026 12:24
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

Architecture diagram
sequenceDiagram
    participant User
    participant n8nUI as n8n UI
    participant WorkflowSettings as Workflow Settings
    participant CredentialStore as Credential Store
    participant CodeChangePR as n8n Backend (from Code Change PR)
    participant LangSmithAPI as LangSmith API
    
    Note over User,LangSmithAPI: Per-Workflow LangSmith Tracing Configuration Flow
    
    User->>n8nUI: Opens workflow settings
    n8nUI->>WorkflowSettings: Display LangSmith section
    
    Note over User,CredentialStore: Setup LangSmith Credential
    
    User->>n8nUI: Go to Settings > Credentials > Add Credential
    n8nUI->>CredentialStore: Select LangSmith API credential type
    User->>n8nUI: Enter API Key from LangSmith settings
    n8nUI->>CredentialStore: Save LangSmith API credential
    CredentialStore->>CredentialStore: Encrypt and store API key
        
    Note over User,WorkflowSettings: Configure Workflow Tracing
    
    User->>WorkflowSettings: Select LangSmith Credential
    User->>WorkflowSettings: Enter LangSmith Project name (defaults to "default")
    User->>WorkflowSettings: Save workflow settings
    WorkflowSettings->>CodeChangePR: Pass per-workflow LangSmith config
    CodeChangePR->>CodeChangePR: Override instance-level env vars for this workflow
    
    alt AI Node Execution Started
        WorkflowSettings->>CodeChangePR: Trigger execution with LangSmith config
        CodeChangePR->>CredentialStore: Retrieve LangSmith API credential
        CredentialStore-->>CodeChangePR: Decrypted API key
        CodeChangePR->>LangSmithAPI: Send traces to configured project
        LangSmithAPI-->>CodeChangePR: Trace recorded
    else Instance-level env vars used (no per-workflow config)
        Note over CodeChangePR: Fallback to LANGCHAIN_PROJECT env var
    end
Loading

@RoRoJ RoRoJ added the status:pending-dev Blocked pending merge of related dev PR label May 12, 2026
@github-actions
Copy link
Copy Markdown

Thanks @mjain! We'll hold off on reviewing this until the PR is ready to go in the main repo.

@RoRoJ RoRoJ added author:community Contribution from an external contributor, outside n8n. and removed community-contribution labels May 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author:community Contribution from an external contributor, outside n8n. status:pending-dev Blocked pending merge of related dev PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants