Skip to main content
LangWatch integrates with several third-party services for notifications, error tracking, and evaluation capabilities.

Email (SendGrid)

Email is used for alerts, team invitations, and system notifications.

Helm Configuration

app:
  email:
    enabled: true
    defaultFrom: "langwatch@yourcompany.com"
    provider: sendgrid
    providers:
      sendgrid:
        apiKey:
          secretKeyRef:
            name: langwatch-email
            key: sendgridApiKey

Environment Variables

VariableDescription
EMAIL_ENABLEDtrue to enable email
EMAIL_PROVIDERsendgrid
SENDGRID_API_KEYYour SendGrid API key
EMAIL_DEFAULT_FROMDefault sender address

Setup Steps

  1. Create a SendGrid account and generate an API key
  2. Verify your sender domain in SendGrid
  3. Configure the API key via the Helm chart or environment variable
  4. Test by inviting a team member in the LangWatch UI

Error Tracking (Sentry)

Capture application errors and exceptions for debugging.

Configuration

VariableDescription
SENTRY_DSNSentry DSN for the LangWatch app
app:
  extraEnvs:
    - name: SENTRY_DSN
      value: "https://examplePublicKey@o0.ingest.sentry.io/0"

Usage Analytics

LangWatch collects anonymous usage analytics by default to help improve the product. No trace data or PII is collected.

Disable Telemetry

app:
  telemetry:
    usage:
      enabled: false
Or via environment variable:
VariableDescription
DISABLE_USAGE_STATSSet to true to disable anonymous usage analytics

LLM Providers for Evaluations

LangWatch evaluators use external LLM providers for model-based evaluations (LLM-as-a-Judge, safety checks, etc.). Configure these if you want to use built-in evaluators.

Azure OpenAI

Used for jailbreak detection and content safety evaluators.
app:
  evaluators:
    azureOpenAI:
      enabled: true
      endpoint:
        secretKeyRef: { name: langwatch-evaluators, key: azureEndpoint }
      apiKey:
        secretKeyRef: { name: langwatch-evaluators, key: azureApiKey }
VariableDescription
AZURE_OPENAI_EVALUATOR_ENABLEDtrue to enable
AZURE_OPENAI_EVALUATOR_ENDPOINTAzure OpenAI endpoint URL
AZURE_OPENAI_EVALUATOR_API_KEYAzure OpenAI API key

Google AI

Used for PII detection evaluators.
app:
  evaluators:
    google:
      enabled: true
      credentials:
        secretKeyRef: { name: langwatch-evaluators, key: googleCredentials }
VariableDescription
GOOGLE_EVALUATOR_ENABLEDtrue to enable
GOOGLE_CREDENTIALS_JSONService account credentials JSON
You don’t need to configure evaluator providers to use LangWatch. They’re only required if you want to use built-in evaluators that rely on specific LLM providers. You can always configure your own LLM provider API keys in the LangWatch UI for evaluations.

Slack

LangWatch can send notifications to Slack channels via webhooks for alerts and automations. This is configured in the LangWatch UI under Automations, not via environment variables.

S3 / Object Storage

Used for dataset storage and ClickHouse cold storage/backups. See: