Package com.pulumi.aws.cloudwatch

Class LogSubscriptionFilterArgs

  • public final class LogSubscriptionFilterArgs
extends com.pulumi.resources.ResourceArgs

    • Method Detail

      • applyOnTransformedLogs

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> applyOnTransformedLogs()
        Returns:
        Boolean to indicate whether to apply the subscription filter on the transformed version of the log events instead of the original ingested log events. Defaults to `false`. Valid only for log groups that have an active log transformer.

      • destinationArn

        public com.pulumi.core.Output<java.lang.String> destinationArn()
        Returns:
        ARN of the destination to deliver matching log events to. Kinesis stream or Lambda function ARN.

      • distribution

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> distribution()
        Returns:
        Method used to distribute log data to the destination. By default log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream. Valid values are "Random" and "ByLogStream".

      • emitSystemFields

        public java.util.Optional<com.pulumi.core.Output<java.util.List<java.lang.String>>> emitSystemFields()
        Returns:
        List of system fields to include in the log events sent to the subscription destination. These fields provide source information for centralized log data in the forwarded payload. Valid values: `"@aws.account"`, `"@aws.region"`, `"@source.log"`. To remove this argument after it has been set, specify an empty list `[]` explicitly to avoid perpetual differences.

      • filterPattern

        public com.pulumi.core.Output<java.lang.String> filterPattern()
        Returns:
        Valid CloudWatch Logs filter pattern for subscribing to a filtered stream of log events. Use empty string `""` to match everything. For more information, see the [Amazon CloudWatch Logs User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

      • logGroup

        public com.pulumi.core.Output<java.lang.String> logGroup()
        Returns:
        Name of the log group to associate the subscription filter with.

      • name

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> name()
        Returns:
        Name for the subscription filter.

      • region

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> region()
        Returns:
        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

      • roleArn

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> roleArn()
        Returns:
        ARN of an IAM role that grants CloudWatch Logs permissions to deliver ingested log events to the destination stream. You don't need to provide the ARN when you are working with a logical destination for cross-account delivery. If you use Lambda as a destination, you should skip this argument and use `aws.lambda.Permission` resource for granting access from CloudWatch logs to the destination Lambda function.