From e25b91057d98a3cd7630fc3560100312330bbac5 Mon Sep 17 00:00:00 2001 From: Austin Vazquez Date: Wed, 18 Sep 2024 15:41:15 +0000 Subject: [PATCH] Add AWS logs driver awslogs-create-stream option doc Signed-off-by: Austin Vazquez --- .../manuals/engine/logging/drivers/awslogs.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/content/manuals/engine/logging/drivers/awslogs.md b/content/manuals/engine/logging/drivers/awslogs.md index 42cdb8f55e9..d5482b308fa 100644 --- a/content/manuals/engine/logging/drivers/awslogs.md +++ b/content/manuals/engine/logging/drivers/awslogs.md @@ -127,6 +127,30 @@ $ docker run \ > Your AWS IAM policy must include the `logs:CreateLogGroup` permission before > you attempt to use `awslogs-create-group`. +### awslogs-create-stream + +By default, the log driver will attempt to create the AWS CloudWatch Logs stream to be used +for container log persistence. + +To disable AWS CloudWatch Logs stream creation, set `awslogs-create-stream` to `false`. + +The `awslogs-create-stream` option defaults to `true`. + +```console +$ docker run \ + --log-driver=awslogs \ + --log-opt awslogs-region=us-east-1 \ + --log-opt awslogs-group=myLogGroup \ + --log-opt awslogs-stream=myLogStream \ + --log-opt awslogs-create-stream=false \ + ... +``` + +> [!NOTE] +> +> By disabling log stream creation, the Docker daemon assumes the log stream configured via +> `awslogs-stream` option or a log stream of the container ID (default) already exists. + ### awslogs-datetime-format The `awslogs-datetime-format` option defines a multi-line start pattern in [Python