処理結果の確認

LightFile Lambdaの処理結果はCloudWatch Logsで確認できます。

CloudWatchログで確認

ログの表示

CloudWatchコンソールを開く
ロググループ /aws/lambda/{prefix}-lightfile を選択
最新のログストリームを表示

ログメッセージの例

処理成功:

[info] s3://my-company-lightfile-test/photo.jpg 処理が正常に完了しました

処理済みスキップ:

[debug] s3://my-company-lightfile-test/photo.jpg すでに処理済みのためここで処理を終了します

サイズ範囲外:

[info] s3://my-company-lightfile-test/small.jpg ファイルサイズが小さすぎるため処理をスキップします

ファイルサイズの確認

最適化後のサイズ確認

# 最適化後のサイズ確認
aws s3 ls s3://my-company-lightfile-test/ --human-readable

# バックアップ（オリジナル）のサイズ確認
aws s3 ls s3://my-company-lightfile-backup/ --human-readable

サイズ削減率の計算

バックアップが有効な場合、オリジナルと最適化後のサイズを比較できます:

# オリジナルサイズ
aws s3api head-object \
  --bucket my-company-lightfile-backup \
  --key my-company-lightfile-test/photo.jpg \
  --query ContentLength

# 最適化後サイズ
aws s3api head-object \
  --bucket my-company-lightfile-test \
  --key photo.jpg \
  --query ContentLength

処理状況の確認

メタデータの確認

処理済み画像にはlightfile-status: doneメタデータが付与されます:

aws s3api head-object \
  --bucket my-company-lightfile-test \
  --key photo.jpg \
  --query Metadata

出力例:

{
  "lightfile-status": "done"
}

ベストプラクティス

ログレベルの設定

通常運用 - LOG_LEVEL=info
トラブルシューティング - LOG_LEVEL=debug
静かな運用 - LOG_LEVEL=error

CloudWatchアラームの設定

Lambda関数のエラーを監視するアラームを設定することをおすすめします:

aws cloudwatch put-metric-alarm \
  --alarm-name lightfile-lambda-errors \
  --alarm-description "LightFile Lambda function errors" \
  --metric-name Errors \
  --namespace AWS/Lambda \
  --statistic Sum \
  --period 300 \
  --threshold 1 \
  --comparison-operator GreaterThanThreshold \
  --dimensions Name=FunctionName,Value=my-company-lightfile \
  --evaluation-periods 1

バックアップの管理

バックアップが有効な場合、ライフサイクルルールで古いファイルを削除することをおすすめします:

# 30日後にバックアップを削除
aws s3api put-bucket-lifecycle-configuration \
  --bucket my-company-lightfile-backup \
  --lifecycle-configuration '{
    "Rules": [{
      "Id": "delete-old-backups",
      "Status": "Enabled",
      "Expiration": { "Days": 30 }
    }]
  }'

目次