LustreLogCreateConfiguration - Amazon FSx

LustreLogCreateConfiguration

The Lustre logging configuration used when creating or updating an Amazon FSx for Lustre file system. Lustre logging writes the enabled logging events for your file system to Amazon CloudWatch Logs.

Error and warning events can be logged from the following data repository operations:

  • Automatic export

  • Data repository tasks

To learn more about Lustre logging, see Logging to Amazon CloudWatch Logs.

Contents

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 AWS partition, AWS Region, and AWS 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.

  • 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.

Type: String

Length Constraints: Minimum length of 8. Maximum length of 1024.

Pattern: ^arn:[^:]{1,63}:[^:]{0,63}:[^:]{0,63}:(?:|\d{12}):[^/].{0,1023}$

Required: No

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.

Type: String

Valid Values: DISABLED | WARN_ONLY | ERROR_ONLY | WARN_ERROR

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: