ロギングを有効にする

ロギングを有効にして、Amazon CloudWatch ログを使用して GraphQL API をデバッグできます。GraphQL API のログとモニタリング機能の詳細については、AWS AppSync のログとモニタリングに関するドキュメントを参照してください。

デフォルトロギング設定を有効にする

デフォルトロギングは、defineData の呼び出しで logging プロパティを true に設定することで有効にできます。例えば、以下のようにします：

export const data = defineData({
  // ...
  logging: true
});

logging: true を使用すると、以下のデフォルト設定が適用されます：

• excludeVerboseContent: true（AppSync のリクエストレベルログを参照）
• fieldLogLevel: 'none'（AppSync のフィールドレベルログを参照）
• retention: '1 week'（Enum RetentionDaysを参照）

ロギング設定をカスタマイズする

DataLogConfig オブジェクトを提供することで、個別の設定値をカスタマイズできます。例えば、以下のようにします：

export const data = defineData({
  // ...
  logging: {
    excludeVerboseContent: false,
    fieldLogLevel: 'all',
    retention: '1 month'
  }
});

設定プロパティ

logging

• true: デフォルトロギングを有効にします。
• DataLogConfig オブジェクト: 1 つ以上のデフォルトフィールドをオーバーライドします。

DataLogConfig フィールド

• excludeVerboseContent?: boolean

  • デフォルト値は true
  • false の場合、ログにリクエストレベルログが含まれる可能性があります。AppSync のリクエストレベルログを参照してください。

• fieldLogLevel?: DataLogLevel

  • デフォルト値は 'none'
  • AppSync のフィールドログレベルでサポートされている値：
    • 'none'
    • 'error'
    • 'info'
    • 'debug'
    • 'all'

• retention?: LogRetention

  • ログを保持する日数
  • デフォルト値は '1 week'
  • Enum RetentionDaysでサポートされている値：
    • '1 day'
    • '3 days'
    • '5 days'
    • '1 week'
    • '2 weeks'
    • '1 month'
    • '2 months'
    • '3 months'
    • '4 months'
    • '5 months'
    • '6 months'
    • '1 year'
    • '13 months'
    • '18 months'
    • '2 years'
    • '5 years'
    • '10 years'
    • 'infinite'