Concatenación de mensajes de registro de Amazon ECS de seguimiento de pila o de varias líneas

Utilización del editor de política de JSON para la creación de una política

1. Inicie sesión en la AWS Management Console y abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación de la izquierda, elija Políticas.

   Si es la primera vez que elige Políticas, aparecerá la página Welcome to Managed Policies (Bienvenido a políticas administradas). Elija Comenzar.

3. En la parte superior de la página, seleccione Crear política.

4. En la sección Editor de políticas, seleccione la opción JSON.

5. Ingrese el siguiente documento de política JSON:

   {
   	"Version": "2012-10-17",
   	"Statement": [{
   		"Effect": "Allow",
   		"Action": [
   			"logs:CreateLogStream",
   			"logs:CreateLogGroup",
   			"logs:PutLogEvents"
   		],
   		"Resource": "*"
   	}]
   }

6. Elija Siguiente.

   nota

   Puede alternar entre las opciones Visual y JSON del editor en todo momento. No obstante, si realiza cambios o selecciona Siguiente en la opción Visual del editor, es posible que IAM reestructure la política, con el fin de optimizarla para el editor visual. Para obtener más información, consulte Reestructuración de política en la Guía del usuario de IAM.

7. En la página Revisar y crear, introduzca el Nombre de la política y la Descripción (opcional) para la política que está creando. Revise los Permisos definidos en esta política para ver los permisos que concede la política.

8. Elija Crear política para guardar la nueva política.

Crear y cargar la imagen en un contenedor de Fluent Bit

En esta imagen, se incluirá el archivo analizador en el que se especifica la expresión regular y un archivo de configuración que hace referencia al archivo analizador.

1. Cree una carpeta con el nombre FluentBitDockerImage.

2. Dentro de la carpeta, cree un archivo analizador que contenga las reglas para analizar el registro y concatenar líneas que pertenecen al mismo mensaje.

   1. Pegue los siguientes contenidos en el archivo analizador:

      [MULTILINE_PARSER]
          name          multiline-regex-test
          type          regex
          flush_timeout 1000
          #
          # Regex rules for multiline parsing
          # ---------------------------------
          #
          # configuration hints:
          #
          #  - first state always has the name: start_state
          #  - every field in the rule must be inside double quotes
          #
          # rules |   state name  | regex pattern                  | next state
          # ------|---------------|--------------------------------------------
          rule      "start_state"   "/(Dec \d+ \d+\:\d+\:\d+)(.*)/"  "cont"
          rule      "cont"          "/^\s+at.*/"                     "cont"

      A medida que personaliza el patrón de expresiones regulares, recomendamos utilizar un editor de expresiones regulares para probar la expresión.

   2. Guarde el archivo como parsers_multiline.conf.

3. En la carpeta FluentBitDockerImage, cree un archivo de configuración personalizado que haga referencia al archivo analizador que creó en el paso anterior.

   Para obtener más información sobre el archivo de configuración personalizado, consulte Especificación de un archivo de configuración personalizado en la Guía para desarrolladores de Amazon Elastic Container Service

   1. Pegue los siguientes contenidos en el archivo:

      [SERVICE]
          flush                 1
          log_level             info
          parsers_file          /parsers_multiline.conf
          
      [FILTER]
          name                  multiline
          match                 *
          multiline.key_content log
          multiline.parser      multiline-regex-test

      nota

      Debe utilizar la ruta absoluta del analizador.

   2. Guarde el archivo como extra.conf.

4. En la carpeta FluentBitDockerImage, cree el archivo de Dockerfile con la imagen de Fluent Bit, el analizador y los archivos de configuración que ha creado.

   1. Pegue los siguientes contenidos en el archivo:

      FROM public.ecr.aws/aws-observability/aws-for-fluent-bit:latest
      
      ADD parsers_multiline.conf /parsers_multiline.conf
      ADD extra.conf /extra.conf

   2. Guarde el archivo como Dockerfile.

5. Con el archivo de Dockerfile, cree una imagen de Fluent Bit personalizada con el analizador y los archivos de configuración personalizados incluidos.

   nota

   Puede colocar el archivo analizador y el archivo de configuración en cualquier parte de la imagen de Docker, excepto en /fluent-bit/etc/fluent-bit.conf, ya que FireLens utiliza esta ruta de archivo.

   1. Cree la imagen: docker build -t fluent-bit-multiline-image .

      Donde: fluent-bit-multiline-image es el nombre de la imagen de este ejemplo.

   2. Compruebe que la imagen se haya creado correctamente: docker images —filter reference=fluent-bit-multiline-image

      Si la acción se realiza correctamente, el resultado muestra la imagen y la etiqueta latest.

6. Cargue la imagen de Fluent Bit personalizada en Amazon Elastic Container Registry.

   1. Cree un repositorio de Amazon ECR para almacenar la imagen: aws ecr create-repository --repository-name fluent-bit-multiline-repo --region us-east-1

      Donde: fluent-bit-multiline-repo es el nombre del repositorio y us-east-1 es la región de este ejemplo.

      El resultado proporciona los detalles del nuevo repositorio.

   2. Etiquete la imagen con el valor repositoryUri del resultado anterior: docker tag fluent-bit-multiline-image repositoryUri

      Ejemplo: docker tag fluent-bit-multiline-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

   3. Ejecute la imagen de Docker para verificar que se haya ejecutado correctamente: docker images —filter reference=repositoryUri

      En el resultado, el nombre del repositorio cambia de fluent-bit-multiline-repo a repositoryUri.

   4. Autentíquese en Amazon ECR ejecutando el comando aws ecr get-login-password y especifique el ID del registro en el que desea efectuar la autenticación: aws ecr get-login-password | docker login --username AWS --password-stdin registry ID.dkr.ecr.region.amazonaws.com

      Ejemplo: ecr get-login-password | docker login --username AWS --password-stdin xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com

      Aparece un mensaje de inicio de sesión correcto.

   5. Envíe la imagen a Amazon ECR: docker push registry ID.dkr.ecr.region.amazonaws.com/repository name

      Ejemplo: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

Crear y cargar la imagen para una aplicación multilínea de demostración

En esta imagen, se incluirá un archivo de script de Python que ejecuta la aplicación y un archivo de registro de ejemplo.

Cuando ejecuta la tarea, la aplicación simula las ejecuciones y, a continuación, falla y crea un seguimiento de pila.

1. Cree una carpeta denominada multiline-app: mkdir multiline-app

2. Cree un archivo de script de Python.

   1. En la carpeta multiline-app, cree un archivo y asígnele el nombre main.py.

   2. Pegue los siguientes contenidos en el archivo:

      import os
      import time
      file1 = open('/test.log', 'r')
      Lines = file1.readlines()
       
      count = 0
      
      for i in range(10):
          print("app running normally...")
          time.sleep(1)
      
      # Strips the newline character
      for line in Lines:
          count += 1
          print(line.rstrip())
      print(count)
      print("app terminated.")
                                      

   3. Guarde el archivo main.py.

3. Cree un archivo de registro de ejemplo.

   1. En la carpeta multiline-app, cree un archivo y asígnele el nombre test.log.

   2. Pegue los siguientes contenidos en el archivo:

      single line...
      Dec 14 06:41:08 Exception in thread "main" java.lang.RuntimeException: Something has gone wrong, aborting!
          at com.myproject.module.MyProject.badMethod(MyProject.java:22)
          at com.myproject.module.MyProject.oneMoreMethod(MyProject.java:18)
          at com.myproject.module.MyProject.anotherMethod(MyProject.java:14)
          at com.myproject.module.MyProject.someMethod(MyProject.java:10)
          at com.myproject.module.MyProject.main(MyProject.java:6)
      another line...
      

   3. Guarde el archivo test.log.

4. En la carpeta multiline-app, cree el archivo de Dockerfile.

   1. Pegue los siguientes contenidos en el archivo:

      FROM public.ecr.aws/amazonlinux/amazonlinux:latest
      ADD test.log /test.log
      
      RUN yum upgrade -y && yum install -y python3
      
      WORKDIR /usr/local/bin
      
      COPY main.py .
      
      CMD ["python3", "main.py"]

   2. Guarde el archivo Dockerfile.

5. Con el archivo de Dockerfile, cree una imagen.

   1. Cree la imagen: docker build -t multiline-app-image .

      Donde: multiline-app-image es el nombre de la imagen de este ejemplo.

   2. Compruebe que la imagen se haya creado correctamente: docker images —filter reference=multiline-app-image

      Si la acción se realiza correctamente, el resultado muestra la imagen y la etiqueta latest.

6. Cargue la imagen en Amazon Elastic Container Registry.

   1. Cree un repositorio de Amazon ECR para almacenar la imagen: aws ecr create-repository --repository-name multiline-app-repo --region us-east-1

      Donde: multiline-app-repo es el nombre del repositorio y us-east-1 es la región de este ejemplo.

      El resultado proporciona los detalles del nuevo repositorio. Tome nota del valor repositoryUri, ya que lo necesitará en los siguientes pasos.

   2. Etiquete la imagen con el valor repositoryUri del resultado anterior: docker tag multiline-app-image repositoryUri

      Ejemplo: docker tag multiline-app-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

   3. Ejecute la imagen de Docker para verificar que se haya ejecutado correctamente: docker images —filter reference=repositoryUri

      En el resultado, el nombre del repositorio cambia de multiline-app-repo al valor repositoryUri.

   4. Envíe la imagen a Amazon ECR: docker push aws_account_id.dkr.ecr.region.amazonaws.com/repository name

      Ejemplo: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

Crear la definición de tarea y ejecutar la tarea

1. Cree un archivo de definición de tarea con el nombre de archivo multiline-task-definition.json.

2. Pegue los siguientes contenidos en el archivo multiline-task-definition.json:

   {
       "family": "firelens-example-multiline",
       "taskRoleArn": "task role ARN,
       "executionRoleArn": "execution role ARN",
       "containerDefinitions": [
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-image:latest",
               "name": "log_router",
               "firelensConfiguration": {
                   "type": "fluentbit",
                   "options": {
                       "config-file-type": "file",
                       "config-file-value": "/extra.conf"
                   }
               },
               "memoryReservation": 50
           },
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/multiline-app-image:latest",
               "name": "app",
               "logConfiguration": {
                   "logDriver": "awsfirelens",
                   "options": {
                       "Name": "cloudwatch_logs",
                       "region": "us-east-1",
                       "log_group_name": "multiline-test/application",
                       "auto_create_group": "true",
                       "log_stream_prefix": "multiline-"
                   }
               },
               "memoryReservation": 100
           }
       ],
       "requiresCompatibilities": ["FARGATE"],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512"
   }

   Sustituya lo siguiente en la definición de tarea multiline-task-definition.json:

   1. task role ARN

      Para encontrar el ARN del rol de tarea, vaya a la consola de IAM. Elija Roles y busque el rol de tarea ecs-task-role-for-firelens que ha creado. Elija el rol y copie el ARN que aparece en la sección Summary (Resumen).

   2. execution role ARN

      Para encontrar el ARN del rol de ejecución, vaya a la consola de IAM. Elija Roles y busque el rol ecsTaskExecutionRole. Elija el rol y copie el ARN que aparece en la sección Summary (Resumen).

   3. aws_account_id

      Para encontrar su aws_account_id, inicie sesión en la AWS Management Console. Elija su nombre de usuario en la parte superior derecha y copie su ID de cuenta.

   4. us-east-1

      Sustituya la región si es necesario.

3. Registre el archivo de definición de tarea: aws ecs register-task-definition --cli-input-json file://multiline-task-definition.json --region region

4. Abra la consola en https://console.aws.amazon.com/ecs/v2.

5. En el panel de navegación, elija Task Definitions (Definiciones de tarea) y, a continuación, seleccione la familia firelens-example-multiline porque hemos registrado la definición de tarea en esta familia en la primera línea de la definición de tarea anterior.

6. Elija la versión más reciente.

7. Elija Implementar y Ejecutar tarea.

8. En la página Ejecutar tarea, en Clúster, elija el clúster y, a continuación, en Redes, para Subredes, elija las subredes disponibles para la tarea.

9. Seleccione Crear.

Verificar que los mensajes de registro multilínea en Amazon CloudWatch aparezcan concatenados

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación, amplíe Logs (Registros) y elija Log groups (Grupos de registros).

3. Elija el grupo de registros multiline-test/applicatio.

4. Elija el registro. Vea los mensajes. Las líneas que coinciden con las reglas del archivo analizador se concatenan y aparecen como un solo mensaje.

   En el siguiente fragmento de registro, se muestran las líneas concatenadas en un único evento de seguimiento de pila Java:

   {
       "container_id": "xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "log": "Dec 14 06:41:08 Exception in thread \"main\" java.lang.RuntimeException: Something has gone wrong, aborting!\n    at com.myproject.module.MyProject.badMethod(MyProject.java:22)\n    at com.myproject.module.MyProject.oneMoreMethod(MyProject.java:18)\n    at com.myproject.module.MyProject.anotherMethod(MyProject.java:14)\n    at com.myproject.module.MyProject.someMethod(MyProject.java:10)\n    at com.myproject.module.MyProject.main(MyProject.java:6)",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:2"
   }

   El siguiente fragmento de registro muestra cómo aparece el mismo mensaje con una sola línea si se ejecuta un contenedor de Amazon ECS que no está configurado para concatenar mensajes de registro de varias líneas.

   {
       "log": "Dec 14 06:41:08 Exception in thread \"main\" java.lang.RuntimeException: Something has gone wrong, aborting!",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:3"
   }

Crear y cargar la imagen en un contenedor de Fluent Bit

En esta imagen, se incluirá un archivo de configuración que hace referencia al analizador de Fluent Bit.

1. Cree una carpeta con el nombre FluentBitDockerImage.

2. En la carpeta FluentBitDockerImage, cree un archivo de configuración personalizado que haga referencia al archivo analizador integrado de Fluent Bit.

   Para obtener más información sobre el archivo de configuración personalizado, consulte Especificación de un archivo de configuración personalizado en la Guía para desarrolladores de Amazon Elastic Container Service

   1. Pegue los siguientes contenidos en el archivo:

      [FILTER]
          name                  multiline
          match                 *
          multiline.key_content log
          multiline.parser      go

   2. Guarde el archivo como extra.conf.

3. En la carpeta FluentBitDockerImage, cree el archivo de Dockerfile con la imagen de Fluent Bit, el analizador y los archivos de configuración que ha creado.

   1. Pegue los siguientes contenidos en el archivo:

      FROM public.ecr.aws/aws-observability/aws-for-fluent-bit:latest
      ADD extra.conf /extra.conf

   2. Guarde el archivo como Dockerfile.

4. Con el archivo de Dockerfile, cree una imagen de Fluent Bit personalizada con el archivo de configuración personalizado incluido.

   nota

   Puede colocar el archivo de configuración en cualquier parte de la imagen de Docker, excepto en /fluent-bit/etc/fluent-bit.conf, ya que FireLens utiliza esta ruta de archivo.

   1. Cree la imagen: docker build -t fluent-bit-multiline-image .

      Donde: fluent-bit-multiline-image es el nombre de la imagen de este ejemplo.

   2. Compruebe que la imagen se haya creado correctamente: docker images —filter reference=fluent-bit-multiline-image

      Si la acción se realiza correctamente, el resultado muestra la imagen y la etiqueta latest.

5. Cargue la imagen de Fluent Bit personalizada en Amazon Elastic Container Registry.

   1. Cree un repositorio de Amazon ECR para almacenar la imagen: aws ecr create-repository --repository-name fluent-bit-multiline-repo --region us-east-1

      Donde: fluent-bit-multiline-repo es el nombre del repositorio y us-east-1 es la región de este ejemplo.

      El resultado proporciona los detalles del nuevo repositorio.

   2. Etiquete la imagen con el valor repositoryUri del resultado anterior: docker tag fluent-bit-multiline-image repositoryUri

      Ejemplo: docker tag fluent-bit-multiline-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

   3. Ejecute la imagen de Docker para verificar que se haya ejecutado correctamente: docker images —filter reference=repositoryUri

      En el resultado, el nombre del repositorio cambia de fluent-bit-multiline-repo a repositoryUri.

   4. Autentíquese en Amazon ECR ejecutando el comando aws ecr get-login-password y especifique el ID del registro en el que desea efectuar la autenticación: aws ecr get-login-password | docker login --username AWS --password-stdin registry ID.dkr.ecr.region.amazonaws.com

      Ejemplo: ecr get-login-password | docker login --username AWS --password-stdin xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com

      Aparece un mensaje de inicio de sesión correcto.

   5. Envíe la imagen a Amazon ECR: docker push registry ID.dkr.ecr.region.amazonaws.com/repository name

      Ejemplo: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-repo

Crear y cargar la imagen para una aplicación multilínea de demostración

En esta imagen, se incluirá un archivo de script de Python que ejecuta la aplicación y un archivo de registro de ejemplo.

1. Cree una carpeta denominada multiline-app: mkdir multiline-app

2. Cree un archivo de script de Python.

   1. En la carpeta multiline-app, cree un archivo y asígnele el nombre main.py.

   2. Pegue los siguientes contenidos en el archivo:

      import os
      import time
      file1 = open('/test.log', 'r')
      Lines = file1.readlines()
       
      count = 0
      
      for i in range(10):
          print("app running normally...")
          time.sleep(1)
      
      # Strips the newline character
      for line in Lines:
          count += 1
          print(line.rstrip())
      print(count)
      print("app terminated.")
                                      

   3. Guarde el archivo main.py.

3. Cree un archivo de registro de ejemplo.

   1. En la carpeta multiline-app, cree un archivo y asígnele el nombre test.log.

   2. Pegue los siguientes contenidos en el archivo:

      panic: my panic
      
      goroutine 4 [running]:
      panic(0x45cb40, 0x47ad70)
        /usr/local/go/src/runtime/panic.go:542 +0x46c fp=0xc42003f7b8 sp=0xc42003f710 pc=0x422f7c
      main.main.func1(0xc420024120)
        foo.go:6 +0x39 fp=0xc42003f7d8 sp=0xc42003f7b8 pc=0x451339
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003f7e0 sp=0xc42003f7d8 pc=0x44b4d1
      created by main.main
        foo.go:5 +0x58
      
      goroutine 1 [chan receive]:
      runtime.gopark(0x4739b8, 0xc420024178, 0x46fcd7, 0xc, 0xc420028e17, 0x3)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc420053e30 sp=0xc420053e00 pc=0x42503c
      runtime.goparkunlock(0xc420024178, 0x46fcd7, 0xc, 0x1000f010040c217, 0x3)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc420053e70 sp=0xc420053e30 pc=0x42512e
      runtime.chanrecv(0xc420024120, 0x0, 0xc420053f01, 0x4512d8)
        /usr/local/go/src/runtime/chan.go:506 +0x304 fp=0xc420053f20 sp=0xc420053e70 pc=0x4046b4
      runtime.chanrecv1(0xc420024120, 0x0)
        /usr/local/go/src/runtime/chan.go:388 +0x2b fp=0xc420053f50 sp=0xc420053f20 pc=0x40439b
      main.main()
        foo.go:9 +0x6f fp=0xc420053f80 sp=0xc420053f50 pc=0x4512ef
      runtime.main()
        /usr/local/go/src/runtime/proc.go:185 +0x20d fp=0xc420053fe0 sp=0xc420053f80 pc=0x424bad
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc420053fe8 sp=0xc420053fe0 pc=0x44b4d1
      
      goroutine 2 [force gc (idle)]:
      runtime.gopark(0x4739b8, 0x4ad720, 0x47001e, 0xf, 0x14, 0x1)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003e768 sp=0xc42003e738 pc=0x42503c
      runtime.goparkunlock(0x4ad720, 0x47001e, 0xf, 0xc420000114, 0x1)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003e7a8 sp=0xc42003e768 pc=0x42512e
      runtime.forcegchelper()
        /usr/local/go/src/runtime/proc.go:238 +0xcc fp=0xc42003e7e0 sp=0xc42003e7a8 pc=0x424e5c
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003e7e8 sp=0xc42003e7e0 pc=0x44b4d1
      created by runtime.init.4
        /usr/local/go/src/runtime/proc.go:227 +0x35
      
      goroutine 3 [GC sweep wait]:
      runtime.gopark(0x4739b8, 0x4ad7e0, 0x46fdd2, 0xd, 0x419914, 0x1)
        /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003ef60 sp=0xc42003ef30 pc=0x42503c
      runtime.goparkunlock(0x4ad7e0, 0x46fdd2, 0xd, 0x14, 0x1)
        /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003efa0 sp=0xc42003ef60 pc=0x42512e
      runtime.bgsweep(0xc42001e150)
        /usr/local/go/src/runtime/mgcsweep.go:52 +0xa3 fp=0xc42003efd8 sp=0xc42003efa0 pc=0x419973
      runtime.goexit()
        /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003efe0 sp=0xc42003efd8 pc=0x44b4d1
      created by runtime.gcenable
        /usr/local/go/src/runtime/mgc.go:216 +0x58
      one more line, no multiline

   3. Guarde el archivo test.log.

4. En la carpeta multiline-app, cree el archivo de Dockerfile.

   1. Pegue los siguientes contenidos en el archivo:

      FROM public.ecr.aws/amazonlinux/amazonlinux:latest
      ADD test.log /test.log
      
      RUN yum upgrade -y && yum install -y python3
      
      WORKDIR /usr/local/bin
      
      COPY main.py .
      
      CMD ["python3", "main.py"]

   2. Guarde el archivo Dockerfile.

5. Con el archivo de Dockerfile, cree una imagen.

   1. Cree la imagen: docker build -t multiline-app-image .

      Donde: multiline-app-image es el nombre de la imagen de este ejemplo.

   2. Compruebe que la imagen se haya creado correctamente: docker images —filter reference=multiline-app-image

      Si la acción se realiza correctamente, el resultado muestra la imagen y la etiqueta latest.

6. Cargue la imagen en Amazon Elastic Container Registry.

   1. Cree un repositorio de Amazon ECR para almacenar la imagen: aws ecr create-repository --repository-name multiline-app-repo --region us-east-1

      Donde: multiline-app-repo es el nombre del repositorio y us-east-1 es la región de este ejemplo.

      El resultado proporciona los detalles del nuevo repositorio. Tome nota del valor repositoryUri, ya que lo necesitará en los siguientes pasos.

   2. Etiquete la imagen con el valor repositoryUri del resultado anterior: docker tag multiline-app-image repositoryUri

      Ejemplo: docker tag multiline-app-image xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

   3. Ejecute la imagen de Docker para verificar que se haya ejecutado correctamente: docker images —filter reference=repositoryUri

      En el resultado, el nombre del repositorio cambia de multiline-app-repo al valor repositoryUri.

   4. Envíe la imagen a Amazon ECR: docker push aws_account_id.dkr.ecr.region.amazonaws.com/repository name

      Ejemplo: docker push xxxxxxxxxxxx.dkr.ecr.us-east-1.amazonaws.com/multiline-app-repo

Crear la definición de tarea y ejecutar la tarea

1. Cree un archivo de definición de tarea con el nombre de archivo multiline-task-definition.json.

2. Pegue los siguientes contenidos en el archivo multiline-task-definition.json:

   {
       "family": "firelens-example-multiline",
       "taskRoleArn": "task role ARN,
       "executionRoleArn": "execution role ARN",
       "containerDefinitions": [
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/fluent-bit-multiline-image:latest",
               "name": "log_router",
               "firelensConfiguration": {
                   "type": "fluentbit",
                   "options": {
                       "config-file-type": "file",
                       "config-file-value": "/extra.conf"
                   }
               },
               "memoryReservation": 50
           },
           {
               "essential": true,
               "image": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/multiline-app-image:latest",
               "name": "app",
               "logConfiguration": {
                   "logDriver": "awsfirelens",
                   "options": {
                       "Name": "cloudwatch_logs",
                       "region": "us-east-1",
                       "log_group_name": "multiline-test/application",
                       "auto_create_group": "true",
                       "log_stream_prefix": "multiline-"
                   }
               },
               "memoryReservation": 100
           }
       ],
       "requiresCompatibilities": ["FARGATE"],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512"
   }

   Sustituya lo siguiente en la definición de tarea multiline-task-definition.json:

   1. task role ARN

      Para encontrar el ARN del rol de tarea, vaya a la consola de IAM. Elija Roles y busque el rol de tarea ecs-task-role-for-firelens que ha creado. Elija el rol y copie el ARN que aparece en la sección Summary (Resumen).

   2. execution role ARN

      Para encontrar el ARN del rol de ejecución, vaya a la consola de IAM. Elija Roles y busque el rol ecsTaskExecutionRole. Elija el rol y copie el ARN que aparece en la sección Summary (Resumen).

   3. aws_account_id

      Para encontrar su aws_account_id, inicie sesión en la AWS Management Console. Elija su nombre de usuario en la parte superior derecha y copie su ID de cuenta.

   4. us-east-1

      Sustituya la región si es necesario.

3. Registre el archivo de definición de tarea: aws ecs register-task-definition --cli-input-json file://multiline-task-definition.json --region us-east-1

4. Abra la consola en https://console.aws.amazon.com/ecs/v2.

5. En el panel de navegación, elija Task Definitions (Definiciones de tarea) y, a continuación, seleccione la familia firelens-example-multiline porque hemos registrado la definición de tarea en esta familia en la primera línea de la definición de tarea anterior.

6. Elija la versión más reciente.

7. Elija Implementar y Ejecutar tarea.

8. En la página Ejecutar tarea, en Clúster, elija el clúster y, a continuación, en Redes, para Subredes, elija las subredes disponibles para la tarea.

9. Seleccione Crear.

Verificar que los mensajes de registro multilínea en Amazon CloudWatch aparezcan concatenados

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación, amplíe Logs (Registros) y elija Log groups (Grupos de registros).

3. Elija el grupo de registros multiline-test/applicatio.

4. Elija el registro y vea los mensajes. Las líneas que coinciden con las reglas del archivo analizador se concatenan y aparecen como un solo mensaje.

   En el siguiente fragmento de registro, se muestra un seguimiento de pila Go que está concatenado en un único evento:

   {
       "log": "panic: my panic\n\ngoroutine 4 [running]:\npanic(0x45cb40, 0x47ad70)\n  /usr/local/go/src/runtime/panic.go:542 +0x46c fp=0xc42003f7b8 sp=0xc42003f710 pc=0x422f7c\nmain.main.func1(0xc420024120)\n  foo.go:6 +0x39 fp=0xc42003f7d8 sp=0xc42003f7b8 pc=0x451339\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003f7e0 sp=0xc42003f7d8 pc=0x44b4d1\ncreated by main.main\n  foo.go:5 +0x58\n\ngoroutine 1 [chan receive]:\nruntime.gopark(0x4739b8, 0xc420024178, 0x46fcd7, 0xc, 0xc420028e17, 0x3)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc420053e30 sp=0xc420053e00 pc=0x42503c\nruntime.goparkunlock(0xc420024178, 0x46fcd7, 0xc, 0x1000f010040c217, 0x3)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc420053e70 sp=0xc420053e30 pc=0x42512e\nruntime.chanrecv(0xc420024120, 0x0, 0xc420053f01, 0x4512d8)\n  /usr/local/go/src/runtime/chan.go:506 +0x304 fp=0xc420053f20 sp=0xc420053e70 pc=0x4046b4\nruntime.chanrecv1(0xc420024120, 0x0)\n  /usr/local/go/src/runtime/chan.go:388 +0x2b fp=0xc420053f50 sp=0xc420053f20 pc=0x40439b\nmain.main()\n  foo.go:9 +0x6f fp=0xc420053f80 sp=0xc420053f50 pc=0x4512ef\nruntime.main()\n  /usr/local/go/src/runtime/proc.go:185 +0x20d fp=0xc420053fe0 sp=0xc420053f80 pc=0x424bad\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc420053fe8 sp=0xc420053fe0 pc=0x44b4d1\n\ngoroutine 2 [force gc (idle)]:\nruntime.gopark(0x4739b8, 0x4ad720, 0x47001e, 0xf, 0x14, 0x1)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003e768 sp=0xc42003e738 pc=0x42503c\nruntime.goparkunlock(0x4ad720, 0x47001e, 0xf, 0xc420000114, 0x1)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003e7a8 sp=0xc42003e768 pc=0x42512e\nruntime.forcegchelper()\n  /usr/local/go/src/runtime/proc.go:238 +0xcc fp=0xc42003e7e0 sp=0xc42003e7a8 pc=0x424e5c\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003e7e8 sp=0xc42003e7e0 pc=0x44b4d1\ncreated by runtime.init.4\n  /usr/local/go/src/runtime/proc.go:227 +0x35\n\ngoroutine 3 [GC sweep wait]:\nruntime.gopark(0x4739b8, 0x4ad7e0, 0x46fdd2, 0xd, 0x419914, 0x1)\n  /usr/local/go/src/runtime/proc.go:280 +0x12c fp=0xc42003ef60 sp=0xc42003ef30 pc=0x42503c\nruntime.goparkunlock(0x4ad7e0, 0x46fdd2, 0xd, 0x14, 0x1)\n  /usr/local/go/src/runtime/proc.go:286 +0x5e fp=0xc42003efa0 sp=0xc42003ef60 pc=0x42512e\nruntime.bgsweep(0xc42001e150)\n  /usr/local/go/src/runtime/mgcsweep.go:52 +0xa3 fp=0xc42003efd8 sp=0xc42003efa0 pc=0x419973\nruntime.goexit()\n  /usr/local/go/src/runtime/asm_amd64.s:2337 +0x1 fp=0xc42003efe0 sp=0xc42003efd8 pc=0x44b4d1\ncreated by runtime.gcenable\n  /usr/local/go/src/runtime/mgc.go:216 +0x58",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:2"
   }

   En el siguiente fragmento de registro, se muestra cómo aparece el mismo evento si ejecuta un contenedor ECS que no está configurado para concatenar mensajes de registro multilínea. El campo de registro contiene una sola línea.

   {
       "log": "panic: my panic",
       "container_id": "xxxxxx-xxxxxx",
       "container_name": "app",
       "source": "stdout",
       "ecs_cluster": "default",
       "ecs_task_arn": "arn:aws:ecs:us-east-1:xxxxxxxxxxxx:task/default/xxxxxx",
       "ecs_task_definition": "firelens-example-multiline:3"