This tutorial shows how to set up Keywords AI tracing with Mastra to monitor and trace your AI-powered applications. To help you get started quickly, we’ve provided a pre-built example. You can find the code on GitHub.

​
Setup

Here’s the tutorial about the Mastra Weather Agent example.

​
1. Install Dependencies

pnpm install

​
2. Environment Variables

Copy the example environment file and add your API keys: 
cp .env.local.example .env.local
Update .env.local with your credentials:
.env.local
OPENAI_API_KEY=your-openai-api-key
KEYWORDSAI_API_KEY=your-keywordsai-api-key
KEYWORDSAI_BASE_URL=https://api.keywordsai.co

​
3. Setup Mastra client with Keywords AI tracing

Configure with KeywordsAI telemetry in src/mastra/index.ts: 
telemetry: {
  serviceName: "keywordai-mastra-example",
  enabled: true,

# ===== Add this section =====
  export: {
    type: "custom",
    exporter: new KeywordsAIExporter({
      apiKey: process.env.KEYWORDSAI_API_KEY,
      baseUrl: process.env.KEYWORDSAI_BASE_URL,
      debug: true,
    })
  }
}

​
3. Run the Project

mastra dev
This opens the Mastra playground where you can interact with the weather agent.

​
Observability

Once configured, you can view your traces and analytics in the Keywords AI platform.