WildFly Full 27 Model Reference

  1. home
  2. core-service=management
  3. access=audit
  4. periodic-rotating-file-handler

A management audit log handler which writes to a file, rotating the log after a time period derived from the given suffix string, which should be in a format understood by java.text.SimpleDateFormat.

Attributes (7)

  • disabled-due-to-failure Whether this handler has been disabled due to logging failures.
    • Attribute Value
    Type BOOLEAN
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • failure-count The number of logging failures since the handler was initialized.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • formatter The formatter used to format the log messages.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • max-failure-count The maximum number of logging failures before disabling this handler.
    • Attribute Value
    Default Value 10
    Type INT
    Nillable true
    Expressions Allowed true
    Min 0
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • path The path of the audit log file.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • relative-to The name of another previously named path, or of one of the standard paths provided by the system. If 'relative-to' is provided, the value of the 'path' attribute is treated as relative to the path specified by this attribute.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • suffix The suffix string in a format which can be understood by java.text.SimpleDateFormat. The period of the rotation is automatically calculated based on the suffix.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services

Operations (3)

  • add Adds an audit log periodic-rotating file handler.
    Request Parameter Type Required Expressions Allowed Default value Description
    formatter STRING true false The formatter used to format the log messages.
    max-failure-count INT false true 10 The maximum number of logging failures before disabling this handler.
    path STRING true true The path of the audit log file.
    relative-to STRING false false The name of another previously named path, or of one of the standard paths provided by the system. If 'relative-to' is provided, the value of the 'path' attribute is treated as relative to the path specified by this attribute.
    suffix STRING true true The suffix string in a format which can be understood by java.text.SimpleDateFormat. The period of the rotation is automatically calculated based on the suffix.
  • recycle Resets the file handler failure count, and backs up the current log file.
  • remove Removes an audit log periodic-rotating file handler.