ログの基礎：ログレベル・ログ機能の流れ・スタックトレース

2026-06-16 12:34:56 [INFO]  User login succeeded: userId=42
2026-06-16 12:35:01 [INFO]  Database connected: host=db.example.com
2026-06-16 12:35:10 [ERROR] Payment failed: orderId=9876, reason=timeout

// ユーザー登録が成功したタイミングでログを出力するコードの例
async createUser(dto: CreateUserDto) {
  const user = await this.prisma.user.create({ data: dto });
  this.logger.info(`User created: userId=${user.id}`);  // ← ここでログ命令
  return user;
}

2026-06-16 12:34:56 [INFO] [UsersService] User created: userId=42

{"timestamp":"2026-06-16T12:34:56Z","level":"info","context":"UsersService","message":"User created: userId=42"}

// アプリコードではSLF4JのAPIだけを使う
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class UserService {
    private static final Logger log = LoggerFactory.getLogger(UserService.class);

    public void createUser(String name) {
        log.info("Creating user: name={}", name);   // SLF4JのAPIを呼ぶ
        log.error("Failed to create user", e);       // エラーとスタックトレース
    }
}

<configuration>

  <!-- コンソールへの出力 -->
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <!-- フォーマット: 日時 [レベル] クラス名 - メッセージ -->
      <pattern>%d{yyyy-MM-dd HH:mm:ss} [%level] %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <!-- ファイルへの出力（日次ローテーション付き） -->
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/var/log/app/app.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>/var/log/app/app-%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>14</maxHistory>  <!-- 14日分保持 -->
    </rollingPolicy>
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss} [%level] %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <!-- 本番環境：INFO以上をコンソールとファイルの両方へ -->
  <root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="FILE" />
  </root>

  <!-- このパッケージだけDEBUGレベルを出す設定も可能 -->
  <logger name="com.example.users" level="DEBUG" />

</configuration>

2026-06-16 12:34:56 [INFO ] c.e.users.UserService - Creating user: name=Alice
2026-06-16 12:35:10 [ERROR] c.e.users.UserService - Failed to create user
java.lang.NullPointerException: Cannot read field "id"
    at com.example.users.UserService.createUser(UserService.java:24)
    at com.example.users.UserController.createUser(UserController.java:15)

# 本番環境：INFO以上のみ出力（DEBUGは出さない）
LOG_LEVEL=info

# 開発環境：DEBUGから全部出力（詳しく追いたい）
LOG_LEVEL=debug

Error: Cannot read properties of undefined (reading 'id')
    at UsersService.getUser (users.service.ts:24:30)
    at UsersController.getUser (users.controller.ts:15:38)
    at RouterExplorer.processRoute (router-explorer.js:302:15)
    at Layer.handle (router.js:95:5)

// スタックトレースを含めてエラーログを出力する例
try {
  const user = await this.prisma.user.findUnique({ where: { id } });
  return user.id;  // user が null のとき例外が発生する
} catch (error) {
  this.logger.error('Failed to get user', error.stack);  // ← error.stack でスタックトレースを渡す
  throw error;
}

2026-06-16 12:35:10 [ERROR] Failed to get user
Error: Cannot read properties of undefined (reading 'id')
    at UsersService.getUser (users.service.ts:24:30)
    at UsersController.getUser (users.controller.ts:15:38)

// 悪い例
this.logger.info(`Login attempt: email=${dto.email}, password=${dto.password}`);

// 良い例
this.logger.info(`Login attempt: email=${dto.email}`);  // passwordはログに含めない