Amazon for Fluent Bit image repositories for Amazon ECS
Amazon provides a Fluent Bit image with plugins for both CloudWatch Logs and
Firehose. We recommend using Fluent Bit as your log router because it has a
lower resource utilization rate than Fluentd. For more information, see
CloudWatch Logs for
Fluent Bit
The Amazon for Fluent Bit image is available on Amazon ECR on both the Amazon ECR Public Gallery and in an Amazon ECR repository in most Amazon Web Services Regions for high availability.
Amazon ECR Public Gallery
The Amazon for Fluent Bit image is available on the Amazon ECR Public
Gallery. This is the recommended location to download the Amazon for Fluent
Bit image because it's a public repository and available to be used from
all Amazon Web Services Regions. For more information, see aws-for-fluent-bit
Linux
The Amazon for Fluent Bit image in the Amazon ECR Public Gallery
supports Amazon Linux operating system with the ARM 64
, or
x86-64
architecture.
You can pull the Amazon for Fluent Bit image from the Amazon ECR Public Gallery by specifying the repository URL with the desired image tag. The available image tags can be found on the Image tags tab on the Amazon ECR Public Gallery.
The following shows the syntax to use for the Docker CLI.
docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:
tag
For example, you can pull the latest stable Amazon for Fluent Bit image using this Docker CLI command.
docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:stable
Note
Unauthenticated pulls are allowed, but have a lower rate limit than authenticated pulls. To authenticate using your Amazon account before pulling, use the following command.
aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws
Windows
The Amazon for Fluent Bit image in the Amazon ECR Public Gallery
supports the AMD64
architecture with the following operating
systems:
-
Windows Server 2022 Full
-
Windows Server 2022 Core
-
Windows Server 2019 Full
-
Windows Server 2019 Core
Windows containers that are on Amazon Fargate don't support FireLens.
You can pull the Amazon for Fluent Bit image from the Amazon ECR Public Gallery by specifying the repository URL with the desired image tag. The available image tags can be found on the Image tags tab on the Amazon ECR Public Gallery.
The following shows the syntax to use for the Docker CLI.
docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:
tag
For example, you can pull the newest stable Amazon for Fluent Bit image using this Docker CLI command.
docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:windowsservercore-stable
Note
Unauthenticated pulls are allowed, but have a lower rate limit than authenticated pulls. To authenticate using your Amazon account before pulling, use the following command.
aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws
Amazon ECR
The Amazon for Fluent Bit image is available on Amazon ECR for high availability. These images are available in most Amazon Web Services Regions, including Amazon GovCloud (US).
Linux
The latest stable Amazon for Fluent Bit image URI can be retrieved using the following command.
aws ssm get-parameters \ --names /aws/service/aws-for-fluent-bit/stable \ --region
us-east-1
All versions of the Amazon for Fluent Bit image can be listed using the following command to query the Systems Manager Parameter Store parameter.
aws ssm get-parameters-by-path \ --path /aws/service/aws-for-fluent-bit \ --region
us-east-1
The newest stable Amazon for Fluent Bit image can be referenced in an Amazon CloudFormation template by referencing the Systems Manager parameter store name. The following is an example:
Parameters: FireLensImage: Description: Fluent Bit image for the FireLens Container Type: AWS::SSM::Parameter::Value<String> Default: /aws/service/aws-for-fluent-bit/stable
Windows
The latest stable Amazon for Fluent Bit image URI can be retrieved using the following command.
aws ssm get-parameters \ --names /aws/service/aws-for-fluent-bit/windowsservercore-stable \ --region
us-east-1
All versions of the Amazon for Fluent Bit image can be listed using the following command to query the Systems Manager Parameter Store parameter.
aws ssm get-parameters-by-path \ --path /aws/service/aws-for-fluent-bit/windowsservercore \ --region
us-east-1
The latest stable Amazon for Fluent Bit image can be referenced in an Amazon CloudFormation template by referencing the Systems Manager parameter store name. The following is an example:
Parameters: FireLensImage: Description: Fluent Bit image for the FireLens Container Type: AWS::SSM::Parameter::Value<String> Default: /aws/service/aws-for-fluent-bit/windowsservercore-stable