Amazon for Fluent Bit image repositories for Amazon ECS - Amazon Elastic Container Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 and Amazon Kinesis Firehose 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 on the Amazon ECR Public Gallery.

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