Class CloudWatchLogsLogStream

    • Method Detail

      • logGroupName

        public final String logGroupName()

        Specifies the destination log group. A log group is created automatically if it doesn't already exist. Log group names can be between 1 and 512 characters long. Allowed characters include a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).

        Returns:
        Specifies the destination log group. A log group is created automatically if it doesn't already exist. Log group names can be between 1 and 512 characters long. Allowed characters include a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).
      • file

        public final String file()

        Specifies log files that you want to push to CloudWatch Logs.

        File can point to a specific file or multiple files (by using wild card characters such as /var/log/system.log*). Only the latest file is pushed to CloudWatch Logs, based on file modification time. We recommend that you use wild card characters to specify a series of files of the same type, such as access_log.2014-06-01-01, access_log.2014-06-01-02, and so on by using a pattern like access_log.*. Don't use a wildcard to match multiple file types, such as access_log_80 and access_log_443. To specify multiple, different file types, add another log stream entry to the configuration file, so that each log file type is stored in a different log group.

        Zipped files are not supported.

        Returns:
        Specifies log files that you want to push to CloudWatch Logs.

        File can point to a specific file or multiple files (by using wild card characters such as /var/log/system.log*). Only the latest file is pushed to CloudWatch Logs, based on file modification time. We recommend that you use wild card characters to specify a series of files of the same type, such as access_log.2014-06-01-01, access_log.2014-06-01-02, and so on by using a pattern like access_log.*. Don't use a wildcard to match multiple file types, such as access_log_80 and access_log_443. To specify multiple, different file types, add another log stream entry to the configuration file, so that each log file type is stored in a different log group.

        Zipped files are not supported.

      • fileFingerprintLines

        public final String fileFingerprintLines()

        Specifies the range of lines for identifying a file. The valid values are one number, or two dash-delimited numbers, such as '1', '2-5'. The default value is '1', meaning the first line is used to calculate the fingerprint. Fingerprint lines are not sent to CloudWatch Logs unless all specified lines are available.

        Returns:
        Specifies the range of lines for identifying a file. The valid values are one number, or two dash-delimited numbers, such as '1', '2-5'. The default value is '1', meaning the first line is used to calculate the fingerprint. Fingerprint lines are not sent to CloudWatch Logs unless all specified lines are available.
      • multiLineStartPattern

        public final String multiLineStartPattern()

        Specifies the pattern for identifying the start of a log message.

        Returns:
        Specifies the pattern for identifying the start of a log message.
      • initialPositionAsString

        public final String initialPositionAsString()

        Specifies where to start to read data (start_of_file or end_of_file). The default is start_of_file. This setting is only used if there is no state persisted for that log stream.

        If the service returns an enum value that is not available in the current SDK version, initialPosition will return CloudWatchLogsInitialPosition.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from initialPositionAsString().

        Returns:
        Specifies where to start to read data (start_of_file or end_of_file). The default is start_of_file. This setting is only used if there is no state persisted for that log stream.
        See Also:
        CloudWatchLogsInitialPosition
      • encoding

        public final CloudWatchLogsEncoding encoding()

        Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.

        If the service returns an enum value that is not available in the current SDK version, encoding will return CloudWatchLogsEncoding.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from encodingAsString().

        Returns:
        Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.
        See Also:
        CloudWatchLogsEncoding
      • encodingAsString

        public final String encodingAsString()

        Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.

        If the service returns an enum value that is not available in the current SDK version, encoding will return CloudWatchLogsEncoding.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from encodingAsString().

        Returns:
        Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.
        See Also:
        CloudWatchLogsEncoding
      • bufferDuration

        public final Integer bufferDuration()

        Specifies the time duration for the batching of log events. The minimum value is 5000ms and default value is 5000ms.

        Returns:
        Specifies the time duration for the batching of log events. The minimum value is 5000ms and default value is 5000ms.
      • batchCount

        public final Integer batchCount()

        Specifies the max number of log events in a batch, up to 10000. The default value is 1000.

        Returns:
        Specifies the max number of log events in a batch, up to 10000. The default value is 1000.
      • batchSize

        public final Integer batchSize()

        Specifies the maximum size of log events in a batch, in bytes, up to 1048576 bytes. The default value is 32768 bytes. This size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.

        Returns:
        Specifies the maximum size of log events in a batch, in bytes, up to 1048576 bytes. The default value is 32768 bytes. This size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.
      • hashCode

        public final int hashCode()
        Overrides:
        hashCode in class Object
      • equals

        public final boolean equals​(Object obj)
        Overrides:
        equals in class Object
      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object
      • getValueForField

        public final <T> Optional<T> getValueForField​(String fieldName,
                                                      Class<T> clazz)