Skip to content

/AWS1/CL_FSXLUSTRELOGCRECONF

The Lustre logging configuration used when creating or updating an Amazon FSx for Lustre file system. An Amazon File Cache is created with Lustre logging enabled by default, with a setting of WARN_ERROR for the logging events. which can't be changed.

Lustre logging writes the enabled logging events for your file system or cache to Amazon CloudWatch Logs.

CONSTRUCTOR

IMPORTING

Required arguments:

iv_level TYPE /AWS1/FSXLUSTREACCAUDLOGLEVEL /AWS1/FSXLUSTREACCAUDLOGLEVEL

Sets which data repository events are logged by Amazon FSx.

  • WARN_ONLY - only warning events are logged.

  • ERROR_ONLY - only error events are logged.

  • WARN_ERROR - both warning events and error events are logged.

  • DISABLED - logging of data repository events is turned off.

Optional arguments:

iv_destination TYPE /AWS1/FSXGENERALARN /AWS1/FSXGENERALARN

The Amazon Resource Name (ARN) that specifies the destination of the logs.

The destination can be any Amazon CloudWatch Logs log group ARN, with the following requirements:

  • The destination ARN that you provide must be in the same Amazon Web Services partition, Amazon Web Services Region, and Amazon Web Services account as your Amazon FSx file system.

  • The name of the Amazon CloudWatch Logs log group must begin with the /aws/fsx prefix.

  • If you do not provide a destination, Amazon FSx will create and use a log stream in the CloudWatch Logs /aws/fsx/lustre log group (for Amazon FSx for Lustre) or /aws/fsx/filecache (for Amazon File Cache).

  • If Destination is provided and the resource does not exist, the request will fail with a BadRequest error.

  • If Level is set to DISABLED, you cannot specify a destination in Destination.

Queryable Attributes

Level

Sets which data repository events are logged by Amazon FSx.

  • WARN_ONLY - only warning events are logged.

  • ERROR_ONLY - only error events are logged.

  • WARN_ERROR - both warning events and error events are logged.

  • DISABLED - logging of data repository events is turned off.

Accessible with the following methods

Method Description
GET_LEVEL() Getter for LEVEL, with configurable default
ASK_LEVEL() Getter for LEVEL w/ exceptions if field has no value
HAS_LEVEL() Determine if LEVEL has a value

Destination

The Amazon Resource Name (ARN) that specifies the destination of the logs.

The destination can be any Amazon CloudWatch Logs log group ARN, with the following requirements:

  • The destination ARN that you provide must be in the same Amazon Web Services partition, Amazon Web Services Region, and Amazon Web Services account as your Amazon FSx file system.

  • The name of the Amazon CloudWatch Logs log group must begin with the /aws/fsx prefix.

  • If you do not provide a destination, Amazon FSx will create and use a log stream in the CloudWatch Logs /aws/fsx/lustre log group (for Amazon FSx for Lustre) or /aws/fsx/filecache (for Amazon File Cache).

  • If Destination is provided and the resource does not exist, the request will fail with a BadRequest error.

  • If Level is set to DISABLED, you cannot specify a destination in Destination.

Accessible with the following methods

Method Description
GET_DESTINATION() Getter for DESTINATION, with configurable default
ASK_DESTINATION() Getter for DESTINATION w/ exceptions if field has no value
HAS_DESTINATION() Determine if DESTINATION has a value