Skip to content

Log Analysis

AI-Starter provides log analysis features to understand usage patterns. Weekly report emails help you track active user counts and assistant usage.

Analysis Report

Log analysis uses Amazon CloudWatch Logs Insights to aggregate the following metrics and send them via email.

MetricDescription
Daily Active UsersNumber of unique users per day
Chat Count by UserNumber of saved chats per user
Assistant Usage BreakdownUsage count by assistant ID and model

Notification Schedule

Reports are automatically generated every Monday at 00:00 (JST) and sent to subscribers (email addresses) of the configured SNS topic.

How It Works

  1. Application logs are output to CloudWatch Logs.
  2. EventBridge Scheduler periodically triggers a Lambda function.
  3. The Lambda function runs queries via CloudWatch Logs Insights.
  4. Aggregated results are sent via email through an SNS topic.

Application Logs

AI-Starter outputs the following logs to CloudWatch Logs.

Log TypeDescription
Chat LogsRecorded when a chat is saved. Includes chat ID, user, and assistant information
Feedback LogsRecorded on user feedback actions. Includes feedback type and comments

Note

Whether to include message content in chat logs is controlled by the customization setting (logging_messages). Message content is not recorded by default.