Package org.forgerock.opendj.server.config.client

Interface FileBasedAccessLogPublisherCfgClient

    • Method Detail

      • isAppend

        ValueOrExpression<Boolean> isAppend()
        Gets the "append" property.

        Specifies whether to append to existing log files.

        Default value: true

        Returns:
        Returns the value of the "append" property.

      • isAsynchronous

        @MandatoryProperty
ValueOrExpression<Boolean> isAsynchronous()
        Gets the "asynchronous" property.

        Indicates whether the File Based Access Log Publisher will publish records asynchronously.

        Default value: true

        Returns:
        Returns the value of the "asynchronous" property.

      • isAutoFlush

        ValueOrExpression<Boolean> isAutoFlush()
        Gets the "auto-flush" property.

        Specifies whether to flush the writer after every log record.

        If the asynchronous writes option is used, the writer is flushed after all the log records in the queue are written.

        Default value: true

        Returns:
        Returns the value of the "auto-flush" property.

      • setAutoFlush

        void setAutoFlush​(ValueOrExpression<Boolean> value)
           throws PropertyException
        Sets the "auto-flush" property.

        Specifies whether to flush the writer after every log record.

        If the asynchronous writes option is used, the writer is flushed after all the log records in the queue are written.

        Parameters:
        value - The value of the "auto-flush" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getBufferSize

        ValueOrExpression<Long> getBufferSize()
        Gets the "buffer-size" property.

        Specifies the log file buffer size.

        Default value: 64kb

        Returns:
        Returns the value of the "buffer-size" property.

      • setBufferSize

        void setBufferSize​(ValueOrExpression<Long> value)
            throws PropertyException
        Sets the "buffer-size" property.

        Specifies the log file buffer size.

        Parameters:
        value - The value of the "buffer-size" property.
        Throws:
        PropertyException - If the new value is invalid.

      • isLogControls

        ValueOrExpression<Boolean> isLogControls()
        Gets the "log-controls" property.

        Specifies whether controls with criticality and values will be included in operation log records.

        Default value: true

        Returns:
        Returns the value of the "log-controls" property.

      • setLogControls

        void setLogControls​(ValueOrExpression<Boolean> value)
             throws PropertyException
        Sets the "log-controls" property.

        Specifies whether controls with criticality and values will be included in operation log records.

        Parameters:
        value - The value of the "log-controls" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getLogFile

        @MandatoryProperty
ValueOrExpression<String> getLogFile()
        Gets the "log-file" property.

        The file name to use for the log files generated by the File Based Access Log Publisher. The path to the file is relative to the server root.

        Returns:
        Returns the value of the "log-file" property.

      • setLogFile

        @MandatoryProperty
void setLogFile​(ValueOrExpression<String> value)
         throws PropertyException
        Sets the "log-file" property.

        The file name to use for the log files generated by the File Based Access Log Publisher. The path to the file is relative to the server root.

        Parameters:
        value - The value of the "log-file" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getLogFilePermissions

        @MandatoryProperty
ValueOrExpression<String> getLogFilePermissions()
        Gets the "log-file-permissions" property.

        The UNIX permissions of the log files created by this File Based Access Log Publisher.

        Default value: 640

        Returns:
        Returns the value of the "log-file-permissions" property.

      • setLogFilePermissions

        @MandatoryProperty
void setLogFilePermissions​(ValueOrExpression<String> value)
                    throws PropertyException
        Sets the "log-file-permissions" property.

        The UNIX permissions of the log files created by this File Based Access Log Publisher.

        Parameters:
        value - The value of the "log-file-permissions" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getLogRecordTimeFormat

        ValueOrExpression<String> getLogRecordTimeFormat()
        Gets the "log-record-time-format" property.

        Specifies the format string that is used to generate log record timestamps.

        Default value: dd/MMM/yyyy:HH:mm:ss Z

        Returns:
        Returns the value of the "log-record-time-format" property.

      • setLogRecordTimeFormat

        void setLogRecordTimeFormat​(ValueOrExpression<String> value)
                     throws PropertyException
        Sets the "log-record-time-format" property.

        Specifies the format string that is used to generate log record timestamps.

        Parameters:
        value - The value of the "log-record-time-format" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getQueueSize

        ValueOrExpression<Integer> getQueueSize()
        Gets the "queue-size" property.

        The maximum number of log records that can be stored in the asynchronous queue.

        Default value: 5000

        Returns:
        Returns the value of the "queue-size" property.

      • setQueueSize

        void setQueueSize​(ValueOrExpression<Integer> value)
           throws PropertyException
        Sets the "queue-size" property.

        The maximum number of log records that can be stored in the asynchronous queue.

        Parameters:
        value - The value of the "queue-size" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getRetentionPolicy

        SortedSet<ValueOrExpression<String>> getRetentionPolicy()
        Gets the "retention-policy" property.

        The retention policy to use for the File Based Access Log Publisher .

        When multiple policies are used, log files are cleaned when any of the policy's conditions are met.

        Returns:
        Returns the values of the "retention-policy" property.

      • setRetentionPolicy

        void setRetentionPolicy​(Collection<ValueOrExpression<String>> values)
                 throws PropertyException
        Sets the "retention-policy" property.

        The retention policy to use for the File Based Access Log Publisher .

        When multiple policies are used, log files are cleaned when any of the policy's conditions are met.

        Parameters:
        values - The values of the "retention-policy" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.

      • getRotationPolicy

        SortedSet<ValueOrExpression<String>> getRotationPolicy()
        Gets the "rotation-policy" property.

        The rotation policy to use for the File Based Access Log Publisher .

        When multiple policies are used, rotation will occur if any policy's conditions are met.

        Returns:
        Returns the values of the "rotation-policy" property.

      • setRotationPolicy

        void setRotationPolicy​(Collection<ValueOrExpression<String>> values)
                throws PropertyException
        Sets the "rotation-policy" property.

        The rotation policy to use for the File Based Access Log Publisher .

        When multiple policies are used, rotation will occur if any policy's conditions are met.

        Parameters:
        values - The values of the "rotation-policy" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.

      • getTimeInterval

        ValueOrExpression<Long> getTimeInterval()
        Gets the "time-interval" property.

        Specifies the interval at which to check whether the log files need to be rotated.

        Default value: 5s

        Returns:
        Returns the value of the "time-interval" property.

      • setTimeInterval

        void setTimeInterval​(ValueOrExpression<Long> value)
              throws PropertyException
        Sets the "time-interval" property.

        Specifies the interval at which to check whether the log files need to be rotated.

        Parameters:
        value - The value of the "time-interval" property.
        Throws:
        PropertyException - If the new value is invalid.